Changes for page Microservice Cmdlets

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

From version 2.4
edited by jklein
on 2025/06/20 09:25
Change comment: There is no comment for this version
To version 2.6
edited by jklein
on 2025/06/20 09:46
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -180,7 +180,7 @@
180 180  
181 181  === Beispiele ===
182 182  
183 -Beispiel 1: Starttyp eines Microservice auf "Automatisch" änder
183 +Beispiel 1: Starttyp eines Microservice auf "Automatisch" ändern
184 184  
185 185  {{code language="PowerShell"}}
186 186  Edit-AESBMicroservice -InstanceName "TestMicroservice1" -StartupType Automatic
... ... @@ -189,7 +189,7 @@
189 189  
190 190  Dieser Befehl ändert den Starttyp des Microservice mit dem Namen "TestMicroservice" auf "Automatisch". Hier wird das //NoCredentialParameterSetName// verwendet.
191 191  
192 -Beispiel 2: Starttyp ändern und individuelle Anmeldeinformationen festlege
192 +Beispiel 2: Starttyp ändern und individuelle Anmeldeinformationen festlegen
193 193  
194 194  {{code language="PowerShell" layout="LINENUMBERS"}}
195 195  $password = ConvertTo-SecureString "YourSecurePassword" -AsPlainText -Force
... ... @@ -200,12 +200,63 @@
200 200  
201 201  == Kill-AESBMicroservices ==
202 202  
203 -Mit diesem Cmdlet können Sie laufende Microservices gezielt beenden.
204 -Dies ist nützlich für die Wartung, Fehlerbehebung oder das Herunterfahren bestimmter Microservice-Instanzen.
205 -Das Cmdlet bietet zwei Methoden zum Ansprechen der zu beendenden Microservices: entweder direkt über deren Instanz-IDs oder indirekt über die ID ihres Supervisoren, wodurch alle zugehörigen Microservices beendet werden.
203 +Mit diesem Cmdlet können Sie laufende Microservices gezielt beenden. Dies ist nützlich für die Wartung, Fehlerbehebung oder das Herunterfahren bestimmter Microservice-Instanzen. Das Cmdlet bietet zwei Methoden zum Ansprechen der zu beendenden Microservices: entweder direkt über deren Instanz-IDs oder indirekt über die ID ihres Supervisoren, wodurch alle zugehörigen Microservices beendet werden.
206 206  
205 +|=(% style="width: 213px;" %)Parameter |=(% style="width: 209px;" %)ParameterSetName|=Datentyp|=Optional|=Beschreibung
206 +|-ConnectionName| |String|✅|Der Name der Verbindung, über welche die Ausführung von Microservice-Instanzen abgebrochen werden soll. Wird die Standardverbindung verwendet, wenn nicht angegeben.
207 +|-InstanceIds|UseMicroservicesIdListParameterSet|String[]|✅❌|Gibt eine Liste von eindeutigen Instanz-IDs (GUIDs als String) der Microservices an, die beendet werden sollen.
208 +|-SupervisorId|UseSupervisorIdParameterSet|String|✅❌|Der **SupervisorId**-Parameter gibt die eindeutige ID (GUID als String) des Supervisors an. Alle Microservices, die von diesem spezifischen Supervisor verwaltet werden, werden beendet.
209 +
210 +=== Parameter-Sets ===
211 +
212 +Das Cmdlet verwendet Parameter-Sets, um diese beiden Betriebsmodi zu unterscheiden:
213 +
214 +* **UseMicroservicesIdListParameterSet**: Ermöglicht das Ansprechen von Microservices über eine Liste ihrer eindeutigen Instanz-IDs.
215 +* **UseSupervisorIdParameterSet**: Ermöglicht das Ansprechen von Microservices durch Angabe der ID ihres Supervisoren. Alle Microservices, die diesem Supervisor zugeordnet sind, werden beendet.
216 +
217 +Sie können immer nur Parameter aus einem dieser Sets gleichzeitig verwenden.
218 +
219 +=== Beispiele ===
220 +
221 +Beispiel 1: Einen spezifischen Microservice mit seiner Instanz-ID beenden
222 +
223 +{{code language="PowerShell"}}
224 +Kill-AESBMicroservices -InstanceIds "ffffffff-ffff-ffff-ffff-ffffffffffff"
225 +
226 +{{/code}}
227 +
228 +Dieser Befehl versucht, den Microservice mit der angegebenen Instanz-ID zu beenden. Die Beispielausgabe zeigt, dass der Microservice bereits gestoppt war. Hier wird das //UseMicroservicesIdListParameterSet// verwendet.
229 +
230 +Beispiel 2: Mehrere Microservices mit ihren Instanz-IDs beenden
231 +
232 +{{code language="PowerShell"}}
233 +Kill-AESBMicroservices -InstanceIds "ffffffff-ffff-ffff-ffff-fffffffffff1", "ffffffff-ffff-ffff-ffff-fffffffffff2"
234 +
235 +{{/code}}
236 +
237 +Dieser Befehl versucht, die Microservices mit den angegebenen Instanz-IDs zu beenden.
238 +
239 +Beispiel 3: Alle Microservices beenden, die einem bestimmten Supervisor zugeordnet sin
240 +
241 +{{code language="PowerShell"}}
242 +Kill-AESBMicroservices -SupervisorId "ffffffff-ffff-ffff-ffff-ffffffffffff"
243 +{{/code}}
244 +
245 +Dieser Befehl beendet alle Microservices, die dem Supervisor mit der angegebenen ID zugeordnet sind. Hier wird das //UseSupervisorIdParameterSet// verwendet.
246 +
247 +=== Rückgabewerte ===
248 +
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 +
251 +* **Status**: Der Status der Beendigungsoperation (z.B. //Unchanged// wenn bereits gestoppt, //Stopped// wenn erfolgreich beendet).
252 +* **InstanceId**: Die eindeutige ID der betroffenen Microservice-Instanz.
253 +* **InstanceState**: Der Zustand des Microservice nach der Operation (z.B. Already stopped).
254 +* **Error**: Eine Fehlermeldung, falls die Operation nicht erfolgreich war oder ein Problem aufgetreten ist.
255 +
207 207  == Move-AESBMicroservices ==
208 208  
258 +
259 +
209 209  == Remove-AESBMicroservices ==
210 210  
211 211  == Restart-AESBMicroservices ==
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community