Changes for page Microservice Cmdlets

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

From version 3.2
edited by jklein
on 2025/06/23 09:57
Change comment: There is no comment for this version
To version 4.1
edited by jklein
on 2025/06/23 10:40
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -477,7 +477,7 @@
477 477  
478 478  
479 479  |=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
480 -|ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Instanzen gestartet werden sollen. Wird die Standardverbindung verwendet, wenn nicht angegeben.
480 +|-ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Instanzen gestartet werden sollen. Wird die Standardverbindung verwendet, wenn nicht angegeben.
481 481  |-SupervisorId|String|❌|Keine|Gibt die ID des Supervisors an, dessen zugehörige Microservices gestartet werden sollen. Obligatorisch für Parametersatz `SupervisorParametersetName`.
482 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`.
483 483  |-Timeout|String|✅|Keine|Gibt die maximale Wartezeit für den Startvorgang an (z.B. "30s", "1m"). Standardwert: "30s".
... ... @@ -531,6 +531,62 @@
531 531  
532 532  == Stop-AESBMicroservices ==
533 533  
534 +Mit diesem Cmdlet werden die angegebenen, laufenden Microservice-Instanzen gestoppt. Die zu stoppenden Microservices können entweder über ihre `InstanceIds` oder über eine `SupervisorId` (die alle zugehörigen Instanzen stoppt) identifiziert werden. Es muss einer der Parameter `-InstanceIds` oder `-SupervisorId` angegeben werden.
535 +
536 +
537 +|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
538 +|-ConnectionName|String|✅|C|Der Name der Verbindung, über die Microservice-Instanzen gestoppt werden sollen. Wird die Standardverbindung verwendet, wenn nicht angegeben.
539 +|-SupervisorId|String|❌|Keine|Gibt die ID des Supervisors an, dessen zugehörige Microservices gestoppt werden sollen. Obligatorisch für Parametersatz `UseSupervisorIdParameterSet`.
540 +|-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`.
541 +|-Timeout|String|✅|Keine|Gibt die maximale Wartezeit für den Stoppvorgang an (z.B. "5s", "1m"). Standardwert: "5s".
542 +|-NoWait      |SwitchParameter|✅|Keine|Wenn dieser Parameter angegeben ist, wartet das Cmdlet nicht auf den Abschluss des Stoppvorgangs, sondern kehrt sofort zurück.
543 +
544 +=== **Beispiele** ===
545 +
546 +Beispiel 1: Einen Microservice anhand seiner Instanz-ID stoppen
547 +
548 +{{code language="PowerShell"}}
549 +Stop-AESBMicroservices -InstanceIds "c7e323e9-abc1-4150-a4a3-afb4e57e9cb1"
550 +{{/code}}
551 +
552 +Dieser Befehl stoppt den Microservice mit der Instanz-ID "c7e323e9-abc1-4150-a4a3-afb4e57e9cb1" und wartet auf das Ergebnis.
553 +
554 +Beispiel 2: Mehrere Microservices anhand ihrer Instanz-IDs stoppen mit Timeout
555 +
556 +{{code language="PowerShell"}}
557 +Stop-AESBMicroservices -InstanceIds "01234567-89ab-cdef-0123-456789abcdef", "fedcba98-7654-3210-fedc-ba9876543210" -Timeout "10s"
558 +
559 +{{/code}}
560 +
561 +Dieser Befehl stoppt zwei Microservices und setzt das Timeout für den Vorgang auf zehn Sekunden.
562 +
563 +Beispiel 3: Alle Microservices eines Supervisors stoppen, ohne auf den Abschluss zu warten
564 +
565 +{{code language="PowerShell"}}
566 +Stop-AESBMicroservices -SupervisorId "FinanceSupervisor" -NoWait
567 +
568 +{{/code}}
569 +
570 +Dieser Befehl initiiert den Stoppvorgang aller Microservices, die vom Supervisor "FinanceSupervisor" verwaltet werden, und kehrt sofort zurück.
571 +
572 +Beispiel 4: Microservices über die Pipeline anhand von Instanz-IDs stoppen
573 +
574 +{{code language="PowerShell"}}
575 +"c7e323e9-abc1-4150-a4a3-afb4e57e9cb1", "another-guid-for-stop" | Stop-AESBMicroservices
576 +
577 +{{/code}}
578 +
579 +Dieser Befehl übergibt zwei Instanz-IDs über die Pipeline an `Stop-AESBMicroservices`, um die entsprechenden Microservices zu stoppen.
580 +
581 +=== **Rückgabewert** ===
582 +
583 +Das Cmdlet gibt für jeden versuchten Stoppvorgang ein Objekt zurück. Dieses Objekt enthält typischerweise die folgenden Informationen:
584 +
585 +* **Status**: Der Status der Operation (z.B. "Changed", "Unchanged", "Failed")
586 +* **InstanceId**: Die Instanz-ID des Microservices.
587 +* **InstanceState**: Der Zustand des Microservices nach dem versuchten Stoppvorgang (z.B. "Stopped", "Running").
588 +* **Error**: Fehlermeldungen, falls der Stoppvorgang nicht erfolgreich war.
589 +
534 534  = Packages =
535 535  
536 536  == Get-AESBMicroservicePackages ==
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community