Changes for page Microservice Cmdlets

Last modified by jklein on 2025/08/15 09:48

From version 7.1
edited by jklein
on 2025/07/16 09:56
Change comment: There is no comment for this version
To version 12.1
edited by jklein
on 2025/07/21 12:30
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,28 +4,37 @@
4 4  
5 5  == Add-AESBMicroservice ==
6 6  
7 -Mit diesem Cmdlet wird eine neue Microservice-Instanz nach der Vorlage eines Templates hinzugefügt.
7 +Mit diesem Cmdlet wird eine neue Microservice-Instanz auf Grundlage einer bestimmten Vorlage hinzugefügt.
8 8  
9 -|=(% style="width: 213px;" %)Parameter |=(% style="width: 209px;" %)ParameterSetName|=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
10 -|-ConnectionName|Keine|String|✅|C|Der Name der Verbindung, über die die Microservice-Instanz hinzugefügt werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
11 -|-InstanceName|Keine|String|❌|Keine|Der Name der Instanz.
12 -|-TemplateName|UseTemplateName|String|❌|Keine|Der Name des Templates für die Vorlage der Instanz.
13 -|-TemplateId|UseTemplateId|String|❌|Keine|Die Id des Templates für die Vorlage der Instanz.
14 -|-SupervisorId|Keine|String|✅|Keine|Die Id des Supervisors zu der die Instanz hinzugefügt werden soll.
15 -|-StartupType|Keine|InstanceStartType|✅|Keine|Setzt die Art der Zeitplanung der Instanz.
16 -|-StoppedAfterCreation|Keine|Bool|✅|Keine|Setzt den Wert um die Instanz direkt nach der Erstellung zu starten.
9 +(% style="width:902px" %)
10 +|=(% style="width: 213px;" %)Parameter |=(% style="width: 154px;" %)ParameterSetName|=(% style="width: 156px;" %)Datentyp|=(% style="width: 55px;" %)Optional|=(% style="width: 76px;" %)Alias|=(% style="width: 206px;" %)Beschreibung
11 +|-ConnectionName|(% style="width:154px" %)Keine|(% style="width:156px" %)String|(% style="width:55px" %)✅|(% style="width:76px" %)C|(% style="width:206px" %)Der Name der Verbindung, über die die Microservice-Instanz hinzugefügt werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
12 +|-InstanceName|(% style="width:154px" %)Keine|(% style="width:156px" %)String|(% style="width:55px" %)❌|(% style="width:76px" %)Keine|(% style="width:206px" %)Der Name der Instanz.
13 +|-TemplateName|(% style="width:154px" %)UseTemplateName|(% style="width:156px" %)String|(% style="width:55px" %)❌|(% style="width:76px" %)Keine|(% style="width:206px" %)Der Name für die Vorlage der Instanz.
14 +|-TemplateId|(% style="width:154px" %)UseTemplateId|(% style="width:156px" %)String|(% style="width:55px" %)❌|(% style="width:76px" %)Keine|(% style="width:206px" %)Die Id für die Vorlage der Instanz.
15 +|-SupervisorId|(% style="width:154px" %)Keine|(% style="width:156px" %)String|(% style="width:55px" %)✅|(% style="width:76px" %)Keine|(% style="width:206px" %)Die Id des Supervisors zu der die Instanz hinzugefügt werden soll.
16 +|-StartupType|(% style="width:154px" %)Keine|(% style="width:156px" %)InstanceStartType|(% style="width:55px" %)✅|(% style="width:76px" %)Keine|(% style="width:206px" %)Setzt die Art der Zeitplanung der Instanz.
17 +|-StoppedAfterCreation|(% style="width:154px" %)Keine|(% style="width:156px" %)Bool|(% style="width:55px" %)✅|(% style="width:76px" %)Keine|(% style="width:206px" %)Setzt den Wert um die Instanz direkt nach der Erstellung zu starten.
17 17  
19 +=== Parameter-Sets ===
20 +
21 +Das Cmdlet verwendet Parameter-Sets, um verschiedene Möglichkeiten zum Hinzufügen von Microservices zu ermöglichen:
22 +
23 +**TemplateNameParameterSet**: Ermöglicht das Hinzufügen von Microservice-Instanzen über den Vorlagen-Namen
24 +
25 +**TemplateIdParameterSet**: Ermöglicht das Hinzufügen von Microservice-Instanzen über die Vorlagen-Id
26 +
18 18  === **Beispiele** ===
19 19  
20 -Beispiel 1: Microservice über Template-Name hinzufügen
29 +Beispiel 1: Microservice über Vorlagen-Name hinzufügen
21 21  
22 22  {{code language="PowerShell"}}
23 23  Add-AESBMicroservice -InstanceName "Test" -TemplateName "Tester"
24 24  {{/code}}
25 25  
26 -Dieses Beispiel fügt eine neue Instanz mithilfe des Template-Namen hinzu. Die Standardverbindung wird verwendet.
35 +Dieses Beispiel fügt eine neue Instanz mithilfe des Vorlagen-Namen hinzu. Die Standardverbindung wird verwendet.
27 27  
28 -Beispiel 2: Microservice über Template-Id hinzufügen
37 +Beispiel 2: Microservice über Vorlagen-Id hinzufügen
29 29  
30 30  {{code language="PowerShell"}}
31 31  Add-AESBMicroservice -InstanceName "Test" -TemplateId "ffffffff-ffff-ffff-ffff-ffffffffffff"
... ... @@ -33,15 +33,15 @@
33 33  {{/code}}
34 34  
35 35  (% class="wikigeneratedid" %)
36 -Dieses Beispiel fügt eine neue Instanz mithilfe der Template-Id hinzu. Die Standardverbindung wird verwendet.
45 +Dieses Beispiel fügt eine neue Instanz mithilfe der Vorlagen-Id hinzu. Die Standardverbindung wird verwendet.
37 37  
38 -Beispiel 3: Microservice StartUpType beim Hinzufügen setze
47 +Beispiel 3: Microservice-StartUpType beim Hinzufügen setzen
39 39  
40 40  {{code language="PowerShell"}}
41 41  Add-AESBMicroservice -InstanceName "Test" -TemplateId "ffffffff-ffff-ffff-ffff-ffffffffffff" -StartupType Manual
42 42  {{/code}}
43 43  
44 -Dieses Beispiel fügt eine neue Instanz mithilfe der Template-Id hinzu und setzt den //StartupType// auf //Manuell//. Die Standardverbindung wird verwendet.
53 +Dieses Beispiel fügt eine neue Instanz mithilfe der Vorlagen-Id hinzu und setzt den //StartupType// auf //Manuell//. Die Standardverbindung wird verwendet.
45 45  
46 46  Beispiel 4: Microservice mit SupervisorId setzen
47 47  
... ... @@ -50,7 +50,7 @@
50 50  
51 51  {{/code}}
52 52  
53 -Dieses Beispiel fügt eine neue Instanz einen bestimmten Supervisor hinzu, der über die Supervisor-Id angegeben wird. Die Standardverbindung wird verwendet.
62 +Dieses Beispiel fügt eine neue Instanz einem bestimmten Supervisor hinzu, der über die Supervisor-Id angegeben wird. Die Standardverbindung wird verwendet.
54 54  
55 55  Beispiel 5: Microservice mit StoppedAfterCreation setze
56 56  
... ... @@ -77,7 +77,7 @@
77 77  Mit den optionalen Parametern können Sie die Ausgabe filtern und spezifische Microservices oder Instanzen abrufen.
78 78  
79 79  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
80 -|-ConnectionName|String|✅|C|Der Name der Verbindung, Informationen zu Microservice-Instanzen abgerufen werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
89 +|-ConnectionName|String|✅|C|Der Name der Verbindung, über welche die Informationen zu Microservice-Instanzen abgerufen werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
81 81  |-InstanceNames|String[]|✅❌| |Gibt die Namen der Microservice-Instanzen an, die abgerufen werden sollen. Du kannst einen oder mehrere Instanznamen als String-Array übergeben.
82 82  |-SupervisorIds|String[]|✅❌| |Filtert Microservices basierend auf den IDs ihrer übergeordneten Supervisoren. Du musst eine oder mehrere Supervisor-IDs als String-Array übergeben.
83 83  |-ShowAllInstances|SwitchParameter|✅| |Wenn dieser Parameter angegeben wird, zeigt das Cmdlet alle Instanzen von Microservices an, einschließlich derer, die normalerweise ausgeblendet oder als inaktiv betrachtet werden könnten.
... ... @@ -86,9 +86,9 @@
86 86  
87 87  Das Cmdlet verwendet Parameter-Sets, um verschiedene Möglichkeiten zur Abfrage von Microservices zu ermöglichen:
88 88  
89 -* **InstanceNamesParameterSetName**: Ermöglicht das Abrufen von Microservices, basierend auf ihren Instanznamen.
90 -* **SupervisorsParameterSetName**: Ermöglicht das Abrufen von Microservices, die bestimmten Supervisor-IDs zugeordnet sind.
91 -* **NotRequiredParameterSetName**: Dient hauptsächlich dazu, die ShowAllInstances-Option zu ermöglichen.
98 +* **InstanceNamesParameterSet**: Ermöglicht das Abrufen von Microservices, basierend auf ihren Instanz-Namen.
99 +* **SupervisorsParameterSet**: Ermöglicht das Abrufen von Microservices, die bestimmten Supervisor-IDs zugeordnet sind.
100 +* **NotRequiredParameterSet**: Dient hauptsächlich dazu, die ShowAllInstances-Option zu ermöglichen.
92 92  
93 93  Sie können immer nur Parameter aus einem dieser Sets gleichzeitig verwenden.
94 94  
... ... @@ -161,20 +161,20 @@
161 161  
162 162  |=(% style="width: 213px;" %)Parameter |=(% style="width: 209px;" %)ParameterSetName|=Datentyp|=Optional|=Beschreibung
163 163  |-ConnectionName| |String|✅|Der Name der Verbindung, über die Microservice-Instanzen bearbeitet werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
164 -|-InstanceName|NoCredentialParameterSetName,
165 -CredentialParameterSetName|String|❌|Gibt den eindeutigen Namen der Microservice-Instanz an, deren Konfiguration geändert werden soll. Dieser Parameter ist in beiden Parametersets obligatorisch.
166 -|-UseCredentials|CredentialParameterSetName|SwitchParameter|✅❌|Gibt an, dass Anmeldeinformationen für den Microservice konfiguriert werden sollen. Dieser Parameter gehört zum CredentialParameterSetName und ist obligatorisch, wenn dieses Set verwendet wird.
167 -|-UserName|CredentialParameterSetName|String|✅❌|Gibt den Benutzernamen an, der verwendet werden soll, wenn UseCredentials aktiviert ist. Dieser Parameter gehört zum CredentialParameterSetName und ist obligatorisch, wenn dieses Set verwendet wird.
168 -|-Password|CredentialParameterSetName|SecureString|✅❌|Gibt das Passwort für den angegebenen Benutzernamen an. Das Passwort muss als SecureString-Objekt übergeben werden. Dieser Parameter gehört zum CredentialParameterSetName und ist obligatorisch, wenn dieses Set verwendet wird.
169 -|-StartupType|NoCredentialParameterSetName,
170 -CredentialParameterSetName|Enum|❌|Legt fest, wie der Microservice beim Systemstart verhalten soll. Dies ist ein Enum-Wert vom Typ InstanceStartType. Gängige Werte sind Automatic (startet automatisch mit dem System) und Manual (muss manuell gestartet werden).
173 +|-InstanceName|NoCredentialParameterSet,
174 +CredentialParameterSet|String|❌|Gibt den eindeutigen Namen der Microservice-Instanz an, deren Konfiguration geändert werden soll. Dieser Parameter ist in beiden Parametersets obligatorisch.
175 +|-UseCredentials|CredentialParameterSet|SwitchParameter|✅❌|Gibt an, dass Anmeldeinformationen für den Microservice konfiguriert werden sollen. Dieser Parameter gehört zum CredentialParameterSetName und ist obligatorisch, wenn dieses Set verwendet wird.
176 +|-UserName|CredentialParameterSet|String|✅❌|Gibt den Benutzernamen an, der verwendet werden soll, wenn UseCredentials aktiviert ist. Dieser Parameter gehört zum CredentialParameterSetName und ist obligatorisch, wenn dieses Set verwendet wird.
177 +|-Password|CredentialParameterSet|SecureString|✅❌|Gibt das Passwort für den angegebenen Benutzernamen an. Das Passwort muss als SecureString-Objekt übergeben werden. Dieser Parameter gehört zum CredentialParameterSetName und ist obligatorisch, wenn dieses Set verwendet wird.
178 +|-StartupType|NoCredentialParameterSet,
179 +CredentialParameterSet|Enum|❌|Legt fest, wie sich der Microservice beim Systemstart verhalten soll. Dies ist ein Enum-Wert vom Typ InstanceStartType. Gängige Werte sind Automatic (startet automatisch mit dem System) und Manual (muss manuell gestartet werden).
171 171  
172 172  === Parameter-Sets ===
173 173  
174 174  Das Cmdlet verwendet Parameter-Sets, um zwei Hauptszenarien zu unterstützen:
175 175  
176 -* **NoCredentialParameterSetName**: Ermöglicht die Bearbeitung des Starttyps ohne die Angabe von Anmeldeinformationen.
177 -* **CredentialParameterSetName**: Ermöglicht die Bearbeitung des Starttyps //und// die Konfiguration von Anmeldeinformationen für den Microservice.
185 +* **NoCredentialParameterSet**: Ermöglicht die Bearbeitung des Starttyps ohne die Angabe von Anmeldeinformationen.
186 +* **CredentialParameterSet**: Ermöglicht die Bearbeitung des Starttyps //und// die Konfiguration von Anmeldeinformationen für den Microservice.
178 178  
179 179  Sie können immer nur Parameter aus einem dieser Sets gleichzeitig verwenden.
180 180  
... ... @@ -248,9 +248,9 @@
248 248  
249 249  Das Cmdlet gibt eine Sammlung von Objekten zurück, die den Status der Beendigung für jeden angesprochenen Microservice anzeigen. Die Ausgabe im Beispiel zeigt folgende Eigenschaften:
250 250  
251 -* **Status**: Der Status der Beendigungsoperation (z.B. //Unchanged// wenn bereits gestoppt, //Stopped// wenn erfolgreich beendet).
260 +* **Status**: Der Status der Beendigungsoperation (z.B. //Unchanged/////Changed//).
252 252  * **InstanceId**: Die eindeutige ID der betroffenen Microservice-Instanz.
253 -* **InstanceState**: Der Zustand des Microservice nach der Operation (z.B. Already stopped).
262 +* **InstanceState**: Der Zustand des Microservice nach der Operation (z.B. //Stopped/Already stopped//).
254 254  * **Error**: Eine Fehlermeldung, falls die Operation nicht erfolgreich war oder ein Problem aufgetreten ist.
255 255  
256 256  == Move-AESBMicroservices ==
... ... @@ -257,13 +257,12 @@
257 257  
258 258  Mit diesem Cmdlet können Sie eine oder mehrere Microservice-Instanzen auf einen anderen Supervisor verschieben. Es unterstützt optionale Parameter für Timeout und asynchrone Ausführung.
259 259  
260 -
261 261  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
262 262  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Instanzen verschoben werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
263 -|-InstanceIds|String[]|❌| |Die IDs der zu verschiebenden Microservice-Instanzen (Pflichtfeld, unterstützt mehrere Werte)
264 -|-SupervisorId|String|❌| |Die Ziel-SupervisorId, auf die die Instanzen verschoben werden sollen
265 -|-Timeout|String|✅| |Optionales Timeout für die Operation (Standard: "30s")
266 -|-NoWait|SwitchParameter|✅| |Gibt an, ob das Cmdlet auf den Abschluss der Operation warten soll (asynchron)
271 +|-InstanceIds|String[]|❌| |Die IDs der zu verschiebenden Microservice-Instanzen (Pflichtfeld, unterstützt mehrere Werte).
272 +|-SupervisorId|String|❌| |Die Id des Ziel-Supervisors, auf den die Instanzen verschoben werden sollen.
273 +|-Timeout|String|✅| |Optionales Timeout für die Operation (Standard: "30s").
274 +|-NoWait|SwitchParameter|✅| |Gibt an, ob das Cmdlet auf den Abschluss der Operation warten soll (asynchron).
267 267  
268 268  === Beispiele ===
269 269  
... ... @@ -475,11 +475,10 @@
475 475  
476 476  Mit diesem Cmdlet starten Sie die angegebenen, zuvor gestoppten Microservice-Instanzen. Die zu startenden Microservices können entweder über ihre `InstanceIds` oder über eine `SupervisorId` (die alle zugehörigen Instanzen startet) identifiziert werden. Es muss einer der Parameter `-InstanceIds` oder `-SupervisorId` angegeben werden.
477 477  
478 -
479 479  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
480 480  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Instanzen gestartet werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
481 -|-SupervisorId|String|❌|Keine|Gibt die ID des Supervisors an, dessen zugehörige Microservices gestartet werden sollen. Obligatorisch für Parametersatz `SupervisorParametersetName`.
482 -|-InstanceIds|String[]|❌|Keine|Gibt die eindeutigen Instanz-IDs (GUIDs) der Microservices an, die gestartet werden sollen. Es kann eine einzelne ID oder ein Array von IDs übergeben werden. Obligatorisch für Parametersatz `InstanceIdsParametersetName`.
488 +|-SupervisorId|String|❌|Keine|Gibt die ID des Supervisors an, dessen zugehörige Microservices gestartet werden sollen. Obligatorisch für Parametersatz `SupervisorParameterset`.
489 +|-InstanceIds|String[]|❌|Keine|Gibt die eindeutigen Instanz-IDs (GUIDs) der Microservices an, die gestartet werden sollen. Es kann eine einzelne ID oder ein Array von IDs übergeben werden. Obligatorisch für Parametersatz `InstanceIdsParameterset`.
483 483  |-Timeout|String|✅|Keine|Gibt die maximale Wartezeit für den Startvorgang an (z.B. "30s", "1m"). Standardwert: "30s".
484 484  |-NoWait      |SwitchParameter|✅|Keine|Wenn dieser Parameter angegeben ist, wartet das Cmdlet nicht auf den Abschluss des Startvorgangs, sondern kehrt sofort zurück.
485 485  
... ... @@ -626,13 +626,13 @@
626 626  
627 627  === **Beispiele** ===
628 628  
629 -Beispiel 1: Fügt ein neues Microservice-Template hinzu
636 +Beispiel 1: Fügt ein neue Microservice-Vorlage hinzu
630 630  
631 631  {{code language="PowerShell"}}
632 632  Add-AESBMicroserviceTemplate -TemplateName "Test" -TemplateConfig $templateConfig
633 633  {{/code}}
634 634  
635 -Dieses Beispiel fügt eine neue Templatekonfiguration mit dem Namen "Test" auf Basis des $templateConfig-Objekts hinzu. Die Standardverbindung wird verwendet.
642 +Dieses Beispiel fügt eine neue Vorlagen-konfiguration mit dem Namen "Test" auf Basis des $templateConfig-Objekts hinzu. Die Standardverbindung wird verwendet.
636 636  
637 637  {{apimacro title="Beispiel der Funktion in PowerShell"}}
638 638  {{code language="PowerShell" layout="LINENUMBERS"}}
... ... @@ -652,7 +652,7 @@
652 652  {{/code}}
653 653  {{/apimacro}}
654 654  
655 -{{apimacro title="Beispiel der Template-Konfiguration"}}
662 +{{apimacro title="Beispiel der Vorlagen-Konfiguration"}}
656 656  {{code language="PowerShell" layout="LINENUMBERS"}}
657 657  $templateConfig = "<MicroserviceConfiguration Version=`"1.11.0.895`" Type=`"SnmpConnector`" SessionKey=`"bcafdb4e94f2572eed78525430ad0e0275229f98`">
658 658   <SnmpConnectorConfiguration>
... ... @@ -691,17 +691,17 @@
691 691  ** Erfolgreiche Statusmeldung
692 692  * TemplateInfo
693 693  ** TemplateId
694 -*** ID des Templates
701 +*** ID der Vorlage
695 695  ** Configuration
696 -*** Aktuelle Konfiguration des Templates
703 +*** Aktuelle Konfiguration der Vorlage
697 697  ** Name
698 -*** Name des Templates
705 +*** Name der Vorlage
699 699  ** Type
700 -*** Der Typ des Templates
707 +*** Der Typ der Vorlage
701 701  ** Version
702 -*** Die Versionierung des Templates
709 +*** Die Versionierung der Vorlage
703 703  
704 -{{apimacro title="Rückgabewerte der Template-Konfiguration"}}
711 +{{apimacro title="Rückgabewerte der Vorlagen-Konfiguration"}}
705 705  {{code language="PowerShell" layout="LINENUMBERS"}}
706 706  Successfully added template 'Test'.
707 707  
... ... @@ -731,7 +731,7 @@
731 731  
732 732  === **Beispiele** ===
733 733  
734 -Beispiel 1: MicroserviceTemplate exportieren
741 +Beispiel 1: Microservice-Vorlage exportieren
735 735  
736 736  {{code language="PowerShell"}}
737 737  Export-AESBMicroserviceTemplateConfig -TemplateConfig $templateConfig -Path $path
... ... @@ -806,13 +806,13 @@
806 806  
807 807  === Beispiele ===
808 808  
809 -Beispiel 1: MicroserviceTemplateConfig von //$templateName// anfragen
816 +Beispiel 1: Konfiguration der Microservice-Vorlage von //$templateName// anfragen
810 810  
811 811  {{code language="PowerShell"}}
812 812  Get-AESBMicroserviceTemplateConfig -TemplateName $templateName
813 813  {{/code}}
814 814  
815 -Dieses Beispiel fragt die Templatekonfiguration mit dem Namen //$templateName// an. Die Standardverbindung wird verwendet.
822 +Dieses Beispiel fragt die Vorlagen-Konfiguration mit dem Namen //$templateName// an. Die Standardverbindung wird verwendet.
816 816  
817 817  {{code language="PowerShell" layout="LINENUMBERS"}}
818 818  function Get-MicroserviceTemplateConfig {
... ... @@ -831,7 +831,7 @@
831 831  
832 832  * MicroserviceConfiguration
833 833  ** Version
834 -*** Die jeweilige Versionierung des Microservices
841 +*** Die jeweilige Version des Microservices
835 835  ** Type
836 836  *** Der Typ des Microservices
837 837  ** TypeConfiguration
... ... @@ -851,9 +851,61 @@
851 851  1.11.0.895 SnmpConnector SnmpConnectorConfiguration
852 852  {{/code}}
853 853  
861 +== Get-AESBMicroserviceTemplates ==
862 +
863 +Dieses Cmdlet fragt die vorhandenen Microservice-Vorlagen ab und listet sie auf.
864 +
865 +|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
866 +|-ConnectionName|String|✅|C|Der Name der Verbindung, über die die Microservices-Vorlagen-Konfiguration importiert werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
867 +|-PackageName|String|✅| |Der Name des Microservice-Pakets, dessen Vorlagen geholt werden sollen
868 +|-PackageVersion|String|✅| |Die Version des Pakets, dessen Vorlagen geholt werden sollen
869 +
870 +=== Beispiele ===
871 +
872 +Beispiel 1: Alle vorhandenen Microservice-Vorlagen anzeigen
873 +
874 +{{code language="PowerShell"}}
875 +Get-AESBMicroserviceTemplates
876 +{{/code}}
877 +
878 +Dieses Beispiel listet alle vorhandenen Microservice-Vorlagen auf. Die Standardverbindung wird verwendet. Falls keine Vorlagen vorhanden sind, wird ein Fehler angezeigt.
879 +
880 +Beispiel 2: Die Vorlagen eines bestimmten Microservice-Pakets einer bestimmten Version auflisten
881 +
882 +{{code language="PowerShell"}}
883 +Get-AESBMicroserviceTemplates -PackageName "SnmpConnector" -PackageVersion "1.11.0.895"
884 +
885 +{{/code}}
886 +
887 + Dieses Beispiel listet alle vorhandenen Microservice-Vorlagen des Pakets "SnmpConnector" in der Version "1.11.0.895" auf. Die Standardverbindung wird verwendet.
888 +
889 +=== Rückgabewerte ===
890 +
891 +Bei erfolgreicher Anwendung werden die gewünschten Microservice-Vorlagen als Objekte aufgelistet.
892 +
893 +* MicroserviceTemplate
894 +** Name
895 +*** Der Name der Vorlage
896 +** Id
897 +*** Die Id der Vorlage
898 +** PackageName
899 +*** Der Name des Microservice-Pakets
900 +** PackageVersion
901 +*** Die Version des Microservice-Pakets
902 +
903 +{{code language="PowerShell"}}
904 +Name Id PackageName PackageVersion
905 +
906 +---- -- ----------- --------------
907 +
908 +SnmpConnector a6e37f49-5a15-4213-96f5-e23cc03209a8 SnmpConnector 1.11.0.895
909 +
910 +PS_Microservice1 33618fc3-60f2-484b-b6c9-b9f19c5eb4fa PS_Microservice1 1.1.0.1
911 +{{/code}}
912 +
854 854  == Import-AESBMicroserviceTemplateConfig ==
855 855  
856 -Dieses Cmdlet importiert die Templatekonfiguration vom angegebenen Pfad.
915 +Dieses Cmdlet importiert die Vorlagen-Konfiguration vom angegebenen Pfad.
857 857  
858 858  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
859 859  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die die Microservices-Vorlagen-Konfiguration importiert werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
... ... @@ -861,7 +861,7 @@
861 861  
862 862  === Beispiele ===
863 863  
864 -Beispiel 1: Templatekonfiguration von //$path// laden
923 +Beispiel 1: Vorlagen-Konfiguration von //$path// laden
865 865  
866 866  {{code language="PowerShell"}}
867 867  Import-AESBMicroserviceTemplateConfig -Path $path
... ... @@ -868,7 +868,7 @@
868 868  
869 869  {{/code}}
870 870  
871 -Dieses Beispiel importiert die Templatekonfiguration beim hinterlegten Pfad. Die Standardverbindung wird verwendet.
930 +Dieses Beispiel importiert die Vorlagen-Konfiguration beim hinterlegten Pfad. Die Standardverbindung wird verwendet.
872 872  
873 873  === Rückgabewerte ===
874 874  
... ... @@ -876,7 +876,7 @@
876 876  
877 877  * MicroserviceConfiguration
878 878  ** Version
879 -*** Die jeweilige Versionierung des Microservices
938 +*** Die jeweilige Version des Microservices
880 880  ** Type
881 881  *** Der Typ des Microservices
882 882  ** TypeConfiguration
... ... @@ -908,7 +908,7 @@
908 908  
909 909  === Beispiele ===
910 910  
911 -Beispiel 1: Mehrere Templates auf Version //$templateVersion// migrieren
970 +Beispiel 1: Mehrere Vorlagen auf Version //$templateVersion// migrieren
912 912  
913 913  {{code language="PowerShell"}}
914 914  Migrate-AESBMicroserviceTemplates -TemplateNames $templateNames -TargetVersion $templateVersion
... ... @@ -915,23 +915,23 @@
915 915  
916 916  {{/code}}
917 917  
918 -Dieses Beispiel migriert alle Templates die in //$templateNames// stehen auf die Version //$templateVersion//.
977 +Dieses Beispiel migriert alle Vorlagen, die in //$templateNames// stehen, auf die Version //$templateVersion//.
919 919  
920 920  === Rückgabewerte ===
921 921  
922 -Bei erfolgreicher Anwendung erhalten Sie eine Liste von Template-Informationen mit den neuen Daten der erfolgreich migrierten Templates:
981 +Bei erfolgreicher Anwendung erhalten Sie eine Liste von Vorlagen-Informationen mit den neuen Daten der erfolgreich migrierten Vorlagen:
923 923  
924 924  * TemplateInfo
925 925  ** TemplateId
926 -*** Die neu erstellte / gleichbleibende Id des Templates
985 +*** Die neu erstellte / gleichbleibende Id der Vorlage
927 927  ** Configuration
928 -*** Die aktuelle Konfiguration des Templates
987 +*** Die aktuelle Konfiguration der Vorlage
929 929  ** Name
930 -*** Der neue Name des Template
989 +*** Der neue Name der Vorlage
931 931  ** Type
932 -*** Der Typ des Templates
991 +*** Der Typ der Vorlage
933 933  ** Version
934 -*** Die neue Version des Templates
993 +*** Die neue Version der Vorlage
935 935  
936 936  {{code language="PowerShell"}}
937 937  TemplateId : ffffffff-ffff-ffff-ffff-ffffffffffff"
... ... @@ -965,17 +965,17 @@
965 965  New-AESBMicroserviceTemplateConfig -PackageName $packageName -PackageVersion $packageVersion
966 966  {{/code}}
967 967  
968 -Dieses Beispiel erstellt eine Template-Konfiguration auf Basis des angegebenen Microservicepackage.
1027 +Dieses Beispiel erstellt eine Vorlagen-Konfiguration auf Basis des angegebenen Microservice-Pakets.
969 969  
970 970  === Rückgabewerte ===
971 971  
972 972  * MicroserviceConfiguration
973 973  ** Version
974 -*** Die neue Version des Templates
1033 +*** Die neue Version der Vorlage
975 975  ** Type
976 -*** Der Typ des Templates
1035 +*** Der Typ der Vorlage
977 977  ** Configuration
978 -*** Die aktuelle Konfiguration des Templates
1037 +*** Die aktuelle Konfiguration der Vorlage
979 979  
980 980  {{code language="PowerShell" layout="LINENUMBERS"}}
981 981  $microserviceTemplateConfig = New-AESBMicroserviceTemplateConfig -PackageName $packageName -PackageVersion $packageVersion
... ... @@ -995,7 +995,6 @@
995 995  
996 996  Mit diesem Cmdlet können Sie Microservice-Vorlagen löschen.
997 997  
998 -
999 999  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
1000 1000  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die die Microservice-Vorlagen gelöscht werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
1001 1001  |-TemplateIds|String[]|❌|Keine|Die ID's der Vorlagen, die zu löschen sind.
... ... @@ -1003,7 +1003,7 @@
1003 1003  
1004 1004  === Beispiele ===
1005 1005  
1006 -Beispiel 1: Template löschen
1064 +Beispiel 1: Vorlage löschen
1007 1007  
1008 1008  {{code language="PowerShell"}}
1009 1009  Remove-AESBMicroserviceTemplate -TemplateIds 4b016fd1-47fb-4f24-87dd-4e365fe870d3
... ... @@ -1010,17 +1010,17 @@
1010 1010  
1011 1011  {{/code}}
1012 1012  
1013 -Dieses Beispiel löscht ein Microservice Template auf Basis der angegebenen Id.
1071 +Dieses Beispiel löscht eine Microservice-Vorlage auf Basis der angegebenen Id.
1014 1014  
1015 -Beispiel 2: Templates löschen
1073 +Beispiel 2: Vorlagen löschen
1016 1016  
1017 1017  {{code language="PowerShell"}}
1018 1018  Remove-AESBMicroserviceTemplate -TemplateIds "4b016fd1-47fb-4f24-87dd-4e365fe870d3", "D1936807-E1B0-4F8B-AB7F-98ECD202CF8F"
1019 1019  {{/code}}
1020 1020  
1021 -Dieses Beispiel löscht mehrere Microservice Templates auf Basis der angegebenen Ids.
1079 +Dieses Beispiel löscht mehrere Microservice-Vorlagen auf Basis der angegebenen Ids.
1022 1022  
1023 -Beispiel 3: Templates löschen mitsamt den Referenzen
1081 +Beispiel 3: Vorlagen löschen mitsamt den Referenzen
1024 1024  
1025 1025  {{code language="PowerShell"}}
1026 1026  Remove-AESBMicroserviceTemplate -TemplateIds "4b016fd1-47fb-4f24-87dd-4e365fe870d3" -RemoveReferences
... ... @@ -1027,7 +1027,7 @@
1027 1027  
1028 1028  {{/code}}
1029 1029  
1030 -Dieses Beispiel löscht ein Microservice Template misamt den erstellten Referenzen des Templates.
1088 +Dieses Beispiel löscht eine Microservice-Vorlage mitsamt den erstellten Referenzen der Vorlage .
1031 1031  
1032 1032  === Rückgabewerte ===
1033 1033  
... ... @@ -1035,7 +1035,7 @@
1035 1035  ** StatusResult
1036 1036  *** Ergebnis des Resultats des Vorgangs
1037 1037  ** TemplateId
1038 -*** Die erfolgreich gelöschte Id des Templates
1096 +*** Die erfolgreich gelöschte Id der Vorlage
1039 1039  ** Message
1040 1040  *** Status Nachricht
1041 1041  
... ... @@ -1056,7 +1056,7 @@
1056 1056  
1057 1057  === Beispiele ===
1058 1058  
1059 -Beispiel 1: Template updaten
1117 +Beispiel 1: Vorlage updaten
1060 1060  
1061 1061  {{code language="PowerShell" layout="LINENUMBERS"}}
1062 1062  $templateConfiguration = <MicroserviceConfiguration Version="1.0.0.0" Type="Test" SessionKey="72962557bb8bbd00b53dcb53d99cea685ed636bf">
... ... @@ -1071,7 +1071,7 @@
1071 1071  Update-AESBMicroserviceTemplate -TemplateId "838fb7e2-e293-4004-9602-7223aaa3854a" -TemplateConfig $templateConfiguration
1072 1072  {{/code}}
1073 1073  
1074 -Dieses Beispiel updated das Template mit der beigefügten Konfiguration.
1132 +Dieses Beispiel updated die Vorlage mit der beigefügten Konfiguration.
1075 1075  
1076 1076  === Rückgabewerte ===
1077 1077  
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community