步驟 3：使用 向維護時段註冊任務 AWS CLI

向維護時段註冊任務

1. 在本機機器上執行以下命令。將每個範例資源預留位置取代為您自己的資訊。從本機 Windows 機器執行的版本包含逸出字元 (「/」)，您在透過命令列工具執行命令時會需要這些字元。

   Linux & macOS

   aws ssm register-task-with-maintenance-window \
       --window-id mw-0c50858d01EXAMPLE \
       --task-arn "AWS-RunShellScript" \
       --max-concurrency 1 --max-errors 1 \
       --priority 10 \
       --targets "Key=InstanceIds,Values=i-0471e04240EXAMPLE" \
       --task-type "RUN_COMMAND" \
       --task-invocation-parameters '{"RunCommand":{"Parameters":{"commands":["df"]}}}'

   Windows

   aws ssm register-task-with-maintenance-window ^
       --window-id mw-0c50858d01EXAMPLE ^
       --task-arn "AWS-RunShellScript" ^
       --max-concurrency 1 --max-errors 1 ^
       --priority 10 ^
       --targets "Key=InstanceIds,Values=i-02573cafcfEXAMPLE" ^
       --task-type "RUN_COMMAND" ^
       --task-invocation-parameters={\"RunCommand\":{\"Parameters\":{\"commands\":[\"df\"]}}}

   系統會傳回與以下相似的資訊：

   {
       "WindowTaskId": "4f7ca192-7e9a-40fe-9192-5cb15EXAMPLE"
   }

2. 立即執行以下命令來檢視與您建立之維護時段任務相關的詳細資訊。

   Linux & macOS

   aws ssm describe-maintenance-window-tasks \
       --window-id mw-0c50858d01EXAMPLE

   Windows

   aws ssm describe-maintenance-window-tasks ^
       --window-id mw-0c50858d01EXAMPLE

3. 系統會傳回與以下相似的資訊。

   {
       "Tasks": [
           {
               "WindowId": "mw-0c50858d01EXAMPLE",
               "WindowTaskId": "4f7ca192-7e9a-40fe-9192-5cb15EXAMPLE",
               "TaskArn": "AWS-RunShellScript",
               "Type": "RUN_COMMAND",
               "Targets": [
                   {
                       "Key": "InstanceIds",
                       "Values": [
                           "i-02573cafcfEXAMPLE"
                       ]
                   }
               ],
               "TaskParameters": {},
               "Priority": 10,
               "ServiceRoleArn": "arn:aws:iam::123456789012:role/MyMaintenanceWindowServiceRole",
               "MaxConcurrency": "1",
               "MaxErrors": "1"
           }
       ]
   }

4. 根據您在 步驟 1：使用 建立維護時段 AWS CLI 指定的排程，等到任務的執行時間。例如，如果您已指定 --schedule "rate(5 minutes)"，請等待五分鐘。然後執行以下命令，來檢視與此任務發生的任何執行所相關的資訊。

   Linux & macOS

   aws ssm describe-maintenance-window-executions \
       --window-id mw-0c50858d01EXAMPLE

   Windows

   aws ssm describe-maintenance-window-executions ^
       --window-id mw-0c50858d01EXAMPLE

   系統會傳回與以下相似的資訊。

   {
       "WindowExecutions": [
           {
               "WindowId": "mw-0c50858d01EXAMPLE",
               "WindowExecutionId": "14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE",
               "Status": "SUCCESS",
               "StartTime": 1557593493.096,
               "EndTime": 1557593498.611
           }
       ]
   }