PowerShell
Im PowerShell-Workspace können Sie mit PowerShell-Vorlagen arbeiten und aus diesen Vorlagen eigene PowerShell-Microservices entwickeln. Für die Entwicklung und die Arbeit mit PowerShell stehen Ihnen in der AESB Console verschiedene Werkzeuge zur Verfügung, die in diesem Abschnitt genauer erklärt werden. Umfangreiche Beispiele dafür, wie Sie mit PowerShell-Microservices eigene Anwendungen für die Automatisierung bestimmter Tätigkeiten entwickeln können, finden Sie hingegen im Abschnitt Entwicklung von PowerShell-Microservices.
PowerShell-Vorlagen
Der Arbeitsbereich unterteilt sich in die Liste der PowerShell-Vorlagen und den Detailbereich, in dem Ihnen die Eigenschaften der ausgewählten Vorlage angezeigt werden. Bedienen lässt sich der PowerShell-Arbeitsbereich über die Buttons in der Ribbonleiste oder das Kontextmenü.
In der Liste der PowerShell-Vorlagen sehen Sie das PowerShell-Vorlagen-Repository mit allen Ordnern und PowerShell-Vorlagen, die Sie verwalten können. Diese können Sie nutzen, um eigene PowerShell-Microservices zu erstellen und diese direkt in den Microservices-Workspace zu importieren.
PowerShell-Workspace
Bei Auswahl des Vorlagen-Repositorys oder eines Ordners stehen Ihnen folgende Funktionen zur Verfügung:
| Button | Funktionen |
|---|---|
| Hinzufügen (PowerShell-Vorlage) | Erstellt eine neue PowerShell-Vorlage mit leeren Eigenschaften. |
| Importieren (PowerShell-Vorlage) | Öffnet das Datei-Verzeichnis zur Auswahl des PowerShell-Ordners, der importiert werden soll. |
| Löschen (PowerShell-Vorlage) | Öffnet das Dialogfenster zur Auswahl der zu löschenden PowerShell-Vorlagen. |
| Exportieren (PowerShell -Vorlage) | Öffnet das Dialogfenster zur Auswahl der zu exportierenden PowerShell-Vorlagen und zur Festlegung der Export-Einstellungen. |
| Hinzufügen (Ordner) | Öffnet das Dialogfenster zum Erstellen eines neuen Vorlagenordners. |
| Umbenennen (Ordner) | Öffnet das Dialogfenster zum Umbenennen des ausgewählten Vorlagenordners. |
| Löschen (Ordner) | Löscht den ausgewählten Ordner (nur bei leeren Ordnern möglich). |
| Handbuch | Öffnet die Webseite https://doc.aagon.com/bin/view/AESB im Standard-Browser. |
PowerShell-Vorlagen bearbeiten
Erstellte PowerShell-Vorlagen können Sie mit verschiedenen Funktionen bearbeiten und weiterentwickeln.
PowerShell-Vorlage bearbeiten
Bei Auswahl einer PowerShell-Vorlage stehen Ihnen folgende Funktionen zur Verfügung:
| Funktion | Bedeutung |
| Eigenschaften (Bearbeiten) | Startet den Bearbeitungsmodus, in dem anschließend die Eigenschaften der PowerShell-Vorlage im Detailbereich angepasst werden können. |
| Skript (Bearbeiten) | Öffnet die ausgewählte PowerShell-Vorlage im Skript-Editor. Detaillierte Informationen zur Bearbeitung finden Sie im Abschnitt Skript-Editor. |
| Schema (Bearbeiten) | Öffnet die ausgewählte PowerShell-Vorlage im Schema-Designer. Detaillierte Informationen zur Bearbeitung finden Sie im Abschnitt Schema-Designer. |
| Module (Bearbeiten) | Öffnet den Module-Dialog für die ausgewählte PowerShell-Vorlage. Detaillierte Informationen zur Verwaltung der Module finden Sie im Abschnitt Module. |
| Favorisieren (PowerShell-Vorlage) | Fügt die ausgewählte Vorlage zur Favoriten-Liste bei der Erstellung von Vorlagen hinzu. |
| Löschen (PowerShell-Vorlage) | Löscht die ausgewählte PowerShell-Vorlage. |
| Duplizieren (PowerShell -Vorlage) | Erstellt eine Kopie der ausgewählten PowerShell-Vorlage. |
| Exportieren (PowerShell -Vorlage) | Öffnet das Dialogfenster zur Auswahl des Ordners, in den der Ordner mit den Dateien der PowerShell-Vorlage exportiert werden soll. |
| Aktualisieren (PowerShell -Vorlage) | Ermöglicht es, PowerShell-Vorlagen einer früheren Version von AESB auf die aktuelle Version zu aktualisieren. |
| Bereitstellen (Microservice-Paket) | Fügt den ausgewählten PowerShell-Microservice direkt als Microservice-Paket im Microservices-Workspace hinzu. |
| Exportieren (Microservice-Paket) | Öffnet das Dialogfenster zur Festlegung der Export-Einstellungen für das Microservice-Paket.
Wenn Sie einen PowerShell-Microservice weitergeben, achten Sie darauf diesen tatsächlich als Microservice-Datei (MSPACK) zu verteilen. Wenn Sie stattdessen die PowerShell-Vorlage verteilen, kann der Microservice von anderen Nutzern ggf. nicht eingesetzt werden, da ihnen die nötigen Berechtigungen fehlen. |
| Beenden (Tests) | Beendet alle laufenden Testkonfigurationen der PowerShell-Vorlage. Detaillierte Informationen zum Testen von PowerShell-Skripten finden Sie im Abschnitt Skript-Editor. |
PowerShell-Vorlage als Microservice-Paket bereitstellen
Zur Erstellung einer PowerShell-Microservice-Instanz müssen Sie die PowerShell-Vorlage zunächst als Microservice-Paket bereitstellen:
- Wählen Sie im PowerShell-Vorlagen-Repository die Vorlage aus, die Sie als Microservice-Paket bereitstellen möchten.
- Klicken Sie in der Ribbonleiste auf den Button Bereitstellen, um den Bereitstellungsprozess anzustoßen.
Die PowerShell-Vorlage wird nun als Microservice-Paket bereitgestellt und Sie erhalten im Statusfenster eine Information, ob die Bereitstellung erfolgreich war.
Hinweis:
Nach einem Update von AESB wird grundsätzlich empfohlen alle Microservice-Instanzen, bei denen es sich um PowerShell-Microservices handelt, zu aktualisieren und erneut bereitzustellen.
Veraltete PowerShell-Vorlagen aktualisieren
Nach einem Update von AESB, müssen bestehende PowerShell-Vorlagen auf die neue Version aktualisiert werden. PowerShell-Vorlagen, die davon betroffen sind, werden im Vorlagen-Repository mit dem Zusatz Legacy gekennzeichnet. Diese können ohne Aktualisierung nicht mehr bearbeitet werden.
- Wählen Sie im PowerShell-Vorlagen-Repository die Vorlage aus, die Sie aktualisieren möchten.
- Klicken Sie in der Ribbonleiste auf den Button Aktualisieren, um den Aktualisierungsprozess anzustoßen.
Achtung: Sichern Sie die PowerShell-Vorlage vor der Aktualisierung ab, indem Sie diese exportieren. Ansonsten kann es bei einer fehlgeschlagenen Aktualisierung zum Verlust der PowerShell-Vorlage kommen.
- Bestätigen Sie die Ausführung des Aktualisierungsvorgangs, indem Sie im Dialogfenster auf den Button Ja klicken.
PowerShell-Vorlage aktualisieren
PowerShell-Werkzeuge
Mit dem Skript-Editor und Schema-Designer stehen Ihnen zwei effiziente Werkzeuge zur Verfügung. So können Sie selbst, ohne umfangreiche Programmierkenntnisse, eigene voll konfigurierbare Microservices entwickeln. Diese können Sie anschließend als ganzheitlich funktionale Microservices exportieren und in Kombination mit Workflows für die Kommunikation und Verarbeitung von Daten zwischen Ihren Systemen nutzen.
Außerdem können Sie mit der Modul-Verwaltung von nun an Module aus der PowerShell Gallery nutzen, AESB-Shell-Module hinzufügen und eigene PowerShell-Module anlegen.
Entwicklung von PowerShell-Microservices
In unserem Best Practice zeigen wir Ihnen, wie Sie ein Projekt zur Entwicklung eigener PowerShell-Microservices standardmäßig aufbauen und was Sie beachten sollten. Im konkreten Beispiel Entwicklung eines ACMP Connectors für die ISS erklären wir Ihnen Schritt für Schritt, wie Sie Ihre Entwicklungsumgebung einrichten und wie Sie in den einzelnen Projektphasen vorgehen können.