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>>doc:AESB.110.Entwicklung von PowerShell Microservices.WebHome]].

4

5

= PowerShell-Vorlagen =

6

7

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ü.

8

9

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.

10

11

[[PowerShell-Workspace>>image:Powershell Arbeitsbereich.png||alt="PowerShell-Workspace"]]

12

13

Bei Auswahl des Vorlagen-Repositorys oder eines Ordners stehen Ihnen folgende Funktionen zur Verfügung:

14

15

|=**Button**|=**Funktionen**

16

|Hinzufügen (PowerShell-Vorlage)|Erstellt eine neue PowerShell-Vorlage mit leeren Eigenschaften.

17

|Importieren (PowerShell-Vorlage)|Öffnet das Datei-Verzeichnis zur Auswahl des PowerShell-Ordners, der importiert werden soll.

18

|Löschen (PowerShell-Vorlage)|Öffnet das Dialogfenster zur Auswahl der zu löschenden PowerShell-Vorlagen.

19

|Exportieren (PowerShell -Vorlage)|Öffnet das Dialogfenster zur Auswahl der zu exportierenden PowerShell-Vorlagen und zur Festlegung der Export-Einstellungen.

20

|Hinzufügen (Ordner)|Öffnet das Dialogfenster zum Erstellen eines neuen Vorlagenordners.

21

|Umbenennen (Ordner)|Öffnet das Dialogfenster zum Umbenennen des ausgewählten Vorlagenordners.

22

|Löschen (Ordner)|Löscht den ausgewählten Ordner (nur bei leeren Ordnern möglich).

23

|Handbuch|Öffnet die Webseite [[https:~~/~~/doc.aagon.com/bin/view/AESB>>https://doc.aagon.com/bin/view/AESB]] im Standard-Browser.

24

25

== PowerShell-Vorlagen bearbeiten ==

26

27

Erstellte PowerShell-Vorlagen können Sie mit verschiedenen Funktionen bearbeiten und weiterentwickeln.

28

29

[[PowerShell-Vorlage bearbeiten>>image:PowerShell_Vorlage.png||alt="PowerShell-Vorlage bearbeiten"]]

30

31

Bei Auswahl einer PowerShell-Vorlage stehen Ihnen folgende Funktionen zur Verfügung:

32

33

|(% style="width:287px" %)**Funktion**|(% style="width:1152px" %)**Bedeutung**

34

|(% style="width:287px" %)Eigenschaften (Bearbeiten)|(% style="width:1152px" %)Startet den Bearbeitungsmodus, in dem anschließend die Eigenschaften der PowerShell-Vorlage im Detailbereich angepasst werden können.

35

|(% style="width:287px" %)Skript (Bearbeiten)|(% style="width:1152px" %)Öffnet die ausgewählte PowerShell-Vorlage im Skript-Editor. Detaillierte Informationen zur Bearbeitung finden Sie im Abschnitt [[Skript-Editor>>doc:.Skript-Editor.WebHome]].

36

|(% style="width:287px" %)Schema (Bearbeiten)|(% style="width:1152px" %)Öffnet die ausgewählte PowerShell-Vorlage im Schema-Designer. Detaillierte Informationen zur Bearbeitung finden Sie im Abschnitt [[Schema-Designer>>doc:.Schema-Designer.WebHome]].

37

|(% style="width:287px" %)Module (Bearbeiten)|(% style="width:1152px" %)Öffnet den Module-Dialog für die ausgewählte PowerShell-Vorlage. Detaillierte Informationen zur Verwaltung der Module finden Sie im Abschnitt [[Module>>doc:.Module.WebHome]].

38

|(% style="width:287px" %)Favorisieren (PowerShell-Vorlage)|(% style="width:1152px" %)Fügt die ausgewählte Vorlage zur Favoriten-Liste bei der Erstellung von Vorlagen hinzu.

39

|(% style="width:287px" %)Löschen (PowerShell-Vorlage)|(% style="width:1152px" %)Löscht die ausgewählte PowerShell-Vorlage.

40

|(% style="width:287px" %)Duplizieren (PowerShell -Vorlage)|(% style="width:1152px" %)Erstellt eine Kopie der ausgewählten PowerShell-Vorlage.

41

|(% style="width:287px" %)Exportieren (PowerShell -Vorlage)|(% style="width:1152px" %)Öffnet das Dialogfenster zur Auswahl des Ordners, in den der Ordner mit den Dateien der PowerShell-Vorlage exportiert werden soll.

42

|(% style="width:287px" %)Aktualisieren (PowerShell -Vorlage)|(% style="width:1152px" %)Ermöglicht es, PowerShell-Vorlagen einer früheren Version von AESB auf die aktuelle Version zu aktualisieren.

43

|(% style="width:287px" %)Bereitstellen (Microservice-Paket)|(% style="width:1152px" %)Fügt den ausgewählten PowerShell-Microservice direkt als Microservice-Paket im Microservices-Workspace hinzu.

44

|(% style="width:287px" %)Exportieren (Microservice-Paket)|(% style="width:1152px" %)Öffnet das Dialogfenster zur Festlegung der Export-Einstellungen für das Microservice-Paket. {{aagon.infobox}}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.{{/aagon.infobox}}

45

|(% style="width:287px" %)Beenden (Tests)|(% style="width:1152px" %)Beendet alle laufenden Testkonfigurationen der PowerShell-Vorlage. Detaillierte Informationen zum Testen von PowerShell-Skripten finden Sie im Abschnitt [[Skript-Editor>>doc:.Skript-Editor.WebHome]].

46

47

== PowerShell-Vorlage als Microservice-Paket bereitstellen ==

48

49

Zur Erstellung einer PowerShell-Microservice-Instanz müssen Sie die PowerShell-Vorlage zunächst als Microservice-Paket bereitstellen:

50

51

1. Wählen Sie im PowerShell-Vorlagen-Repository die Vorlage aus, die Sie als Microservice-Paket bereitstellen möchten.

52

1. Klicken Sie in der Ribbonleiste auf den Button //Bereitstellen//, um den Bereitstellungsprozess anzustoßen.

53

54

Die PowerShell-Vorlage wird nun als Microservice-Paket bereitgestellt und Sie erhalten im Statusfenster eine Information, ob die Bereitstellung erfolgreich war.

55

56

57

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.

58

59

60

== Veraltete PowerShell-Vorlagen aktualisieren ==

61

62

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.

63

64

1. Wählen Sie im PowerShell-Vorlagen-Repository die Vorlage aus, die Sie aktualisieren möchten.

65

1. Klicken Sie in der Ribbonleiste auf den Button //Aktualisieren//, um den Aktualisierungsprozess anzustoßen.{{aagon.warnungsbox}}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.{{/aagon.warnungsbox}}

66

1. Bestätigen Sie die Ausführung des Aktualisierungsvorgangs, indem Sie im Dialogfenster auf den Button //Ja// klicken.

67

68

[[PowerShell-Vorlage aktualisieren>>image:PowerShell-Vorlage aktualisieren.png||alt="PowerShell-Vorlage aktualisieren"]]

69

70

= PowerShell-Werkzeuge =

71

72

Mit dem [[Skript-Editor>>doc:.Skript-Editor.WebHome||style="background-color: rgb(255, 255, 255);"]] und [[Schema-Designer>>doc:.Schema-Designer.WebHome||style="background-color: rgb(255, 255, 255);"]] 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.

73

74

Außerdem können Sie mit der [[Modul-Verwaltung>>doc:.Module.WebHome]] von nun an Module aus der PowerShell Gallery nutzen, AESB-Shell-Module hinzufügen und eigene PowerShell-Module anlegen.

75

76

= Entwicklung von PowerShell-Microservices =

77

78

In unserem [[Best Practice>>doc:AESB.111.Entwicklung von PowerShell Microservices.WebHome]] 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>>doc:AESB.111.Entwicklung von PowerShell Microservices.Entwicklung eines ACMP Connectors für die ISS.WebHome]] erklären wir Ihnen Schritt für Schritt, wie Sie Ihre Entwicklungsumgebung einrichten und wie Sie in den einzelnen Projektphasen vorgehen können.

Wiki-Quellcode von PowerShell

Navigation

author	version	line-number	content
		1	{{aagon.floatingbox/}}
		2
		3	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>>doc:AESB.110.Entwicklung von PowerShell Microservices.WebHome]].
		4
		5	= PowerShell-Vorlagen =
		6
		7	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ü.
		8
		9	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.
		10
		11	[[PowerShell-Workspace>>image:Powershell Arbeitsbereich.png\|\|alt="PowerShell-Workspace"]]
		12
		13	Bei Auswahl des Vorlagen-Repositorys oder eines Ordners stehen Ihnen folgende Funktionen zur Verfügung:
		14
		15	\|=Button\|=Funktionen
		16	\|Hinzufügen (PowerShell-Vorlage)\|Erstellt eine neue PowerShell-Vorlage mit leeren Eigenschaften.
		17	\|Importieren (PowerShell-Vorlage)\|Öffnet das Datei-Verzeichnis zur Auswahl des PowerShell-Ordners, der importiert werden soll.
		18	\|Löschen (PowerShell-Vorlage)\|Öffnet das Dialogfenster zur Auswahl der zu löschenden PowerShell-Vorlagen.
		19	\|Exportieren (PowerShell -Vorlage)\|Öffnet das Dialogfenster zur Auswahl der zu exportierenden PowerShell-Vorlagen und zur Festlegung der Export-Einstellungen.
		20	\|Hinzufügen (Ordner)\|Öffnet das Dialogfenster zum Erstellen eines neuen Vorlagenordners.
		21	\|Umbenennen (Ordner)\|Öffnet das Dialogfenster zum Umbenennen des ausgewählten Vorlagenordners.
		22	\|Löschen (Ordner)\|Löscht den ausgewählten Ordner (nur bei leeren Ordnern möglich).
		23	\|Handbuch\|Öffnet die Webseite [[https:~~/~~/doc.aagon.com/bin/view/AESB>>https://doc.aagon.com/bin/view/AESB]] im Standard-Browser.
		24
		25	== PowerShell-Vorlagen bearbeiten ==
		26
		27	Erstellte PowerShell-Vorlagen können Sie mit verschiedenen Funktionen bearbeiten und weiterentwickeln.
		28
		29	[[PowerShell-Vorlage bearbeiten>>image:PowerShell_Vorlage.png\|\|alt="PowerShell-Vorlage bearbeiten"]]
		30
		31	Bei Auswahl einer PowerShell-Vorlage stehen Ihnen folgende Funktionen zur Verfügung:
		32
		33	\|(% style="width:287px" %)Funktion\|(% style="width:1152px" %)Bedeutung
		34	\|(% style="width:287px" %)Eigenschaften (Bearbeiten)\|(% style="width:1152px" %)Startet den Bearbeitungsmodus, in dem anschließend die Eigenschaften der PowerShell-Vorlage im Detailbereich angepasst werden können.
		35	\|(% style="width:287px" %)Skript (Bearbeiten)\|(% style="width:1152px" %)Öffnet die ausgewählte PowerShell-Vorlage im Skript-Editor. Detaillierte Informationen zur Bearbeitung finden Sie im Abschnitt [[Skript-Editor>>doc:.Skript-Editor.WebHome]].
		36	\|(% style="width:287px" %)Schema (Bearbeiten)\|(% style="width:1152px" %)Öffnet die ausgewählte PowerShell-Vorlage im Schema-Designer. Detaillierte Informationen zur Bearbeitung finden Sie im Abschnitt [[Schema-Designer>>doc:.Schema-Designer.WebHome]].
		37	\|(% style="width:287px" %)Module (Bearbeiten)\|(% style="width:1152px" %)Öffnet den Module-Dialog für die ausgewählte PowerShell-Vorlage. Detaillierte Informationen zur Verwaltung der Module finden Sie im Abschnitt [[Module>>doc:.Module.WebHome]].
		38	\|(% style="width:287px" %)Favorisieren (PowerShell-Vorlage)\|(% style="width:1152px" %)Fügt die ausgewählte Vorlage zur Favoriten-Liste bei der Erstellung von Vorlagen hinzu.
		39	\|(% style="width:287px" %)Löschen (PowerShell-Vorlage)\|(% style="width:1152px" %)Löscht die ausgewählte PowerShell-Vorlage.
		40	\|(% style="width:287px" %)Duplizieren (PowerShell -Vorlage)\|(% style="width:1152px" %)Erstellt eine Kopie der ausgewählten PowerShell-Vorlage.
		41	\|(% style="width:287px" %)Exportieren (PowerShell -Vorlage)\|(% style="width:1152px" %)Öffnet das Dialogfenster zur Auswahl des Ordners, in den der Ordner mit den Dateien der PowerShell-Vorlage exportiert werden soll.
		42	\|(% style="width:287px" %)Aktualisieren (PowerShell -Vorlage)\|(% style="width:1152px" %)Ermöglicht es, PowerShell-Vorlagen einer früheren Version von AESB auf die aktuelle Version zu aktualisieren.
		43	\|(% style="width:287px" %)Bereitstellen (Microservice-Paket)\|(% style="width:1152px" %)Fügt den ausgewählten PowerShell-Microservice direkt als Microservice-Paket im Microservices-Workspace hinzu.
		44	\|(% style="width:287px" %)Exportieren (Microservice-Paket)\|(% style="width:1152px" %)Öffnet das Dialogfenster zur Festlegung der Export-Einstellungen für das Microservice-Paket. {{aagon.infobox}}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.{{/aagon.infobox}}
		45	\|(% style="width:287px" %)Beenden (Tests)\|(% style="width:1152px" %)Beendet alle laufenden Testkonfigurationen der PowerShell-Vorlage. Detaillierte Informationen zum Testen von PowerShell-Skripten finden Sie im Abschnitt [[Skript-Editor>>doc:.Skript-Editor.WebHome]].
		46
		47	== PowerShell-Vorlage als Microservice-Paket bereitstellen ==
		48
		49	Zur Erstellung einer PowerShell-Microservice-Instanz müssen Sie die PowerShell-Vorlage zunächst als Microservice-Paket bereitstellen:
		50
		51	1. Wählen Sie im PowerShell-Vorlagen-Repository die Vorlage aus, die Sie als Microservice-Paket bereitstellen möchten.
		52	1. Klicken Sie in der Ribbonleiste auf den Button //Bereitstellen//, um den Bereitstellungsprozess anzustoßen.
		53
		54	Die PowerShell-Vorlage wird nun als Microservice-Paket bereitgestellt und Sie erhalten im Statusfenster eine Information, ob die Bereitstellung erfolgreich war.
		55
		56	{{aagon.infobox}}
		57	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.
		58	{{/aagon.infobox}}
		59
		60	== Veraltete PowerShell-Vorlagen aktualisieren ==
		61
		62	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.
		63
		64	1. Wählen Sie im PowerShell-Vorlagen-Repository die Vorlage aus, die Sie aktualisieren möchten.
		65	1. Klicken Sie in der Ribbonleiste auf den Button //Aktualisieren//, um den Aktualisierungsprozess anzustoßen.{{aagon.warnungsbox}}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.{{/aagon.warnungsbox}}
		66	1. Bestätigen Sie die Ausführung des Aktualisierungsvorgangs, indem Sie im Dialogfenster auf den Button //Ja// klicken.
		67
		68	[[PowerShell-Vorlage aktualisieren>>image:PowerShell-Vorlage aktualisieren.png\|\|alt="PowerShell-Vorlage aktualisieren"]]
		69
		70	= PowerShell-Werkzeuge =
		71
		72	Mit dem [[Skript-Editor>>doc:.Skript-Editor.WebHome\|\|style="background-color: rgb(255, 255, 255);"]] und [[Schema-Designer>>doc:.Schema-Designer.WebHome\|\|style="background-color: rgb(255, 255, 255);"]] 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.
		73
		74	Außerdem können Sie mit der [[Modul-Verwaltung>>doc:.Module.WebHome]] von nun an Module aus der PowerShell Gallery nutzen, AESB-Shell-Module hinzufügen und eigene PowerShell-Module anlegen.
		75
		76	= Entwicklung von PowerShell-Microservices =
		77
		78	In unserem [[Best Practice>>doc:AESB.111.Entwicklung von PowerShell Microservices.WebHome]] 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>>doc:AESB.111.Entwicklung von PowerShell Microservices.Entwicklung eines ACMP Connectors für die ISS.WebHome]] erklären wir Ihnen Schritt für Schritt, wie Sie Ihre Entwicklungsumgebung einrichten und wie Sie in den einzelnen Projektphasen vorgehen können.