Verwenden von Run Command zum Senden eines Befehls, der Statusbenachrichtigungen zurückgibt - AWS Systems Manager
Senden eines Run Command, der Benachrichtigungen zurückgibt (Konsole)Senden eines Run Command, der Benachrichtigungen zurückgibt (CLI)

• AWS Systems ManagerChange Manager steht neuen Kunden nicht mehr offen. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der AWS Systems ManagerChange Manager Verfügbarkeit.

 

• Das AWS Systems Manager CloudWatch Dashboard wird nach dem 30. April 2026 nicht mehr verfügbar sein. Kunden können weiterhin die CloudWatch Amazon-Konsole verwenden, um ihre CloudWatch Amazon-Dashboards anzusehen, zu erstellen und zu verwalten, so wie sie es heute tun. Weitere Informationen finden Sie in der Amazon CloudWatch Dashboard-Dokumentation.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden von Run Command zum Senden eines Befehls, der Statusbenachrichtigungen zurückgibt

Die folgenden Verfahren zeigen, wie Sie mithilfe der AWS Command Line Interface (AWS CLI) oder AWS Systems Manager -Konsole einen Befehl über ein Tool sendenRun Command, das für die Rückgabe von Statusbenachrichtigungen konfiguriert ist. AWS Systems Manager

Senden eines Run Command, der Benachrichtigungen zurückgibt (Konsole)

Mit der folgenden Vorgehensweise können Sie mittels Run Command einen Befehl senden, der so konfiguriert ist, dass Statusbenachrichtigungen mithilfe der Systems Manager-Konsole zurückgeben werden.

So senden Sie einen Befehl, der Benachrichtigungen zurückgibt (Konsole)

  1. Öffnen Sie die AWS Systems Manager Konsole unter https://console.aws.amazon.com/systems-manager/.

  2. Wählen Sie im Navigationsbereich Run Command aus.

  3. Wählen Sie Befehl ausführen aus.

  4. Wählen Sie in der Liste Befehlsdokument ein Systems Manager-Dokument.

  5. Geben Sie im Abschnitt Befehlsparameter Werte für erforderliche Parameter an.

  6. Identifizieren Sie für den Abschnitt Targets (Ziele) die verwalteten Knoten, auf denen Sie diese Operation ausführen möchten, indem Sie Tags angeben, Instances oder Edge-Geräte manuell auswählen oder eine Ressourcengruppe angeben.

    Tipp

    Wenn ein verwalteter Knoten, den Sie erwarten, nicht aufgeführt ist, finden Sie weitere Informationen unter Problembehandlung bei der Verfügbarkeit verwalteter Knoten Tipps zur Fehlerbehebung.

  7. Für Weitere Parameter:

    • Geben Sie im Feld Kommentar Informationen zu diesem Befehl ein.

    • Geben Sie für Timeout (Sekunden) in Sekunden an, wie lange gewartet werden soll, bis für die gesamte Befehlsausführung ein Fehler auftritt.

  8. Für Ratenregelung:

    • Geben Sie unter Nebenläufigkeit entweder eine Zahl oder einen Prozentsatz der verwalteten Knoten an, auf denen der Befehl gleichzeitig ausgeführt werden soll.

      Anmerkung

      Wenn Sie Ziele ausgewählt haben, indem Sie Tags für verwaltete Knoten oder AWS Ressourcengruppen angegeben haben und Sie sich nicht sicher sind, wie viele verwaltete Knoten das Ziel sind, schränken Sie die Anzahl der Ziele ein, die das Dokument gleichzeitig ausführen können, indem Sie einen Prozentsatz angeben.

    • Geben Sie unter Fehlerschwellenwert an, wann die Ausführung des Befehls auf anderen verwalteten Knoten beendet werden soll, nachdem dafür entweder auf einer bestimmten Anzahl oder einem Prozentsatz von Knoten ein Fehler aufgetreten ist. Falls Sie beispielsweise drei Fehler angeben, sendet Systems Manager keinen Befehl mehr, wenn der vierte Fehler empfangen wird. Von verwalteten Knoten, auf denen der Befehl noch verarbeitet wird, werden unter Umständen ebenfalls Fehler gesendet.

  9. (Optional) Wenn Sie im Abschnitt Ausgabeoptionen die Befehlsausgabe in einer Datei speichern möchten, aktivieren Sie das Kontrollkästchen Schreiben in einen S3-Bucket aktivieren. Geben Sie die Namen für den Bucket und das Präfix (Ordner) in die Textfelder ein.

    Anmerkung

    Die S3-Berechtigungen, die das Schreiben der Daten in einen S3-Bucket ermöglichen, sind diejenigen des Instanzprofils (für EC2 Instances) oder der IAM-Servicerolle (hybridaktivierte Maschinen), die der Instanz zugewiesen wurden, nicht die des IAM-Benutzers, der diese Aufgabe ausführt. Weitere Informationen finden Sie unter Instance-Berechtigungen für Systems Manager konfigurieren oder Eine IAM-Servicerolle für eine Hybrid-Umgebung erstellen. Wenn sich der angegebene S3-Bucket in einem anderen AWS-Konto befindet, stellen Sie außerdem sicher, dass das Instance-Profil oder die IAM-Servicerolle, die dem verwalteten Knoten zugeordnet ist, über die erforderlichen Berechtigungen zum Schreiben in diesen Bucket verfügt.

  10. Wählen Sie im Abschnitt SNS Notifications (SNS-Benachrichtigungen)die Option Enable SNS notifications (SNS-Benachrichtigungen aktivieren) aus.

  11. Wählen Sie für IAM role (IAM-Rolle) den ARN Amazon SNS IAM-Rolle aus, den Sie in Aufgabe 3 in Überwachung von Systems Manager-Statusänderungen mit Amazon SNS-Benachrichtigungen erstellt haben.

  12. Geben Sie für SNS-Thema den ARN für das Amazon SNS-Thema an, welcher verwendet werden soll.

  13. Wählen Sie für Event notifications (Ereignisbenachrichtigungen) die Ereignisse aus, für die Sie Benachrichtigungen erhalten möchten.

  14. Wählen Sie für Change notifications (Änderungsbenachrichtigen), ob Sie Benachrichtigungen nur für die Befehlsübersicht erhalten möchten (Command status changes (Befehls-Statusänderungen)) oder für jede Kopie eines Befehls, der an mehrere Knoten (Command status on each instance changes (Befehls-Statusänderungen bei jeder Instance)) gesendet wurde.

  15. Klicken Sie auf Ausführen.

  16. Überprüfen Sie, ob Sie eine Nachricht von Amazon SNS erhalten haben, und öffnen Sie die E-Mail-Nachricht. Es kann einige Minuten dauern, bis Amazon SNS die E-Mail-Nachricht sendet.

Senden eines Run Command, der Benachrichtigungen zurückgibt (CLI)

Gehen Sie wie folgt vor, um mittels Run Command einen Befehl zu senden, der so konfiguriert ist, dass er mithilfe von AWS CLI Statusbenachrichtigungen zurückgibt.

So senden Sie einen Befehl, der Statusbenachrichtigungen zurückgibt (CLI)

  1. Öffnen AWS CLI Sie die.

  2. Geben Sie im folgenden Befehl die Parameter an, die auf dem verwalteten Knoten basieren sollen IDs.

    aws ssm send-command --instance-ids "ID-1, ID-2" --document-name "Name" --parameters '{"commands":["input"]}' --service-role "SNSRoleARN" --notification-config '{"NotificationArn":"SNSTopicName","NotificationEvents":["All"],"NotificationType":"Command"}'

    Im Folgenden sehen Sie ein Beispiel.

    aws ssm send-command --instance-ids "i-02573cafcfEXAMPLE, i-0471e04240EXAMPLE" --document-name "AWS-RunPowerShellScript" --parameters '{"commands":["Get-Process"]}' --service-role "arn:aws:iam::111122223333:role/SNS_Role" --notification-config '{"NotificationArn":"arn:aws:sns:us-east-1:111122223333:SNSTopic","NotificationEvents":["All"],"NotificationType":"Command"}'
    Alternative Befehle

    Geben Sie im folgenden Befehl Parameter ab, um auf verwaltete Instances abzuzielen, die Tags verwenden.

    aws ssm send-command --targets "Key=tag:TagName,Values=TagKey" --document-name "Name" --parameters '{"commands":["input"]}' --service-role "SNSRoleARN" --notification-config '{"NotificationArn":"SNSTopicName","NotificationEvents":["All"],"NotificationType":"Command"}'

    Im Folgenden sehen Sie ein Beispiel.

    aws ssm send-command --targets "Key=tag:Environment,Values=Dev" --document-name "AWS-RunPowerShellScript" --parameters '{"commands":["Get-Process"]}' --service-role "arn:aws:iam::111122223333:role/SNS_Role" --notification-config '{"NotificationArn":"arn:aws:sns:us-east-1:111122223333:SNSTopic","NotificationEvents":["All"],"NotificationType":"Command"}'

  3. Drücken Sie die Eingabetaste.

  4. Überprüfen Sie, ob Sie eine Nachricht von Amazon SNS erhalten haben, und öffnen Sie die E-Mail-Nachricht. Es kann einige Minuten dauern, bis Amazon SNS die E-Mail-Nachricht sendet.

Weitere Informationen finden Sie unter send-command in der Referenz zum AWS CLI -Befehl.