• 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 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. # Ausführen einer Automatisierung Schritt für Schritt Die folgenden Verfahren beschreiben, wie Sie die AWS Systems Manager Konsole verwenden und AWS Command Line Interface (AWS CLI) eine Automatisierung im manuellen Ausführungsmodus ausführen. Im manuellen Ausführungsmodus startet die Automatisierung in einem *Wartestatus* und verharrt zwischen den einzelnen Schritten im *Wartestatus*. So können Sie steuern, wann der Automatisierung fortgesetzt wird. Dies ist hilfreich, wenn Sie das Ergebnis eines Schritts überprüfen müssen, bevor Sie fortfahren. Die Automatisierung wird im Kontext des aktuellen Benutzers ausgeführt. Das bedeutet, dass Sie keine zusätzlichen IAM-Berechtigungen konfigurieren müssen, solange Sie über die Berechtigung zum Ausführen des Runbooks verfügen und alle Aktionen von dem Runbook aufgerufen werden. Wenn Sie über Administrator-Berechtigungen in IAM verfügen, haben Sie bereits die Berechtigung zum Ausführen dieser Automatisierung. ## Ausführen einer Automatisierung Schritt für Schritt (Konsole) Das folgende Verfahren zeigt, wie Sie mithilfe der Systems Manager-Konsole eine Automatisierung Schritt für Schritt manuell ausführen. **So führen Sie einen Automatisierung Schritt für Schritt aus** 1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. Wählen Sie im Navigationsbereich **Automatisierung** und **Automatisierung ausführen** aus. 1. Wählen Sie in der Liste **Automation-Dokument** ein Runbook. Wählen Sie eine oder mehrere Optionen im Bereich **Dokumentkategorien**, um SSM-Dokumente nach ihrem Zweck zu filtern. Um ein Runbook anzuzeigen, das Sie besitzen, wählen Sie die **Im Besitz von mir**-Registerkarte. Um ein Runbook anzuzeigen, das für Ihr Konto freigegeben ist, wählen Sie die Registerkarte **Mit mir geteilt**. Um alle Runbooks anzuzeigen, wählen Sie die Registerkarte **Alle Dokumente**. **Anmerkung** Sie können Informationen zu einem Runbook einsehen, indem Sie den Runbook-Namen auswählen. 1. Überprüfen Sie im Abschnitt **Dokument-Details**, ob **Dokumentversion** auf die Version gesetzt ist, die Sie ausführen möchten. Das System bietet die folgenden Versionsoptionen: + **Standardversion zur Laufzeit** – Wählen Sie diese Option aus, wenn das Automation-Runbook regelmäßig aktualisiert wird und eine neue Standardversion zugewiesen ist. + **Letzte Version zur Laufzeit** – Wählen Sie diese Option aus, wenn das Automation-Runbook regelmäßig aktualisiert wird, und Sie die Version auszuführen möchten, die zuletzt aktualisiert wurde. + **1 (Standard)** – Wählen Sie diese Option zur Ausführung der ersten Version des Dokuments, welches der Standard ist. 1. Wählen Sie **Weiter** aus. 1. Wählen Sie im Abschnitt **Execution mode (Ausführungsmodus)** die Option **Manual execution (Manuelle Ausführung)** aus. 1. Geben Sie im Abschnitt **Eingabeparameter** die erforderlichen Eingaben an. Optional können Sie eine IAM-Dienstrolle aus der **AutomationAssumeRole**Liste auswählen. 1. Wählen Sie **Ausführen**. 1. Wählen Sie **Execute this step (Diesen Schritt ausführen)** aus, wenn Sie zum ersten Schritt der Automatisierung bereit sind. Die Automatisierung fährt mit Schritt 1 fort und hält an, bevor die weiteren Schritte des Runbooks, das Sie in Schritt 3 dieses Verfahrens ausgewählt haben, ausgeführt werden. Wenn das Runbook mehrere Schritte umfasst, müssen Sie für jeden Schritt **Execute this step (Diesen Schritt ausführen)** auswählen, damit die Automatisierung fortgesetzt wird. Jedes Mal, wenn Sie **diesen Schritt ausführen**, wird die Aktion ausgeführt. **Anmerkung** Die Konsole zeigt den Status der Automatisierung an. Wenn die Automatisierung einen Schritt nicht ausführen kann, finden Sie weitere Informationen unter [Fehlerbehebung für Systems Manager Automation.](automation-troubleshooting.md). 1. Nachdem Sie alle Schritte im Runbook abgeschlossen haben, wählen Sie **Complete and view results (Abschließen und Ergebnisse anzeigen)** aus, um die Automatisierung zu beenden und die Ergebnisse anzuzeigen. Nach Abschluss einer Automatisierungsausführung können Sie die Ausführung mit denselben oder geänderten Parametern erneut ausführen. Weitere Informationen finden Sie unter [Wiederholtes Ausführen von Automatisierungsausführungen](automation-rerun-executions.md). ## Ausführen einer Automatisierung Schritt für Schritt (Befehlszeile) Das folgende Verfahren beschreibt Schritt für Schritt, wie Sie die AWS CLI (unter LinuxmacOS, oder AWS -Tools für PowerShell Windows) verwenden oder manuell ausführen. **So führen Sie einen Automatisierung Schritt für Schritt aus** 1. Installieren und konfigurieren Sie das AWS CLI oder das AWS -Tools für PowerShell, falls Sie dies noch nicht getan haben. Weitere Informationen finden Sie unter [Installieren oder Aktualisieren der neuesten Version der AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) und [Installieren des AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html). 1. Führen Sie den folgenden Befehl aus, um eine manuelle Automatisierung zu starten. Ersetzen Sie jeden *example resource placeholder* durch Ihre Informationen. ------ #### [ Linux & macOS ] ``` aws ssm start-automation-execution \ --document-name runbook name \ --mode Interactive \ --parameters runbook parameters ``` ------ #### [ Windows ] ``` aws ssm start-automation-execution ^ --document-name runbook name ^ --mode Interactive ^ --parameters runbook parameters ``` ------ #### [ PowerShell ] ``` Start-SSMAutomationExecution ` -DocumentName runbook name ` -Mode Interactive ` -Parameter runbook parameters ``` ------ Hier sehen Sie ein Beispiel, wie Sie das `AWS-RestartEC2Instance`-Runbook verwenden, um die angegebene EC2-Instance neu zu starten. ------ #### [ Linux & macOS ] ``` aws ssm start-automation-execution \ --document-name "AWS-RestartEC2Instance" \ --mode Interactive \ --parameters "InstanceId=i-02573cafcfEXAMPLE" ``` ------ #### [ Windows ] ``` aws ssm start-automation-execution ^ --document-name "AWS-RestartEC2Instance" ^ --mode Interactive ^ --parameters "InstanceId=i-02573cafcfEXAMPLE" ``` ------ #### [ PowerShell ] ``` Start-SSMAutomationExecution ` -DocumentName AWS-RestartEC2Instance ` -Mode Interactive -Parameter @{"InstanceId"="i-02573cafcfEXAMPLE"} ``` ------ Das System gibt unter anderem folgende Informationen zurück ------ #### [ Linux & macOS ] ``` { "AutomationExecutionId": "ba9cd881-1b36-4d31-a698-0123456789ab" } ``` ------ #### [ Windows ] ``` { "AutomationExecutionId": "ba9cd881-1b36-4d31-a698-0123456789ab" } ``` ------ #### [ PowerShell ] ``` ba9cd881-1b36-4d31-a698-0123456789ab ``` ------ 1. Führen Sie den folgenden Befehl aus, wenn Sie bereit sind, den ersten Schritt der Automatisierung zu starten. Ersetzen Sie jeden *example resource placeholder* durch Ihre Informationen. Die Automatisierung fährt mit Schritt 1 fort und hält an, bevor die weiteren Schritte des Runbooks, das Sie in Schritt 1 dieses Verfahrens ausgewählt haben, ausgeführt werden. Wenn das Runbook mehrere Schritte umfasst, müssen Sie den folgenden Befehl für jeden Schritt ausführen, damit die Automatisierung fortfahren kann. ------ #### [ Linux & macOS ] ``` aws ssm send-automation-signal \ --automation-execution-id ba9cd881-1b36-4d31-a698-0123456789ab \ --signal-type StartStep \ --payload StepName="stopInstances" ``` ------ #### [ Windows ] ``` aws ssm send-automation-signal ^ --automation-execution-id ba9cd881-1b36-4d31-a698-0123456789ab ^ --signal-type StartStep ^ --payload StepName="stopInstances" ``` ------ #### [ PowerShell ] ``` Send-SSMAutomationSignal ` -AutomationExecutionId ba9cd881-1b36-4d31-a698-0123456789ab ` -SignalType StartStep -Payload @{"StepName"="stopInstances"} ``` ------ Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe. 1. Führen Sie den folgenden Befehl aus, um den Status jeder Schrittausführung in der Automatisierung abzurufen. ------ #### [ Linux & macOS ] ``` aws ssm describe-automation-step-executions \ --automation-execution-id ba9cd881-1b36-4d31-a698-0123456789ab ``` ------ #### [ Windows ] ``` aws ssm describe-automation-step-executions ^ --automation-execution-id ba9cd881-1b36-4d31-a698-0123456789ab ``` ------ #### [ PowerShell ] ``` Get-SSMAutomationStepExecution ` -AutomationExecutionId ba9cd881-1b36-4d31-a698-0123456789ab ``` ------ Das System gibt unter anderem folgende Informationen zurück ------ #### [ Linux & macOS ] ``` { "StepExecutions": [ { "StepName": "stopInstances", "Action": "aws:changeInstanceState", "ExecutionStartTime": 1557167178.42, "ExecutionEndTime": 1557167220.617, "StepStatus": "Success", "Inputs": { "DesiredState": "\"stopped\"", "InstanceIds": "[\"i-02573cafcfEXAMPLE\"]" }, "Outputs": { "InstanceStates": [ "stopped" ] }, "StepExecutionId": "654243ba-71e3-4771-b04f-0123456789ab", "OverriddenParameters": {}, "ValidNextSteps": [ "startInstances" ] }, { "StepName": "startInstances", "Action": "aws:changeInstanceState", "ExecutionStartTime": 1557167273.754, "ExecutionEndTime": 1557167480.73, "StepStatus": "Success", "Inputs": { "DesiredState": "\"running\"", "InstanceIds": "[\"i-02573cafcfEXAMPLE\"]" }, "Outputs": { "InstanceStates": [ "running" ] }, "StepExecutionId": "8a4a1e0d-dc3e-4039-a599-0123456789ab", "OverriddenParameters": {} } ] } ``` ------ #### [ Windows ] ``` { "StepExecutions": [ { "StepName": "stopInstances", "Action": "aws:changeInstanceState", "ExecutionStartTime": 1557167178.42, "ExecutionEndTime": 1557167220.617, "StepStatus": "Success", "Inputs": { "DesiredState": "\"stopped\"", "InstanceIds": "[\"i-02573cafcfEXAMPLE\"]" }, "Outputs": { "InstanceStates": [ "stopped" ] }, "StepExecutionId": "654243ba-71e3-4771-b04f-0123456789ab", "OverriddenParameters": {}, "ValidNextSteps": [ "startInstances" ] }, { "StepName": "startInstances", "Action": "aws:changeInstanceState", "ExecutionStartTime": 1557167273.754, "ExecutionEndTime": 1557167480.73, "StepStatus": "Success", "Inputs": { "DesiredState": "\"running\"", "InstanceIds": "[\"i-02573cafcfEXAMPLE\"]" }, "Outputs": { "InstanceStates": [ "running" ] }, "StepExecutionId": "8a4a1e0d-dc3e-4039-a599-0123456789ab", "OverriddenParameters": {} } ] } ``` ------ #### [ PowerShell ] ``` Action: aws:changeInstanceState ExecutionEndTime : 5/6/2019 19:45:46 ExecutionStartTime : 5/6/2019 19:45:03 FailureDetails : FailureMessage : Inputs : {[DesiredState, "stopped"], [InstanceIds, ["i-02573cafcfEXAMPLE"]]} IsCritical : False IsEnd : False MaxAttempts : 0 NextStep : OnFailure : Outputs : {[InstanceStates, Amazon.Runtime.Internal.Util.AlwaysSendList`1[System.String]]} OverriddenParameters : {} Response : ResponseCode : StepExecutionId : 8fcc9641-24b7-40b3-a9be-0123456789ab StepName : stopInstances StepStatus : Success TimeoutSeconds : 0 ValidNextSteps : {startInstances} ``` ------ 1. Führen Sie den folgenden Befehl aus, um die Automatisierung abzuschließen, nachdem alle im ausgewählten Runbook angegebenen Schritte abgeschlossen sind. Ersetzen Sie jeden *example resource placeholder* durch Ihre Informationen. ------ #### [ Linux & macOS ] ``` aws ssm stop-automation-execution \ --automation-execution-id ba9cd881-1b36-4d31-a698-0123456789ab \ --type Complete ``` ------ #### [ Windows ] ``` aws ssm stop-automation-execution ^ --automation-execution-id ba9cd881-1b36-4d31-a698-0123456789ab ^ --type Complete ``` ------ #### [ PowerShell ] ``` Stop-SSMAutomationExecution ` -AutomationExecutionId ba9cd881-1b36-4d31-a698-0123456789ab ` -Type Complete ``` ------ Wenn der Befehl erfolgreich ausgeführt wurde, gibt es keine Ausgabe.