Changes for page Microservice Cmdlets
Last modified by jklein on 2025/08/15 09:48
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -4,37 +4,29 @@ 4 4 5 5 == Add-AESBMicroservice == 6 6 7 -Mit diesem Cmdlet wird eine neue Microservice-Instanz a ufGrundlage einerbestimmten Vorlage hinzugefügt.7 +Mit diesem Cmdlet wird eine neue Microservice-Instanz nach der Vorlage eines Templates hinzugefügt. 8 8 9 9 (% style="width:902px" %) 10 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 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 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. 13 +|-TemplateName|(% style="width:154px" %)UseTemplateName|(% style="width:156px" %)String|(% style="width:55px" %)❌|(% style="width:76px" %)Keine|(% style="width:206px" %)Der Name des Templates 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 des Templates für die Vorlage der Instanz. 15 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 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 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. 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ügen21 +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.27 +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ügen29 +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.37 +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 setzen39 +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.45 +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 eine mbestimmten Supervisor hinzu, der über die Supervisor-Id angegeben wird. Die Standardverbindung wird verwendet.54 +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 ... ... @@ -78,7 +78,7 @@ 78 78 79 79 Dieses Beispiel fügt eine neue Instanz zu einem angegebenen Supervisor hinzu, setzt den //StartupType// auf //Manuell und //den Wert von //StoppedAfterCreation// auf //false//. Die Standardverbindung wird verwendet 80 80 81 - ==(% style="color:inherit; font-family:inherit; font-size:25px; font-weight:bold" %)**Get-AESBMicroservices**(%%) ==73 +(% style="color:inherit; font-family:inherit; font-size:25px; font-weight:bold" %)**Get-AESBMicroservice** 82 82 83 83 Mit diesem Cmdlet erhalten Sie eine Liste mit allen installierten und registrierten Microservices des AESB. In dieser Liste finden Sie detaillierte Informationen zu jedem Microservice, einschließlich seines Namens, des zugehörigen Pakets, der Version, des aktuellen Zustands und der Ressourcennutzung. 84 84 Diese Informationen sind nützlich für die Überwachung, Fehlerbehebung und Verwaltung der Microservice-Infrastruktur. ... ... @@ -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 dieInformationen zu Microservice-Instanzen abgerufen werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.81 +|-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. 90 +* **InstanceNamesParameterSetName**: Ermöglicht das Abrufen von Microservices, basierend auf ihren Instanznamen. 91 +* **SupervisorsParameterSetName**: Ermöglicht das Abrufen von Microservices, die bestimmten Supervisor-IDs zugeordnet sind. 92 +* **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 sichder 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).165 +|-InstanceName|NoCredentialParameterSetName, 166 +CredentialParameterSetName|String|❌|Gibt den eindeutigen Namen der Microservice-Instanz an, deren Konfiguration geändert werden soll. Dieser Parameter ist in beiden Parametersets obligatorisch. 167 +|-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. 168 +|-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. 169 +|-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. 170 +|-StartupType|NoCredentialParameterSetName, 171 +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. 177 +* **NoCredentialParameterSetName**: Ermöglicht die Bearbeitung des Starttyps ohne die Angabe von Anmeldeinformationen. 178 +* **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,21 +257,22 @@ 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//).252 +* **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//).254 +* **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 -== Move-AESBMicroservice == 257 +== Move-AESBMicroservices == 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 261 + 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 desZiel-Supervisors, auf dendie 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) .264 +|-InstanceIds|String[]|❌| |Die IDs der zu verschiebenden Microservice-Instanzen (Pflichtfeld, unterstützt mehrere Werte) 265 +|-SupervisorId|String|❌| |Die Ziel-SupervisorId, auf die die Instanzen verschoben werden sollen 266 +|-Timeout|String|✅| |Optionales Timeout für die Operation (Standard: "30s") 267 +|-NoWait|SwitchParameter|✅| |Gibt an, ob das Cmdlet auf den Abschluss der Operation warten soll (asynchron) 275 275 276 276 === Beispiele === 277 277 ... ... @@ -325,19 +325,12 @@ 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 338 338 339 339 {{code language="PowerShell"}} 340 -Remove-AESBMicroservice s-InstanceIds "aaaaaaaa-ffff-ffff-ffff-fffffffffff1"326 +Remove-AESBMicroservice -InstanceIds "aaaaaaaa-ffff-ffff-ffff-fffffffffff1" 341 341 {{/code}} 342 342 343 343 Dieser Befehl entfernt den Microservice mit der Instanz-ID "b6cb7044-b6b2-4a64-9997-29f0ea5283db". Die Ausgabe zeigt die Instanz und das Ergebnis "Success". ... ... @@ -345,7 +345,7 @@ 345 345 Beispiel 2: Mehrere Microservices anhand ihrer Instanz-IDs entfernen 346 346 347 347 {{code language="PowerShell"}} 348 -Remove-AESBMicroservice s-InstanceIds "aaaaaaaa-ffff-ffff-ffff-fffffffffff1"334 +Remove-AESBMicroservice -InstanceIds "aaaaaaaa-ffff-ffff-ffff-fffffffffff1" 349 349 {{/code}} 350 350 351 351 Dieser Befehl entfernt zwei Microservices, die durch ihre jeweiligen Instanz-IDs identifiziert werden. ... ... @@ -353,7 +353,7 @@ 353 353 Beispiel 3: Einen Microservice anhand seines Namens entfernen 354 354 355 355 {{code language="PowerShell"}} 356 -Remove-AESBMicroservice s-InstanceNames "MeinService"342 +Remove-AESBMicroservice -InstanceNames "MeinService" 357 357 358 358 {{/code}} 359 359 ... ... @@ -362,7 +362,7 @@ 362 362 Beispiel 4: Mehrere Microservices anhand ihrer Namen entfernen und Bestätigung anfordern 363 363 364 364 {{code language="PowerShell"}} 365 -Remove-AESBMicroservice s-InstanceNames "Service1", "Service2" -Confirm351 +Remove-AESBMicroservice -InstanceNames "Service1", "Service2" -Confirm 366 366 {{/code}} 367 367 368 368 Dieser Befehl versucht, die Microservices "Service1" und "Service2" zu entfernen. Vor dem eigentlichen Entfernen wird der Benutzer um Bestätigung gebeten. ... ... @@ -370,11 +370,11 @@ 370 370 Beispiel 5: Microservices über die Pipeline anhand von Instanz-IDs entfernen 371 371 372 372 {{code language="PowerShell"}} 373 -"aaaaaaaa-ffff-ffff-ffff-fffffffffff1", "aaaaaaaa-ffff-ffff-ffff-fffffffffff2" | Remove-AESBMicroservice s-InstanceIds359 +"aaaaaaaa-ffff-ffff-ffff-fffffffffff1", "aaaaaaaa-ffff-ffff-ffff-fffffffffff2" | Remove-AESBMicroservice -InstanceIds 374 374 375 375 {{/code}} 376 376 377 -Dieser Befehl übergibt zwei Instanz-IDs über die Pipeline an `Remove-Microservice s`, um die entsprechenden Microservices zu entfernen.363 +Dieser Befehl übergibt zwei Instanz-IDs über die Pipeline an `Remove-Microservice`, um die entsprechenden Microservices zu entfernen. 378 378 379 379 === Rückgabewerte === 380 380 ... ... @@ -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. 378 +|-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 479 + 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 dieeindeutigen Instanz-IDs(GUIDs)der Microservicesan, diegestartet werden sollen.Es kann eine einzelne ID oder ein Array von IDs übergeben werden.Obligatorisch für Parametersatz `InstanceIdsParameterset`.509 -|- SupervisorId|String|❌|Keine|Gibt dieIDdes Supervisorsan,dessenzugehörigeMicroservices gestartet werden sollen. Obligatorisch für Parametersatz `SupervisorParameterset`.482 +|-SupervisorId|String|❌|Keine|Gibt die ID des Supervisors an, dessen zugehörige Microservices gestartet werden sollen. Obligatorisch für Parametersatz `SupervisorParametersetName`. 483 +|-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. 539 +|-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 hinzu630 +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.636 +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"}}656 +{{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 de rVorlage695 +*** ID des Templates 736 736 ** Configuration 737 -*** Aktuelle Konfiguration de rVorlage697 +*** Aktuelle Konfiguration des Templates 738 738 ** Name 739 -*** Name de rVorlage699 +*** Name des Templates 740 740 ** Type 741 -*** Der Typ de rVorlage701 +*** Der Typ des Templates 742 742 ** Version 743 -*** Die Versionierung de rVorlage703 +*** Die Versionierung des Templates 744 744 745 -{{apimacro title="Rückgabewerte der Vorlagen-Konfiguration"}}705 +{{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 exportieren735 +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 derMicroservice-Vorlage von //$templateName// anfragen810 +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.816 +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 835 +*** Die jeweilige Versionierung des Microservices 876 876 ** Type 877 877 *** Der Typ des Microservices 878 878 ** TypeConfiguration ... ... @@ -926,9 +926,9 @@ 926 926 927 927 * MicroserviceTemplate 928 928 ** Name 929 -*** Der Name de rVorlage889 +*** Der Name des Templates 930 930 ** Id 931 -*** Die Id de rVorlage891 +*** Die Id des Templates 932 932 ** PackageName 933 933 *** Der Name des Microservice-Pakets 934 934 ** PackageVersion ... ... @@ -946,7 +946,7 @@ 946 946 947 947 == Import-AESBMicroserviceTemplateConfig == 948 948 949 -Dieses Cmdlet importiert die Vorlagen-Konfiguration vom angegebenen Pfad.909 +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// laden917 +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.924 +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 932 +*** 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 Vorlagenauf Version //$templateVersion// migrieren964 +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//.971 +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 migriertenVorlagen:975 +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 de rVorlage979 +*** Die neu erstellte / gleichbleibende Id des Templates 1020 1020 ** Configuration 1021 -*** Die aktuelle Konfiguration de rVorlage981 +*** Die aktuelle Konfiguration des Templates 1022 1022 ** Name 1023 -*** Der neue Name de rVorlage983 +*** Der neue Name des Template 1024 1024 ** Type 1025 -*** Der Typ de rVorlage985 +*** Der Typ des Templates 1026 1026 ** Version 1027 -*** Die neue Version de rVorlage987 +*** 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.1021 +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 de rVorlage1027 +*** Die neue Version des Templates 1068 1068 ** Type 1069 -*** Der Typ de rVorlage1029 +*** Der Typ des Templates 1070 1070 ** Configuration 1071 -*** Die aktuelle Konfiguration de rVorlage1031 +*** 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 1051 + 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öschen1059 +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 ein eMicroservice-Vorlage auf Basis der angegebenen Id.1066 +Dieses Beispiel löscht ein Microservice Template auf Basis der angegebenen Id. 1106 1106 1107 -Beispiel 2: Vorlagenlöschen1068 +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 -Vorlagenauf Basis der angegebenen Ids.1074 +Dieses Beispiel löscht mehrere Microservice Templates auf Basis der angegebenen Ids. 1114 1114 1115 -Beispiel 3: Vorlagenlöschen mitsamt den Referenzen1076 +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 ein eMicroservice-Vorlage mitsamt den erstellten Referenzen derVorlage.1083 +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 de r Vorlage1091 +*** 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 updaten1112 +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 d ieVorlage mit der beigefügten Konfiguration.1127 +Dieses Beispiel updated das Template mit der beigefügten Konfiguration. 1167 1167 1168 1168 === Rückgabewerte === 1169 1169

