Änderungen von Dokument Microservice Cmdlets

Zuletzt geändert von jklein am 2025/08/15 09:48

Von Version 2.6
bearbeitet von jklein
am 2025/06/20 09:46
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 2.7
bearbeitet von jklein
am 2025/06/20 10:14
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -255,10 +255,119 @@
255 255  
256 256  == Move-AESBMicroservices ==
257 257  
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.
258 258  
259 259  
261 +|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
262 +|-ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Instanzen verschoben werden sollen. Wird die Standardverbindung verwendet, wenn nicht angegeben.
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)
267 +
268 +=== Beispiele ===
269 +
270 +Beispiel 1: Einen Microservice zu einem neuen Supervisor verschieben
271 +
272 +{{code language="PowerShell"}}
273 +Move-AESBMicroservice -InstanceIds "aaaaaaaa-ffff-ffff-ffff-ffffffffffff" -SupervisorId "ffffffff-ffff-ffff-ffff-aaaaaaaa"
274 +{{/code}}
275 +
276 +Dieser Befehl verschiebt den Microservice mit der Instanz-ID "aaaaaaaa-ffff-ffff-ffff-ffffffffffff" zu dem Supervisor mit der ID "ffffffff-ffff-ffff-ffff-aaaaaaaa".
277 +
278 +Das Cmdlet wartet, bis der Vorgang abgeschlossen ist (Standard-Timeout von 30 Sekunden).
279 +
280 +Beispiel 2: Mehrere Microservices zu einem neuen Supervisor verschieben und nicht auf Abschluss warten.
281 +
282 +{{code language="PowerShell"}}
283 +Move-AESBMicroservice -InstanceIds "aaaaaaaa-ffff-ffff-ffff-fffffffffff1", "aaaaaaaa-ffff-ffff-ffff-fffffffffff2" -SupervisorId "ffffffff-ffff-ffff-ffff-aaaaaaaa" -NoWait
284 +
285 +{{/code}}
286 +
287 +Dieser Befehl initiiert die Verschiebung der Microservices mit den Instanz-IDs "aaaaaaaa-ffff-ffff-ffff-fffffffffff1" und "aaaaaaaa-ffff-ffff-ffff-fffffffffff2" zu "ffffffff-ffff-ffff-ffff-aaaaaaaa" und kehrt sofort zurück, ohne auf den Abschluss des Vorgangs zu warten.
288 +
289 +Beispiel 3: Einen Microservice verschieben mit längerem Timeout
290 +
291 +{{code language="PowerShell"}}
292 +Move-AESBMicroservice -InstanceIds "aaaaaaaa-ffff-ffff-ffff-fffffffffff1" -SupervisorId "ffffffff-ffff-ffff-ffff-aaaaaaaa" -Timeout "5m"
293 +{{/code}}
294 +
295 +Dieser Befehl versucht, "aaaaaaaa-ffff-ffff-ffff-fffffffffff1" zu "ffffffff-ffff-ffff-ffff-aaaaaaaa" zu verschieben und wartet bis zu 5 Minuten auf den Abschluss des Vorgangs.
296 +
297 +=== Rückgabewerte ===
298 +
299 +Das Cmdlet gibt für jede verschobene Instanz ein Objekt mit folgenden Eigenschaften zurück:
300 +
301 +* **InstanceId**: Die ID der verschobenen Microservice-Instanz
302 +* **SicsUsername**: Der zugehörige Benutzername (z. B. für die Verbindung)
303 +* **IsIdentified**: Gibt an, ob die Instanz eindeutig identifiziert wurde
304 +* **ProcessState**: Aktueller Prozessstatus der Instanz (z. B. Stopped)
305 +* **LastUpdate**: Zeitpunkt der letzten Statusänderung
306 +* **Timestamp**: Zeitstempel der letzten Änderung
307 +* **ProcessId**: (Optional) Prozess-ID der Instanz
308 +* **CpuUsage**: (Optional) CPU-Auslastung der Instanz
309 +* **RamUsage**: (Optional) RAM-Auslastung der Instanz
310 +
260 260  == Remove-AESBMicroservices ==
261 261  
313 +Dieses Cmdlet entfernt die angegebenen Microservice-Instanzen. Die zu entfernenden Microservices können entweder über ihre Instanz-Namen oder ihre Instanz-IDs identifiziert werden. Es muss einer der Parameter -//InstanceNames// oder -//InstanceIds// angegeben werden. Die Parameter können nicht zusammen verwendet werden.
314 +
315 +|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
316 +|-ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Instanzen entfernt werden sollen. Wenn nicht angegeben, wird die Standardverbindung verwendet.
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 +|-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 +
320 +=== Beispiele ===
321 +
322 +Beispiel 1: Einen Microservice anhand seiner Instanz-ID entfernen
323 +
324 +{{code language="PowerShell"}}
325 +Remove-AESBMicroservice -InstanceIds "aaaaaaaa-ffff-ffff-ffff-fffffffffff1"
326 +{{/code}}
327 +
328 +Dieser Befehl entfernt den Microservice mit der Instanz-ID "b6cb7044-b6b2-4a64-9997-29f0ea5283db". Die Ausgabe zeigt die Instanz und das Ergebnis "Success".
329 +
330 +Beispiel 2: Mehrere Microservices anhand ihrer Instanz-IDs entfernen
331 +
332 +{{code language="PowerShell"}}
333 +Remove-AESBMicroservice -InstanceIds "aaaaaaaa-ffff-ffff-ffff-fffffffffff1"
334 +{{/code}}
335 +
336 +Dieser Befehl entfernt zwei Microservices, die durch ihre jeweiligen Instanz-IDs identifiziert werden.
337 +
338 +Beispiel 3: Einen Microservice anhand seines Namens entfernen
339 +
340 +{{code language="PowerShell"}}
341 +Remove-AESBMicroservice -InstanceNames "MeinService"
342 +
343 +{{/code}}
344 +
345 +Dieser Befehl entfernt den Microservice mit dem Namen "MeinService".
346 +
347 +Beispiel 4: Mehrere Microservices anhand ihrer Namen entfernen und Bestätigung anfordern
348 +
349 +{{code language="PowerShell"}}
350 +Remove-AESBMicroservice -InstanceNames "Service1", "Service2" -Confirm
351 +{{/code}}
352 +
353 +Dieser Befehl versucht, die Microservices "Service1" und "Service2" zu entfernen. Vor dem eigentlichen Entfernen wird der Benutzer um Bestätigung gebeten.
354 +
355 +Beispiel 5: Microservices über die Pipeline anhand von Instanz-IDs entfernen
356 +
357 +{{code language="PowerShell"}}
358 +"aaaaaaaa-ffff-ffff-ffff-fffffffffff1", "aaaaaaaa-ffff-ffff-ffff-fffffffffff2" | Remove-AESBMicroservice -InstanceIds
359 +
360 +{{/code}}
361 +
362 +Dieser Befehl übergibt zwei Instanz-IDs über die Pipeline an `Remove-Microservice`, um die entsprechenden Microservices zu entfernen.
363 +
364 +=== Rückgabewerte ===
365 +
366 +Das Cmdlet gibt für jeden versuchten Entfernungsvorgang ein Objekt zurück. Dieses Objekt enthält typischerweise die folgenden Informationen:
367 +
368 +* **Instance**: Die ID oder der Name des Microservices.
369 +* **Result**: Das Ergebnis des Entfernungsvorgangs (z.B. "Success", "Failed").
370 +
262 262  == Restart-AESBMicroservices ==
263 263  
264 264  == Set-AESBMicroserviceLogging ==
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community