Changes for page Microservice Cmdlets

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

From version 17.1
edited by jklein
on 2025/07/30 13:52
Change comment: There is no comment for this version
To version 7.1
edited by jklein
on 2025/07/16 09:56
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,37 +4,28 @@
4 4  
5 5  == Add-AESBMicroservice ==
6 6  
7 -Mit diesem Cmdlet wird eine neue Microservice-Instanz auf Grundlage einer bestimmten Vorlage hinzugefügt.
7 +Mit diesem Cmdlet wird eine neue Microservice-Instanz nach der Vorlage eines Templates hinzugefügt.
8 8  
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.
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.
18 18  
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 -
27 27  === **Beispiele** ===
28 28  
29 -Beispiel 1: Microservice über Vorlagen-Name hinzufügen
20 +Beispiel 1: Microservice über Template-Name hinzufügen
30 30  
31 31  {{code language="PowerShell"}}
32 32  Add-AESBMicroservice -InstanceName "Test" -TemplateName "Tester"
33 33  {{/code}}
34 34  
35 -Dieses Beispiel fügt eine neue Instanz mithilfe des Vorlagen-Namen hinzu. Die Standardverbindung wird verwendet.
26 +Dieses Beispiel fügt eine neue Instanz mithilfe des Template-Namen hinzu. Die Standardverbindung wird verwendet.
36 36  
37 -Beispiel 2: Microservice über Vorlagen-Id hinzufügen
28 +Beispiel 2: Microservice über Template-Id hinzufügen
38 38  
39 39  {{code language="PowerShell"}}
40 40  Add-AESBMicroservice -InstanceName "Test" -TemplateId "ffffffff-ffff-ffff-ffff-ffffffffffff"
... ... @@ -42,15 +42,15 @@
42 42  {{/code}}
43 43  
44 44  (% class="wikigeneratedid" %)
45 -Dieses Beispiel fügt eine neue Instanz mithilfe der Vorlagen-Id hinzu. Die Standardverbindung wird verwendet.
36 +Dieses Beispiel fügt eine neue Instanz mithilfe der Template-Id hinzu. Die Standardverbindung wird verwendet.
46 46  
47 -Beispiel 3: Microservice-StartUpType beim Hinzufügen setzen
38 +Beispiel 3: Microservice StartUpType beim Hinzufügen setze
48 48  
49 49  {{code language="PowerShell"}}
50 50  Add-AESBMicroservice -InstanceName "Test" -TemplateId "ffffffff-ffff-ffff-ffff-ffffffffffff" -StartupType Manual
51 51  {{/code}}
52 52  
53 -Dieses Beispiel fügt eine neue Instanz mithilfe der Vorlagen-Id hinzu und setzt den //StartupType// auf //Manuell//. Die Standardverbindung wird verwendet.
44 +Dieses Beispiel fügt eine neue Instanz mithilfe der Template-Id hinzu und setzt den //StartupType// auf //Manuell//. Die Standardverbindung wird verwendet.
54 54  
55 55  Beispiel 4: Microservice mit SupervisorId setzen
56 56  
... ... @@ -59,7 +59,7 @@
59 59  
60 60  {{/code}}
61 61  
62 -Dieses Beispiel fügt eine neue Instanz einem bestimmten Supervisor hinzu, der über die Supervisor-Id angegeben wird. Die Standardverbindung wird verwendet.
53 +Dieses Beispiel fügt eine neue Instanz einen bestimmten Supervisor hinzu, der über die Supervisor-Id angegeben wird. Die Standardverbindung wird verwendet.
63 63  
64 64  Beispiel 5: Microservice mit StoppedAfterCreation setze
65 65  
... ... @@ -86,7 +86,7 @@
86 86  Mit den optionalen Parametern können Sie die Ausgabe filtern und spezifische Microservices oder Instanzen abrufen.
87 87  
88 88  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
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.
80 +|-ConnectionName|String|✅|C|Der Name der Verbindung, Informationen zu Microservice-Instanzen abgerufen werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
90 90  |-InstanceNames|String[]|✅❌| |Gibt die Namen der Microservice-Instanzen an, die abgerufen werden sollen. Du kannst einen oder mehrere Instanznamen als String-Array übergeben.
91 91  |-SupervisorIds|String[]|✅❌| |Filtert Microservices basierend auf den IDs ihrer übergeordneten Supervisoren. Du musst eine oder mehrere Supervisor-IDs als String-Array übergeben.
92 92  |-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.
... ... @@ -95,9 +95,9 @@
95 95  
96 96  Das Cmdlet verwendet Parameter-Sets, um verschiedene Möglichkeiten zur Abfrage von Microservices zu ermöglichen:
97 97  
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.
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.
101 101  
102 102  Sie können immer nur Parameter aus einem dieser Sets gleichzeitig verwenden.
103 103  
... ... @@ -170,20 +170,20 @@
170 170  
171 171  |=(% style="width: 213px;" %)Parameter |=(% style="width: 209px;" %)ParameterSetName|=Datentyp|=Optional|=Beschreibung
172 172  |-ConnectionName| |String|✅|Der Name der Verbindung, über die Microservice-Instanzen bearbeitet werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
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).
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).
180 180  
181 181  === Parameter-Sets ===
182 182  
183 183  Das Cmdlet verwendet Parameter-Sets, um zwei Hauptszenarien zu unterstützen:
184 184  
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.
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.
187 187  
188 188  Sie können immer nur Parameter aus einem dieser Sets gleichzeitig verwenden.
189 189  
... ... @@ -257,9 +257,9 @@
257 257  
258 258  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:
259 259  
260 -* **Status**: Der Status der Beendigungsoperation (z.B. //Unchanged/Changed//).
251 +* **Status**: Der Status der Beendigungsoperation (z.B. //Unchanged// wenn bereits gestoppt, //Stopped// wenn erfolgreich beendet).
261 261  * **InstanceId**: Die eindeutige ID der betroffenen Microservice-Instanz.
262 -* **InstanceState**: Der Zustand des Microservice nach der Operation (z.B. //Stopped/Already stopped//).
253 +* **InstanceState**: Der Zustand des Microservice nach der Operation (z.B. Already stopped).
263 263  * **Error**: Eine Fehlermeldung, falls die Operation nicht erfolgreich war oder ein Problem aufgetreten ist.
264 264  
265 265  == Move-AESBMicroservices ==
... ... @@ -266,12 +266,13 @@
266 266  
267 267  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.
268 268  
260 +
269 269  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
270 270  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Instanzen verschoben werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
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).
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)
275 275  
276 276  === Beispiele ===
277 277  
... ... @@ -325,13 +325,6 @@
325 325  |-InstanceNames|String[]|❌|Keine|Gibt die Namen der Microservices an, die entfernt werden sollen. Es kann ein einzelner Name oder ein Array von Namen übergeben werden. Obligatorisch für den Parameter-Satz //ByInstanceName//.
326 326  |-InstanceIds|String[]|❌|Keine|Gibt die eindeutigen Instanz-IDs (GUIDs) der Microservices an, die entfernt werden sollen. Es kann eine einzelne ID oder ein Array von IDs übergeben werden. Obligatorisch für den Parameter-Satz //ByInstanceId//.
327 327  
328 -=== Parameter-Sets ===
329 -
330 -Das Cmdlet verwendet Parameter-Sets, um verschiedene Möglichkeiten zur Abfrage von Microservices zu ermöglichen:
331 -
332 -* **InstanceNamesParameterSet**: Ermöglicht das Abrufen von Microservices, basierend auf ihren Instanz-Namen.
333 -* **InstanceIdsParameterSet**: Ermöglicht das Abrufen von Microservices, basierend auf ihren eindeutigen Instanz-IDs.
334 -
335 335  === Beispiele ===
336 336  
337 337  Beispiel 1: Einen Microservice anhand seiner Instanz-ID entfernen
... ... @@ -389,18 +389,11 @@
389 389  
390 390  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
391 391  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Instanzen neugestartet werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
377 +|-SupervisorId|String[]|❌|Keine|Gibt die Namen der Microservices an, die entfernt werden sollen. Es kann ein einzelner Name oder ein Array von Namen übergeben werden. Obligatorisch für Parametersatz ByInstanceName.
392 392  |-InstanceIds|String[]|❌|Keine|Gibt die eindeutigen Instanz-IDs (GUIDs) der Microservices an, die entfernt werden sollen. Es kann eine einzelne ID oder ein Array von IDs übergeben werden. Obligatorisch für Parametersatz ByInstanceId.
393 -|-SupervisorId|String[]|❌|Keine|Der SupervisorId-Parameter gibt die eindeutige ID (GUID als String) des Supervisors an. Alle Microservices, die von diesem spezifischen Supervisor verwaltet werden, werden neugestartet.
394 394  |-Timeout|String|✅|Keine|Gibt die maximale Wartezeit für den Neustartvorgang an (z.B. "30s", "1m"). Standardwert: "30s".
395 395  |-NoWait|SwitchParameter|✅|Keine|Wenn dieser Parameter angegeben ist, wartet das Cmdlet nicht auf den Abschluss des Neustartvorgangs, sondern kehrt sofort zurück.
396 396  
397 -=== Parameter-Sets ===
398 -
399 -Das Cmdlet verwendet Parameter-Sets, um verschiedene Möglichkeiten zur Abfrage von Microservices zu ermöglichen:
400 -
401 -* **InstanceIdsParameterSet**: Ermöglicht das Abrufen von Microservices, basierend auf ihren eindeutigen Instanz-IDs.
402 -* **SupervisorsParameterSet**: Ermöglicht das Abrufen von Microservices, die bestimmten Supervisor-IDs zugeordnet sind.
403 -
404 404  ==== **Beispiele** ====
405 405  
406 406  Beispiel 1: Einen Microservice anhand seiner Instanz-ID neu starten
... ... @@ -456,12 +456,6 @@
456 456  |-Enable|SwitchParameter|✅❌|Keine|Aktiviert das Logging für die angegebenen Microservices. Obligatorisch für Parametersatz `SwitchEnable`. Kann nicht zusammen mit `-Disable` verwendet werden.
457 457  |-Disable|SwitchParameter|✅❌|Keine|Deaktiviert das Logging für die angegebenen Microservices. Obligatorisch für Parametersatz `SwitchDisable`. Kann nicht zusammen mit `-Enable` verwendet werden.
458 458  
459 -=== Parameter-Sets ===
460 -
461 -Das Cmdlet verwendet Parameter-Sets, um verschiedene Möglichkeiten zur Abfrage von Microservices zu ermöglichen:
462 -
463 -* **InstanceIdsParameterSet**: Ermöglicht das Abrufen von Microservices, basierend auf ihren eindeutigen Instanz-IDs.
464 -
465 465  === **Beispiele** ===
466 466  
467 467  Beispiel 1: Logging für einen Microservice aktivieren
... ... @@ -503,20 +503,14 @@
503 503  
504 504  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.
505 505  
478 +
506 506  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
507 507  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Instanzen gestartet werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
508 -|-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`.
509 -|-SupervisorId|String|❌|Keine|Gibt die ID des Supervisors an, dessen zugerige Microservices gestartet werden sollen. Obligatorisch für Parametersatz `SupervisorParameterset`.
481 +|-SupervisorId|String|❌|Keine|Gibt die ID des Supervisors an, dessen zugerige 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`.
510 510  |-Timeout|String|✅|Keine|Gibt die maximale Wartezeit für den Startvorgang an (z.B. "30s", "1m"). Standardwert: "30s".
511 511  |-NoWait      |SwitchParameter|✅|Keine|Wenn dieser Parameter angegeben ist, wartet das Cmdlet nicht auf den Abschluss des Startvorgangs, sondern kehrt sofort zurück.
512 512  
513 -=== Parameter-Sets ===
514 -
515 -Das Cmdlet verwendet Parameter-Sets, um verschiedene Möglichkeiten zur Abfrage von Microservices zu ermöglichen:
516 -
517 -* **InstanceIdsParameterSet**: Ermöglicht das Abrufen von Microservices, basierend auf ihren eindeutigen Instanz-IDs.
518 -* **SupervisorsParameterSet**: Ermöglicht das Abrufen von Microservices, die bestimmten Supervisor-IDs zugeordnet sind.
519 -
520 520  === **Beispiele** ===
521 521  
522 522  Beispiel 1: Einen Microservice anhand seiner Instanz-ID starten
... ... @@ -569,18 +569,11 @@
569 569  
570 570  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
571 571  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Instanzen gestoppt werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
538 +|-SupervisorId|String|❌|Keine|Gibt die ID des Supervisors an, dessen zugehörige Microservices gestoppt werden sollen. Obligatorisch für Parametersatz `UseSupervisorIdParameterSet`.
572 572  |-InstanceIds|String[]|❌|Keine|Gibt die eindeutigen Instanz-IDs (GUIDs) der Microservices an, die gestoppt werden sollen. Es kann eine einzelne ID oder ein Array von IDs übergeben werden. Obligatorisch für Parametersatz `UseMicroservicesIdListParameterSet`.
573 -|-SupervisorId|String|❌|Keine|Gibt die ID des Supervisors an, dessen zugehörige Microservices gestoppt werden sollen. Obligatorisch für Parametersatz `SupervisorsParameterSet`.
574 574  |-Timeout|String|✅|Keine|Gibt die maximale Wartezeit für den Stoppvorgang an (z.B. "5s", "1m"). Standardwert: "5s".
575 575  |-NoWait      |SwitchParameter|✅|Keine|Wenn dieser Parameter angegeben ist, wartet das Cmdlet nicht auf den Abschluss des Stoppvorgangs, sondern kehrt sofort zurück.
576 576  
577 -=== Parameter-Sets ===
578 -
579 -Das Cmdlet verwendet Parameter-Sets, um verschiedene Möglichkeiten zur Abfrage von Microservices zu ermöglichen:
580 -
581 -* **InstanceIdsParameterSet**: Ermöglicht das Abrufen von Microservices, basierend auf ihren eindeutigen Instanz-IDs.
582 -* **SupervisorsParameterSet**: Ermöglicht das Abrufen von Microservices, die bestimmten Supervisor-IDs zugeordnet sind.
583 -
584 584  === **Beispiele** ===
585 585  
586 586  Beispiel 1: Einen Microservice anhand seiner Instanz-ID stoppen
... ... @@ -667,13 +667,13 @@
667 667  
668 668  === **Beispiele** ===
669 669  
670 -Beispiel 1: Fügt ein neue Microservice-Vorlage hinzu
629 +Beispiel 1: Fügt ein neues Microservice-Template hinzu
671 671  
672 672  {{code language="PowerShell"}}
673 673  Add-AESBMicroserviceTemplate -TemplateName "Test" -TemplateConfig $templateConfig
674 674  {{/code}}
675 675  
676 -Dieses Beispiel fügt eine neue Vorlagen-konfiguration mit dem Namen "Test" auf Basis des $templateConfig-Objekts hinzu. Die Standardverbindung wird verwendet.
635 +Dieses Beispiel fügt eine neue Templatekonfiguration mit dem Namen "Test" auf Basis des $templateConfig-Objekts hinzu. Die Standardverbindung wird verwendet.
677 677  
678 678  {{apimacro title="Beispiel der Funktion in PowerShell"}}
679 679  {{code language="PowerShell" layout="LINENUMBERS"}}
... ... @@ -693,7 +693,7 @@
693 693  {{/code}}
694 694  {{/apimacro}}
695 695  
696 -{{apimacro title="Beispiel der Vorlagen-Konfiguration"}}
655 +{{apimacro title="Beispiel der Template-Konfiguration"}}
697 697  {{code language="PowerShell" layout="LINENUMBERS"}}
698 698  $templateConfig = "<MicroserviceConfiguration Version=`"1.11.0.895`" Type=`"SnmpConnector`" SessionKey=`"bcafdb4e94f2572eed78525430ad0e0275229f98`">
699 699   <SnmpConnectorConfiguration>
... ... @@ -732,17 +732,17 @@
732 732  ** Erfolgreiche Statusmeldung
733 733  * TemplateInfo
734 734  ** TemplateId
735 -*** ID der Vorlage
694 +*** ID des Templates
736 736  ** Configuration
737 -*** Aktuelle Konfiguration der Vorlage
696 +*** Aktuelle Konfiguration des Templates
738 738  ** Name
739 -*** Name der Vorlage
698 +*** Name des Templates
740 740  ** Type
741 -*** Der Typ der Vorlage
700 +*** Der Typ des Templates
742 742  ** Version
743 -*** Die Versionierung der Vorlage
702 +*** Die Versionierung des Templates
744 744  
745 -{{apimacro title="Rückgabewerte der Vorlagen-Konfiguration"}}
704 +{{apimacro title="Rückgabewerte der Template-Konfiguration"}}
746 746  {{code language="PowerShell" layout="LINENUMBERS"}}
747 747  Successfully added template 'Test'.
748 748  
... ... @@ -772,7 +772,7 @@
772 772  
773 773  === **Beispiele** ===
774 774  
775 -Beispiel 1: Microservice-Vorlage exportieren
734 +Beispiel 1: MicroserviceTemplate exportieren
776 776  
777 777  {{code language="PowerShell"}}
778 778  Export-AESBMicroserviceTemplateConfig -TemplateConfig $templateConfig -Path $path
... ... @@ -847,13 +847,13 @@
847 847  
848 848  === Beispiele ===
849 849  
850 -Beispiel 1: Konfiguration der Microservice-Vorlage von //$templateName// anfragen
809 +Beispiel 1: MicroserviceTemplateConfig von //$templateName// anfragen
851 851  
852 852  {{code language="PowerShell"}}
853 853  Get-AESBMicroserviceTemplateConfig -TemplateName $templateName
854 854  {{/code}}
855 855  
856 -Dieses Beispiel fragt die Vorlagen-Konfiguration mit dem Namen //$templateName// an. Die Standardverbindung wird verwendet.
815 +Dieses Beispiel fragt die Templatekonfiguration mit dem Namen //$templateName// an. Die Standardverbindung wird verwendet.
857 857  
858 858  {{code language="PowerShell" layout="LINENUMBERS"}}
859 859  function Get-MicroserviceTemplateConfig {
... ... @@ -872,7 +872,7 @@
872 872  
873 873  * MicroserviceConfiguration
874 874  ** Version
875 -*** Die jeweilige Version des Microservices
834 +*** Die jeweilige Versionierung des Microservices
876 876  ** Type
877 877  *** Der Typ des Microservices
878 878  ** TypeConfiguration
... ... @@ -892,61 +892,9 @@
892 892  1.11.0.895 SnmpConnector SnmpConnectorConfiguration
893 893  {{/code}}
894 894  
895 -== Get-AESBMicroserviceTemplates ==
896 -
897 -Dieses Cmdlet fragt die vorhandenen Microservice-Vorlagen ab und listet sie auf.
898 -
899 -|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
900 -|-ConnectionName|String|✅|C|Der Name der Verbindung, über die die Microservices-Vorlagen-Konfiguration importiert werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
901 -|-PackageName|String|✅| |Der Name des Microservice-Pakets, dessen Vorlagen geholt werden sollen
902 -|-PackageVersion|String|✅| |Die Version des Pakets, dessen Vorlagen geholt werden sollen
903 -
904 -=== Beispiele ===
905 -
906 -Beispiel 1: Alle vorhandenen Microservice-Vorlagen anzeigen
907 -
908 -{{code language="PowerShell"}}
909 -Get-AESBMicroserviceTemplates
910 -{{/code}}
911 -
912 -Dieses Beispiel listet alle vorhandenen Microservice-Vorlagen auf. Die Standardverbindung wird verwendet. Falls keine Vorlagen vorhanden sind, wird ein Fehler angezeigt.
913 -
914 -Beispiel 2: Die Vorlagen eines bestimmten Microservice-Pakets einer bestimmten Version auflisten
915 -
916 -{{code language="PowerShell"}}
917 -Get-AESBMicroserviceTemplates -PackageName "SnmpConnector" -PackageVersion "1.11.0.895"
918 -
919 -{{/code}}
920 -
921 - Dieses Beispiel listet alle vorhandenen Microservice-Vorlagen des Pakets "SnmpConnector" in der Version "1.11.0.895" auf. Die Standardverbindung wird verwendet.
922 -
923 -=== Rückgabewerte ===
924 -
925 -Bei erfolgreicher Anwendung werden die gewünschten Microservice-Vorlagen als Objekte aufgelistet.
926 -
927 -* MicroserviceTemplate
928 -** Name
929 -*** Der Name der Vorlage
930 -** Id
931 -*** Die Id der Vorlage
932 -** PackageName
933 -*** Der Name des Microservice-Pakets
934 -** PackageVersion
935 -*** Die Version des Microservice-Pakets
936 -
937 -{{code language="PowerShell"}}
938 -Name Id PackageName PackageVersion
939 -
940 ----- -- ----------- --------------
941 -
942 -SnmpConnector a6e37f49-5a15-4213-96f5-e23cc03209a8 SnmpConnector 1.11.0.895
943 -
944 -PS_Microservice1 33618fc3-60f2-484b-b6c9-b9f19c5eb4fa PS_Microservice1 1.1.0.1
945 -{{/code}}
946 -
947 947  == Import-AESBMicroserviceTemplateConfig ==
948 948  
949 -Dieses Cmdlet importiert die Vorlagen-Konfiguration vom angegebenen Pfad.
856 +Dieses Cmdlet importiert die Templatekonfiguration vom angegebenen Pfad.
950 950  
951 951  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
952 952  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die die Microservices-Vorlagen-Konfiguration importiert werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet.
... ... @@ -954,7 +954,7 @@
954 954  
955 955  === Beispiele ===
956 956  
957 -Beispiel 1: Vorlagen-Konfiguration von //$path// laden
864 +Beispiel 1: Templatekonfiguration von //$path// laden
958 958  
959 959  {{code language="PowerShell"}}
960 960  Import-AESBMicroserviceTemplateConfig -Path $path
... ... @@ -961,7 +961,7 @@
961 961  
962 962  {{/code}}
963 963  
964 -Dieses Beispiel importiert die Vorlagen-Konfiguration beim hinterlegten Pfad. Die Standardverbindung wird verwendet.
871 +Dieses Beispiel importiert die Templatekonfiguration beim hinterlegten Pfad. Die Standardverbindung wird verwendet.
965 965  
966 966  === Rückgabewerte ===
967 967  
... ... @@ -969,7 +969,7 @@
969 969  
970 970  * MicroserviceConfiguration
971 971  ** Version
972 -*** Die jeweilige Version des Microservices
879 +*** Die jeweilige Versionierung des Microservices
973 973  ** Type
974 974  *** Der Typ des Microservices
975 975  ** TypeConfiguration
... ... @@ -1001,7 +1001,7 @@
1001 1001  
1002 1002  === Beispiele ===
1003 1003  
1004 -Beispiel 1: Mehrere Vorlagen auf Version //$templateVersion// migrieren
911 +Beispiel 1: Mehrere Templates auf Version //$templateVersion// migrieren
1005 1005  
1006 1006  {{code language="PowerShell"}}
1007 1007  Migrate-AESBMicroserviceTemplates -TemplateNames $templateNames -TargetVersion $templateVersion
... ... @@ -1008,23 +1008,23 @@
1008 1008  
1009 1009  {{/code}}
1010 1010  
1011 -Dieses Beispiel migriert alle Vorlagen, die in //$templateNames// stehen, auf die Version //$templateVersion//.
918 +Dieses Beispiel migriert alle Templates die in //$templateNames// stehen auf die Version //$templateVersion//.
1012 1012  
1013 1013  === Rückgabewerte ===
1014 1014  
1015 -Bei erfolgreicher Anwendung erhalten Sie eine Liste von Vorlagen-Informationen mit den neuen Daten der erfolgreich migrierten Vorlagen:
922 +Bei erfolgreicher Anwendung erhalten Sie eine Liste von Template-Informationen mit den neuen Daten der erfolgreich migrierten Templates:
1016 1016  
1017 1017  * TemplateInfo
1018 1018  ** TemplateId
1019 -*** Die neu erstellte / gleichbleibende Id der Vorlage
926 +*** Die neu erstellte / gleichbleibende Id des Templates
1020 1020  ** Configuration
1021 -*** Die aktuelle Konfiguration der Vorlage
928 +*** Die aktuelle Konfiguration des Templates
1022 1022  ** Name
1023 -*** Der neue Name der Vorlage
930 +*** Der neue Name des Template
1024 1024  ** Type
1025 -*** Der Typ der Vorlage
932 +*** Der Typ des Templates
1026 1026  ** Version
1027 -*** Die neue Version der Vorlage
934 +*** Die neue Version des Templates
1028 1028  
1029 1029  {{code language="PowerShell"}}
1030 1030  TemplateId : ffffffff-ffff-ffff-ffff-ffffffffffff"
... ... @@ -1058,17 +1058,17 @@
1058 1058  New-AESBMicroserviceTemplateConfig -PackageName $packageName -PackageVersion $packageVersion
1059 1059  {{/code}}
1060 1060  
1061 -Dieses Beispiel erstellt eine Vorlagen-Konfiguration auf Basis des angegebenen Microservice-Pakets.
968 +Dieses Beispiel erstellt eine Template-Konfiguration auf Basis des angegebenen Microservicepackage.
1062 1062  
1063 1063  === Rückgabewerte ===
1064 1064  
1065 1065  * MicroserviceConfiguration
1066 1066  ** Version
1067 -*** Die neue Version der Vorlage
974 +*** Die neue Version des Templates
1068 1068  ** Type
1069 -*** Der Typ der Vorlage
976 +*** Der Typ des Templates
1070 1070  ** Configuration
1071 -*** Die aktuelle Konfiguration der Vorlage
978 +*** Die aktuelle Konfiguration des Templates
1072 1072  
1073 1073  {{code language="PowerShell" layout="LINENUMBERS"}}
1074 1074  $microserviceTemplateConfig = New-AESBMicroserviceTemplateConfig -PackageName $packageName -PackageVersion $packageVersion
... ... @@ -1088,6 +1088,7 @@
1088 1088  
1089 1089  Mit diesem Cmdlet können Sie Microservice-Vorlagen löschen.
1090 1090  
998 +
1091 1091  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
1092 1092  |-ConnectionName|String|✅|C|Der Name der Verbindung, über die die Microservice-Vorlagen gelöscht werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
1093 1093  |-TemplateIds|String[]|❌|Keine|Die ID's der Vorlagen, die zu löschen sind.
... ... @@ -1095,7 +1095,7 @@
1095 1095  
1096 1096  === Beispiele ===
1097 1097  
1098 -Beispiel 1: Vorlage löschen
1006 +Beispiel 1: Template löschen
1099 1099  
1100 1100  {{code language="PowerShell"}}
1101 1101  Remove-AESBMicroserviceTemplate -TemplateIds 4b016fd1-47fb-4f24-87dd-4e365fe870d3
... ... @@ -1102,17 +1102,17 @@
1102 1102  
1103 1103  {{/code}}
1104 1104  
1105 -Dieses Beispiel löscht eine Microservice-Vorlage auf Basis der angegebenen Id.
1013 +Dieses Beispiel löscht ein Microservice Template auf Basis der angegebenen Id.
1106 1106  
1107 -Beispiel 2: Vorlagen löschen
1015 +Beispiel 2: Templates löschen
1108 1108  
1109 1109  {{code language="PowerShell"}}
1110 1110  Remove-AESBMicroserviceTemplate -TemplateIds "4b016fd1-47fb-4f24-87dd-4e365fe870d3", "D1936807-E1B0-4F8B-AB7F-98ECD202CF8F"
1111 1111  {{/code}}
1112 1112  
1113 -Dieses Beispiel löscht mehrere Microservice-Vorlagen auf Basis der angegebenen Ids.
1021 +Dieses Beispiel löscht mehrere Microservice Templates auf Basis der angegebenen Ids.
1114 1114  
1115 -Beispiel 3: Vorlagen löschen mitsamt den Referenzen
1023 +Beispiel 3: Templates löschen mitsamt den Referenzen
1116 1116  
1117 1117  {{code language="PowerShell"}}
1118 1118  Remove-AESBMicroserviceTemplate -TemplateIds "4b016fd1-47fb-4f24-87dd-4e365fe870d3" -RemoveReferences
... ... @@ -1119,7 +1119,7 @@
1119 1119  
1120 1120  {{/code}}
1121 1121  
1122 -Dieses Beispiel löscht eine Microservice-Vorlage mitsamt den erstellten Referenzen der Vorlage .
1030 +Dieses Beispiel löscht ein Microservice Template misamt den erstellten Referenzen des Templates.
1123 1123  
1124 1124  === Rückgabewerte ===
1125 1125  
... ... @@ -1127,7 +1127,7 @@
1127 1127  ** StatusResult
1128 1128  *** Ergebnis des Resultats des Vorgangs
1129 1129  ** TemplateId
1130 -*** Die erfolgreich gelöschte Id der Vorlage
1038 +*** Die erfolgreich gelöschte Id des Templates
1131 1131  ** Message
1132 1132  *** Status Nachricht
1133 1133  
... ... @@ -1148,7 +1148,7 @@
1148 1148  
1149 1149  === Beispiele ===
1150 1150  
1151 -Beispiel 1: Vorlage updaten
1059 +Beispiel 1: Template updaten
1152 1152  
1153 1153  {{code language="PowerShell" layout="LINENUMBERS"}}
1154 1154  $templateConfiguration = <MicroserviceConfiguration Version="1.0.0.0" Type="Test" SessionKey="72962557bb8bbd00b53dcb53d99cea685ed636bf">
... ... @@ -1163,7 +1163,7 @@
1163 1163  Update-AESBMicroserviceTemplate -TemplateId "838fb7e2-e293-4004-9602-7223aaa3854a" -TemplateConfig $templateConfiguration
1164 1164  {{/code}}
1165 1165  
1166 -Dieses Beispiel updated die Vorlage mit der beigefügten Konfiguration.
1074 +Dieses Beispiel updated das Template mit der beigefügten Konfiguration.
1167 1167  
1168 1168  === Rückgabewerte ===
1169 1169  
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community