Changes for page Microservice Cmdlets

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

From version 3.1
edited by jklein
on 2025/06/20 11:01
Change comment: There is no comment for this version
To version 3.2
edited by jklein
on 2025/06/23 09:57
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -426,8 +426,109 @@
426 426  
427 427  == Set-AESBMicroserviceLogging ==
428 428  
429 +Mit diesem Cmdlet können Sie die Logging-Einstellungen für die angegebenen Microservice-Instanzen konfigurieren. Es kann verwendet werden, um das Logging entweder zu aktivieren (mit `-Enable`) oder zu deaktivieren (mit `-Disable`). Dabei muss einer der Parameter `-Enable` oder `-Disable` zusammen mit `-InstanceIds` angegeben werden.
430 +
431 +|=(% style="width: 213px;" %)Parameter |=(% style="width: 217px;" %)Datentyp|=Optional|=Alias|=Beschreibung
432 +|-ConnectionName|String|✅|C|Der Name der Verbindung, über die das Logging von Microservice-Instanzen aktiviert / deaktiviert werden soll. Wird die Standardverbindung verwendet, wenn nicht angegeben.
433 +|-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.
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 +|-Disable|SwitchParameter|✅❌|Keine|Deaktiviert das Logging für die angegebenen Microservices. Obligatorisch für Parametersatz `SwitchDisable`. Kann nicht zusammen mit `-Enable` verwendet werden.
436 +
437 +=== **Beispiele** ===
438 +
439 +Beispiel 1: Logging für einen Microservice aktivieren
440 +
441 +{{code language="PowerShell"}}
442 +Set-AESBMicroserviceLogging -InstanceIds "aaaaaaaa-ffff-ffff-ffff-fffffffffff1" -Enable
443 +{{/code}}
444 +
445 +Dieser Befehl aktiviert das Logging für den Microservice mit der Instanz-ID "aaaaaaaa-ffff-ffff-ffff-fffffffffff1".
446 +
447 +Beispiel 2: Logging für mehrere Microservices deaktivieren
448 +
449 +{{code language="PowerShell"}}
450 +Set-AESBMicroserviceLogging -InstanceIds "aaaaaaaa-ffff-ffff-ffff-fffffffffff1", "aaaaaaaa-ffff-ffff-ffff-fffffffffff2" -Disable
451 +
452 +{{/code}}
453 +
454 +Dieser Befehl deaktiviert das Logging für die Microservices mit den angegebenen Instanz-IDs.
455 +
456 +Beispiel 3: Logging für einen Microservice über die Pipeline aktivieren
457 +
458 +{{code language="PowerShell"}}
459 +"aaaaaaaa-ffff-ffff-ffff-fffffffffff1" | Set-AESBMicroserviceLogging -Enable
460 +
461 +{{/code}}
462 +
463 +Dieser Befehl übergibt eine Instanz-ID über die Pipeline an `Set-MicroserviceLogging`, um das Logging für den entsprechenden Microservice zu aktivieren.
464 +
465 +=== Rückgabewerte ===
466 +
467 +Das Cmdlet gibt für jede Instanz, deren Logging-Status geändert wurde, ein Objekt zurück. Dieses Objekt enthält typischerweise die folgenden Informationen:
468 +
469 +* **Status**: Der Status der Operation (z.B. "Changed", "Unchanged", "Failed").
470 +* **MicroserviceId**: Die Instanz-ID des Microservices.
471 +* **MicroserviceName**: Der Name des Microservices.
472 +* **Logging**: Der neue Logging-Status (True oder False).
473 +
429 429  == Start-AESBMicroservices ==
430 430  
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 +
478 +
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.
481 +|-SupervisorId|String|❌|Keine|Gibt die ID des Supervisors an, dessen zugehörige Microservices gestartet werden sollen. Obligatorisch für Parametersatz `SupervisorParametersetName`.
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 +|-Timeout|String|✅|Keine|Gibt die maximale Wartezeit für den Startvorgang an (z.B. "30s", "1m"). Standardwert: "30s".
484 +|-NoWait      |SwitchParameter|✅|Keine|Wenn dieser Parameter angegeben ist, wartet das Cmdlet nicht auf den Abschluss des Startvorgangs, sondern kehrt sofort zurück.
485 +
486 +=== **Beispiele** ===
487 +
488 +Beispiel 1: Einen Microservice anhand seiner Instanz-ID starten
489 +
490 +{{code language="PowerShell"}}
491 +Start-AESBMicroservices -InstanceIds "aaaaaaaa-ffff-ffff-ffff-fffffff1"
492 +
493 +{{/code}}
494 +
495 +Dieser Befehl startet den Microservice mit der Instanz-ID "aaaaaaaa-ffff-ffff-ffff-fffffff1" und wartet auf das Ergebnis.
496 +
497 +Beispiel 2: Mehrere Microservices anhand ihrer Instanz-IDs starten mit Timeout
498 +
499 +{{code language="PowerShell"}}
500 +Start-AESBMicroservices -InstanceIds "aaaaaaaa-ffff-ffff-ffff-fffffff1", "aaaaaaaa-ffff-ffff-ffff-fffffff2" -Timeout "1m"
501 +
502 +{{/code}}
503 +
504 +Dieser Befehl startet zwei Microservices und setzt das Timeout für den Vorgang auf eine Minute.
505 +
506 +Beispiel 3: Alle Microservices eines Supervisors starten, ohne auf den Abschluss zu warten
507 +
508 +{{code language="PowerShell"}}
509 +Start-AESBMicroservices -SupervisorId "ffffffff-ffff-ffff-ffff-aaaaaaaa" -NoWait
510 +
511 +{{/code}}
512 +
513 +Dieser Befehl initiiert den Start aller Microservices, die vom Supervisor "ffffffff-ffff-ffff-ffff-aaaaaaaa" verwaltet werden, und kehrt sofort zurück.
514 +
515 +Beispiel 4: Microservices über die Pipeline anhand von Instanz-IDs starten
516 +
517 +{{code language="PowerShell"}}
518 +"aaaaaaaa-ffff-ffff-ffff-fffffff1", "aaaaaaaa-ffff-ffff-ffff-fffffff2" | Start-AESBMicroservices
519 +
520 +{{/code}}
521 +
522 +Dieser Befehl übergibt zwei Instanz-IDs über die Pipeline an `Start-Microservices`, um die entsprechenden Microservices zu starten.
523 +
524 +=== **Rückgabewert** ===
525 +
526 +Das Cmdlet gibt für jeden versuchten Startvorgang ein Objekt zurück. Dieses Objekt enthält typischerweise die folgenden Informationen:
527 +
528 +* **InstanceName**: Der Name des Microservices.
529 +* **InstanceId:** Die Instanz-ID des Microservices.
530 +* **Status**: Das Ergebnis des Startvorgangs (z.B. "Started", "Failed", "AlreadyRunning").
531 +
431 431  == Stop-AESBMicroservices ==
432 432  
433 433  = Packages =
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community