• Das AWS Systems Manager CloudWatch Dashboard wird nach dem 30. April 2026 nicht mehr verfügbar sein. Kunden können die CloudWatch Amazon-Konsole weiterhin verwenden, um ihre CloudWatch Amazon-Dashboards anzuzeigen, 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. # Parameteroptionen für den register-task-with-maintenance-windows-Befehl Der Befehl **register-task-with-maintenance-window** bietet mehrere Optionen für die Konfiguration einer Aufgabe entsprechend Ihren Anforderungen. Einige sind erforderlich, einige sind optional und einige gelten nur für einen einzigen Wartungsfenster-Aufgabentyp. In diesem Thema erhalten Sie Informationen zu einigen dieser Optionen, um Sie bei der Arbeit mit Beispielen in diesem Abschnitt des Tutorials zu unterstützen. Informationen über alle Befehlsoptionen finden Sie unter **[register-task-with-maintenance-window](https://docs.aws.amazon.com/cli/latest/reference/ssm/register-task-with-maintenance-window.html)** in der *AWS CLI Command Reference*. **Befehlsoption: `--task-arn`** Die Option `--task-arn` wird verwendet, um die Ressource anzugeben, die von der Aufgabe ausgeführt wird. Der von Ihnen angegebene Wert hängt wie in der folgenden Tabelle beschrieben, davon ab, welche Art von Aufgabe Sie registrieren möchten. **TaskArn Formate für Aufgaben im Wartungsfenster** | Wartungsfenster-Aufgabentyp | TaskArn Wert | | --- | --- | | **`RUN_COMMAND`** und ** `AUTOMATION`** | `TaskArn` ist der SSM-Dokumentname oder der Amazon-Ressourcenname (ARN). Zum Beispiel:
`AWS-RunBatchShellScript`
–oder–
`arn:aws:ssm:{{region}}:111122223333:document/My-Document`. | | **`LAMBDA`** | `TaskArn` ist der Funktionsname oder -ARN. Zum Beispiel:
`SSMMy-Lambda-Function`
–oder–
`arn:aws:lambda:{{region}}:111122223333:function:SSMMyLambdaFunction`. Die IAM-Richtlinie für Maintenance Windows erfordert, dass Sie den Namen von Lambda-Funktionen (oder Aliasen) das Präfix `SSM` hinzufügen. Bevor Sie mit der Registrierung dieses Aufgabentyps fortfahren, ändern Sie AWS Lambda den Namen in include`SSM`. Beispiel: Wenn Ihr Lambda-Funktionsname `MyLambdaFunction` lautet, ändern Sie ihn in `SSMMyLambdaFunction`. Wenn Sie die serviceverknüpfte Rolle verwenden, muss sich die Lambda-Funktion im selben Konto wie das Wartungsfenster befinden. Verwenden Sie `--service-role-arn` für den kontoübergreifenden Aufruf eine benutzerdefinierte Rolle und fügen Sie der Zielfunktion eine ressourcenbasierte Richtlinie hinzu. | | **`STEP_FUNCTIONS`** | `TaskArn` ist der ARN des Zustandsautomaten. Zum Beispiel:
`arn:aws:states:us-east-2:111122223333:stateMachine:SSMMyStateMachine`. Die IAM-Richtlinie für Wartungsfenster erfordert, dass Sie Step Functions-Zustandsautomaten-Namen das Präfix `SSM` geben. Bevor Sie diese Art der Aufgabe registrieren können, müssen Sie ihren Namen in AWS Step Functions so aktualisieren, dass in ihm `SSM` enthalten ist. Beispiel: Wenn der Name des Zustandsautomaten `MyStateMachine` lautet, ändern Sie ihn in `SSMMyStateMachine`. Die State-Machine muss sich im gleichen Konto wie das Wartungsfenster befinden. Sie können eine Zustandsmaschine nicht kontenübergreifend aufrufen. | **Befehlsoption: --service-role-arn ``** Die Rolle, die bei der Ausführung der AWS Systems Manager Aufgabe für das Wartungsfenster übernommen werden soll. Weitere Informationen finden Sie unter [Einrichtung Wartungsfenster](setting-up-maintenance-windows.md). **Befehlsoption: `--task-invocation-parameters`** Die Option `--task-invocation-parameters` wird dazu verwendet, jene Parameter anzugeben, die nur für die vier Aufgabentypen gelten. Die unterstützten Parameter für jede der vier Arten von Aufgaben werden in der folgenden Tabelle beschrieben. **Anmerkung** Weitere Informationen über die Verwendung von Pseudoparametern in `--task-invocation-parameters`-Inhalten, z. B. {{TARGET\_ID}}, finden Sie unter [Verwendung von Pseudo-Parametern bei der Registrierung von Aufgaben im Wartungsfenster](maintenance-window-tasks-pseudo-parameters.md). Aufgabenaufruf-Parameteroptionen für Wartungsfenster-Aufgaben | Wartungsfenster-Aufgabentyp | Verfügbare Parameter | Beispiel | | --- | --- | --- | | **`RUN_COMMAND`** | `Comment`
`DocumentHash`
`DocumentHashType`
`NotificationConfig`
`OutputS3BucketName`
`OutPutS3KeyPrefix`
`Parameters`
`ServiceRoleArn`
`TimeoutSeconds` | 
"TaskInvocationParameters": {
        "RunCommand": {
            "Comment": "My Run Command task comment",
            "DocumentHash": "6554ed3d--truncated--5EXAMPLE",
            "DocumentHashType": "Sha256",
            "NotificationConfig": {
                "NotificationArn": "arn:aws:sns:{{region}}:123456789012:my-sns-topic-name",
                "NotificationEvents": [
                    "FAILURE"
                ],
                "NotificationType": "Invocation"
            },
            "OutputS3BucketName": "amzn-s3-demo-bucket",
            "OutputS3KeyPrefix": "{{S3-PREFIX}}",
            "Parameters": {
                "commands": [
                    "Get-ChildItem$env: temp-Recurse|Remove-Item-Recurse-force"
                ]
            },
            "ServiceRoleArn": "arn:aws:iam::123456789012:role/MyMaintenanceWindowServiceRole",
            "TimeoutSeconds": 3600
        }
    }
| | **`AUTOMATION`** | `DocumentVersion`
`Parameters` | 
"TaskInvocationParameters": {
        "Automation": {
            "DocumentVersion": "3",
            "Parameters": {
                "instanceid": [
                    "{{TARGET_ID}}"
                ]
            }
        }
    }
| | **`LAMBDA`** | `ClientContext`
`Payload`
`Qualifier` | 
"TaskInvocationParameters": {
        "Lambda": {
            "ClientContext": "ew0KICAi--truncated--0KIEXAMPLE",
            "Payload": "{ \"targetId\": \"{{TARGET_ID}}\", \"targetType\": \"{{TARGET_TYPE}}\" }",
            "Qualifier": "$LATEST"
        }
    }
| | **`STEP_FUNCTIONS`** | `Input`
`Name` | 
"TaskInvocationParameters": {
        "StepFunctions": {
            "Input": "{ \"targetId\": \"{{TARGET_ID}}\" }",
            "Name": "{{INVOCATION_ID}}"
        }
    }
|