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,28 +4,37 @@ 4 4 5 5 == Add-AESBMicroservice == 6 6 7 -Mit diesem Cmdlet wird eine neue Microservice-Instanz nachderVorlage einesTemplateshinzugefü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ügen29 +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ügen37 +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 setze47 +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 eine nbestimmten 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 -* **InstanceNamesParameterSet Name**: Ermöglicht das Abrufen von Microservices, basierend auf ihren Instanznamen.90 -* **SupervisorsParameterSet Name**: Ermöglicht das Abrufen von Microservices, die bestimmten Supervisor-IDs zugeordnet sind.91 -* **NotRequiredParameterSet Name**: 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|NoCredentialParameterSet Name,165 -CredentialParameterSet Name|String|❌|Gibt den eindeutigen Namen der Microservice-Instanz an, deren Konfiguration geändert werden soll. Dieser Parameter ist in beiden Parametersets obligatorisch.166 -|-UseCredentials|CredentialParameterSet Name|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|CredentialParameterSet Name|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|CredentialParameterSet Name|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|NoCredentialParameterSet Name,170 -CredentialParameterSet Name|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 -* **NoCredentialParameterSet Name**: Ermöglicht die Bearbeitung des Starttyps ohne die Angabe von Anmeldeinformationen.177 -* **CredentialParameterSet Name**: 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 bereitsgestoppt, //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-Supervisor Id, auf die die Instanzen verschoben werden sollen265 -|-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 ... ... @@ -317,6 +317,13 @@ 317 317 |-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//. 318 318 |-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//. 319 319 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 + 320 320 === Beispiele === 321 321 322 322 Beispiel 1: Einen Microservice anhand seiner Instanz-ID entfernen ... ... @@ -374,11 +374,18 @@ 374 374 375 375 |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung 376 376 |-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. 378 378 |-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. 379 379 |-Timeout|String|✅|Keine|Gibt die maximale Wartezeit für den Neustartvorgang an (z.B. "30s", "1m"). Standardwert: "30s". 380 380 |-NoWait|SwitchParameter|✅|Keine|Wenn dieser Parameter angegeben ist, wartet das Cmdlet nicht auf den Abschluss des Neustartvorgangs, sondern kehrt sofort zurück. 381 381 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 + 382 382 ==== **Beispiele** ==== 383 383 384 384 Beispiel 1: Einen Microservice anhand seiner Instanz-ID neu starten ... ... @@ -434,6 +434,12 @@ 434 434 |-Enable|SwitchParameter|✅❌|Keine|Aktiviert das Logging für die angegebenen Microservices. Obligatorisch für Parametersatz `SwitchEnable`. Kann nicht zusammen mit `-Disable` verwendet werden. 435 435 |-Disable|SwitchParameter|✅❌|Keine|Deaktiviert das Logging für die angegebenen Microservices. Obligatorisch für Parametersatz `SwitchDisable`. Kann nicht zusammen mit `-Enable` verwendet werden. 436 436 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 + 437 437 === **Beispiele** === 438 438 439 439 Beispiel 1: Logging für einen Microservice aktivieren ... ... @@ -475,14 +475,20 @@ 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 dieIDdes Supervisorsan,dessenzugehörigeMicroservices gestartet werden sollen. Obligatorisch für Parametersatz `SupervisorParametersetName`.482 -|- 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 `InstanceIdsParametersetName`.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 zugehörige Microservices gestartet werden sollen. Obligatorisch für Parametersatz `SupervisorParameterset`. 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 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 + 486 486 === **Beispiele** === 487 487 488 488 Beispiel 1: Einen Microservice anhand seiner Instanz-ID starten ... ... @@ -626,13 +626,13 @@ 626 626 627 627 === **Beispiele** === 628 628 629 -Beispiel 1: Fügt ein neue sMicroservice-Template hinzu663 +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.669 +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"}}689 +{{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 de sTemplates728 +*** ID der Vorlage 695 695 ** Configuration 696 -*** Aktuelle Konfiguration de sTemplates730 +*** Aktuelle Konfiguration der Vorlage 697 697 ** Name 698 -*** Name de sTemplates732 +*** Name der Vorlage 699 699 ** Type 700 -*** Der Typ de sTemplates734 +*** Der Typ der Vorlage 701 701 ** Version 702 -*** Die Versionierung de sTemplates736 +*** Die Versionierung der Vorlage 703 703 704 -{{apimacro title="Rückgabewerte der Template-Konfiguration"}}738 +{{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: Microservice Template exportieren768 +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: Microservice TemplateConfig von //$templateName// anfragen843 +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.849 +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 Version ierungdes Microservices868 +*** 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 888 +== Get-AESBMicroserviceTemplates == 889 + 890 +Dieses Cmdlet fragt die vorhandenen Microservice-Vorlagen ab und listet sie auf. 891 + 892 +|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung 893 +|-ConnectionName|String|✅|C|Der Name der Verbindung, über die die Microservices-Vorlagen-Konfiguration importiert werden soll. Wenn nicht angegeben, wird die Standardverbindung verwendet. 894 +|-PackageName|String|✅| |Der Name des Microservice-Pakets, dessen Vorlagen geholt werden sollen 895 +|-PackageVersion|String|✅| |Die Version des Pakets, dessen Vorlagen geholt werden sollen 896 + 897 +=== Beispiele === 898 + 899 +Beispiel 1: Alle vorhandenen Microservice-Vorlagen anzeigen 900 + 901 +{{code language="PowerShell"}} 902 +Get-AESBMicroserviceTemplates 903 +{{/code}} 904 + 905 +Dieses Beispiel listet alle vorhandenen Microservice-Vorlagen auf. Die Standardverbindung wird verwendet. Falls keine Vorlagen vorhanden sind, wird ein Fehler angezeigt. 906 + 907 +Beispiel 2: Die Vorlagen eines bestimmten Microservice-Pakets einer bestimmten Version auflisten 908 + 909 +{{code language="PowerShell"}} 910 +Get-AESBMicroserviceTemplates -PackageName "SnmpConnector" -PackageVersion "1.11.0.895" 911 + 912 +{{/code}} 913 + 914 + Dieses Beispiel listet alle vorhandenen Microservice-Vorlagen des Pakets "SnmpConnector" in der Version "1.11.0.895" auf. Die Standardverbindung wird verwendet. 915 + 916 +=== Rückgabewerte === 917 + 918 +Bei erfolgreicher Anwendung werden die gewünschten Microservice-Vorlagen als Objekte aufgelistet. 919 + 920 +* MicroserviceTemplate 921 +** Name 922 +*** Der Name der Vorlage 923 +** Id 924 +*** Die Id der Vorlage 925 +** PackageName 926 +*** Der Name des Microservice-Pakets 927 +** PackageVersion 928 +*** Die Version des Microservice-Pakets 929 + 930 +{{code language="PowerShell"}} 931 +Name Id PackageName PackageVersion 932 + 933 +---- -- ----------- -------------- 934 + 935 +SnmpConnector a6e37f49-5a15-4213-96f5-e23cc03209a8 SnmpConnector 1.11.0.895 936 + 937 +PS_Microservice1 33618fc3-60f2-484b-b6c9-b9f19c5eb4fa PS_Microservice1 1.1.0.1 938 +{{/code}} 939 + 854 854 == Import-AESBMicroserviceTemplateConfig == 855 855 856 -Dieses Cmdlet importiert die Templatekonfiguration vom angegebenen Pfad.942 +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// laden950 +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.957 +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 Version ierungdes Microservices965 +*** 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 Templatesauf Version //$templateVersion// migrieren997 +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 Templatesdie in //$templateNames// stehen auf die Version //$templateVersion//.1004 +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 migriertenTemplates:1008 +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 de sTemplates1012 +*** Die neu erstellte / gleichbleibende Id der Vorlage 927 927 ** Configuration 928 -*** Die aktuelle Konfiguration de sTemplates1014 +*** Die aktuelle Konfiguration der Vorlage 929 929 ** Name 930 -*** Der neue Name de sTemplate1016 +*** Der neue Name der Vorlage 931 931 ** Type 932 -*** Der Typ de sTemplates1018 +*** Der Typ der Vorlage 933 933 ** Version 934 -*** Die neue Version de sTemplates1020 +*** 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.1054 +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 de sTemplates1060 +*** Die neue Version der Vorlage 975 975 ** Type 976 -*** Der Typ de sTemplates1062 +*** Der Typ der Vorlage 977 977 ** Configuration 978 -*** Die aktuelle Konfiguration de sTemplates1064 +*** 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öschen1091 +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.1098 +Dieses Beispiel löscht eine Microservice-Vorlage auf Basis der angegebenen Id. 1014 1014 1015 -Beispiel 2: Templateslöschen1100 +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 Templatesauf Basis der angegebenen Ids.1106 +Dieses Beispiel löscht mehrere Microservice-Vorlagen auf Basis der angegebenen Ids. 1022 1022 1023 -Beispiel 3: Templateslöschen mitsamt den Referenzen1108 +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 desTemplates.1115 +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 de s Templates1123 +*** 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 updaten1144 +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 d as Template mit der beigefügten Konfiguration.1159 +Dieses Beispiel updated die Vorlage mit der beigefügten Konfiguration. 1075 1075 1076 1076 === Rückgabewerte === 1077 1077

