In diesem Tutorial sind Befehle enthalten, mit denen Sie Ihre Wartungsfenster, Aufgaben, Ausführungen und Aufrufe aktualisieren oder Informationen darüber abrufen können. Die Beispiele sind nach Befehl geordnet, um zu zeigen, wie Befehlsoptionen verwendet werden, um nach der Art von Details zu filtern, die Sie anzeigen möchten.
Wenn Sie die Schritte in diesem Tutorial ausführen, ersetzen Sie die Werte in kursiv-rotem
Text durch Ihren eigenen Optionen und IDs. Ersetzen Sie z. B. die Wartungsfenster-ID MW-0C50858D01Beispiel
und die Instance-ID i-02573CafcfBeispiel
mit IDs der Ressourcen, die Sie erstellen.
Weitere Informationen zum Einrichten und Konfigurieren der AWS Command Line Interface (AWS CLI), finden Sie unter Installation, Aktualisierung und Deinstallation von AWS CLI und Konfigurieren der AWS CLI.
Befehlsbeispiele
- Beispiele für 'describe-maintenance-windows' (wartungsfenster-beschreiben)
- Beispiele für 'describe-maintenance-windows' (wartungsfenster-ziele-beschreiben)
- Beispiele für 'describe-maintenance-windows' (wartungsfenster-aufgaben-beschreiben)
- Beispiele für 'describe-maintenance-windows' (wartungsfenster-für-ziele-beschreiben)
- Beispiele für 'describe-maintenance-windows' (wartungsfenster-ausführungen-beschreiben)
- Beispiele für 'describe-maintenance-windows' (wartungsfenster-zeitplan-beschreiben)
Beispiele für 'describe-maintenance-windows' (wartungsfenster-beschreiben)
Alle Wartungsfenster in Ihrem AWS-Konto aufführen
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-windows
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "WindowIdentities":[ { "WindowId":"mw-0c50858d01EXAMPLE", "Name":"My-First-Maintenance-Window", "Enabled":true, "Duration":2, "Cutoff":0, "NextExecutionTime": "2019-05-18T17:01:01.137Z" }, { "WindowId":"mw-9a8b7c6d5eEXAMPLE", "Name":"My-Second-Maintenance-Window", "Enabled":true, "Duration":4, "Cutoff":1, "NextExecutionTime": "2019-05-30T03:30:00.137Z" }, ] }
Alle aktivierten Wartungsfenster aufführen
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-windows --filters "Key=Enabled,Values=true"
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "WindowIdentities":[ { "WindowId":"mw-0c50858d01EXAMPLE", "Name":"My-First-Maintenance-Window", "Enabled":true, "Duration":2, "Cutoff":0, "NextExecutionTime": "2019-05-18T17:01:01.137Z" }, { "WindowId":"mw-9a8b7c6d5eEXAMPLE", "Name":"My-Second-Maintenance-Window", "Enabled":true, "Duration":4, "Cutoff":1, "NextExecutionTime": "2019-05-30T03:30:00.137Z" }, ] }
Alle deaktivierten Wartungsfenster aufführen
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-windows --filters "Key=Enabled,Values=false"
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "WindowIdentities": [ { "WindowId": "mw-6e5c9d4b7cEXAMPLE", "Name": "My-Disabled-Maintenance-Window", "Enabled": false, "Duration": 2, "Cutoff": 1 } ] }
Alle Wartungsfenster aufführen, deren Name mit einem bestimmten Präfix beginnt
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-windows --filters "Key=Name,Values=My
"
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "WindowIdentities": [ { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "My-First-Maintenance-Window", "Enabled": true, "Duration": 2, "Cutoff": 0, "NextExecutionTime": "2019-05-18T17:01:01.137Z" }, { "WindowId": "mw-9a8b7c6d5eEXAMPLE", "Name": "My-Second-Maintenance-Window", "Enabled": true, "Duration": 4, "Cutoff": 1, "NextExecutionTime": "2019-05-30T03:30:00.137Z" }, { "WindowId": "mw-6e5c9d4b7cEXAMPLE", "Name": "My-Disabled-Maintenance-Window", "Enabled": false, "Duration": 2, "Cutoff": 1 } ] }
Beispiele für 'describe-maintenance-windows' (wartungsfenster-ziele-beschreiben)
Die Ziele für ein Wartungsfenster anzeigen, das einem bestimmten Eigentümer-Informationswert entspricht
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-window-targets \
--window-id "mw-6e5c9d4b7cEXAMPLE
" \
--filters "Key=OwnerInformation,Values=CostCenter1
"
Anmerkung
Die unterstützten Filterschlüssel sind Type
, WindowTargetId
und OwnerInformation
.
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "Targets": [ { "WindowId": "mw-0c50858d01EXAMPLE", "WindowTargetId": "e32eecb2-646c-4f4b-8ed1-205fbEXAMPLE", "ResourceType": "INSTANCE", "Targets": [ { "Key": "tag:Name", "Values": [ "Production" ] } ], "OwnerInformation": "CostCenter1", "Name": "Target1" } ] }
Beispiele für 'describe-maintenance-windows' (wartungsfenster-aufgaben-beschreiben)
Alle registrierten Aufgaben anzeigen, die das SSM-Befehlsdokument AWS-RunPowerShellScript
aufrufen
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-window-tasks \
--window-id "mw-0c50858d01EXAMPLE
" \
--filters "Key=TaskArn,Values=AWS-RunPowerShellScript"
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "Tasks":[ { "ServiceRoleArn": "arn:aws:iam::111122223333:role/MyMaintenanceWindowServiceRole", "MaxErrors":"1", "TaskArn":"AWS-RunPowerShellScript", "MaxConcurrency":"1", "WindowTaskId":"4f7ca192-7e9a-40fe-9192-5cb15EXAMPLE", "TaskParameters":{ "commands":{ "Values":[ "driverquery.exe" ] } }, "Priority":3, "Type":"RUN_COMMAND", "Targets":[ { "TaskTargetId":"i-02573cafcfEXAMPLE", "TaskTargetType":"INSTANCE" } ] }, { "ServiceRoleArn":"arn:aws:iam::111122223333:role/MyMaintenanceWindowServiceRole", "MaxErrors":"1", "TaskArn":"AWS-RunPowerShellScript", "MaxConcurrency":"1", "WindowTaskId":"4f7ca192-7e9a-40fe-9192-5cb15EXAMPLE", "TaskParameters":{ "commands":{ "Values":[ "ipconfig" ] } }, "Priority":1, "Type":"RUN_COMMAND", "Targets":[ { "TaskTargetId":"i-02573cafcfEXAMPLE", "TaskTargetType":"WINDOW_TARGET" } ] } ] }
Alle registrierten Aufgaben mit Priorität 3 anzeigen
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-window-tasks \
--window-id "mw-9a8b7c6d5eEXAMPLE
" \
--filters "Key=Priority,Values=3
"
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "Tasks":[ { "ServiceRoleArn":"arn:aws:iam::111122223333:role/MyMaintenanceWindowServiceRole", "MaxErrors":"1", "TaskArn":"AWS-RunPowerShellScript", "MaxConcurrency":"1", "WindowTaskId":"4f7ca192-7e9a-40fe-9192-5cb15EXAMPLE", "TaskParameters":{ "commands":{ "Values":[ "driverquery.exe" ] } }, "Priority":3, "Type":"RUN_COMMAND", "Targets":[ { "TaskTargetId":"i-02573cafcfEXAMPLE", "TaskTargetType":"INSTANCE" } ] } ] }
Alle registrierten Aufgaben anzeigen, die Priorität "1" haben und Run Command verwenden
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-window-tasks \
--window-id "mw-0c50858d01EXAMPLE
" \
--filters "Key=Priority,Values=1
" "Key=TaskType,Values=RUN_COMMAND"
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "Tasks": [ { "WindowId": "mw-0c50858d01EXAMPLE", "WindowTaskId": "4f7ca192-7e9a-40fe-9192-5cb15EXAMPLE", "TaskArn": "AWS-RunShellScript", "Type": "RUN_COMMAND", "Targets": [ { "Key": "InstanceIds", "Values": [ "i-02573cafcfEXAMPLE" ] } ], "TaskParameters": {}, "Priority": 1, "ServiceRoleArn": "arn:aws:iam::111122223333:role/MyMaintenanceWindowServiceRole", "MaxConcurrency": "1", "MaxErrors": "1" }, { "WindowId": "mw-0c50858d01EXAMPLE", "WindowTaskId": "8a5c4629-31b0-4edd-8aea-33698EXAMPLE", "TaskArn": "AWS-UpdateSSMAgent", "Type": "RUN_COMMAND", "Targets": [ { "Key": "InstanceIds", "Values": [ "i-0471e04240EXAMPLE" ] } ], "TaskParameters": {}, "Priority": 1, "ServiceRoleArn": "arn:aws:iam::111122223333:role/MyMaintenanceWindowServiceRole", "MaxConcurrency": "1", "MaxErrors": "1", "Name": "My-Run-Command-Task", "Description": "My Run Command task to update SSM Agent on an instance" } ] }
Beispiele für 'describe-maintenance-windows' (wartungsfenster-für-ziele-beschreiben)
Informationen über die Wartungsfensterziele oder -Aufgaben im Zusammenhang mit einem bestimmten Knoten aufführen
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-windows-for-target \
--resource-type INSTANCE \
--targets "Key=InstanceIds,Values=i-02573cafcfEXAMPLE" \
--max-results 10
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "WindowIdentities": [ { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "My-First-Maintenance-Window" }, { "WindowId": "mw-9a8b7c6d5eEXAMPLE", "Name": "My-Second-Maintenance-Window" } ] }
Beispiele für 'describe-maintenance-windows' (wartungsfenster-ausführungen-beschreiben)
Alle Aufgaben aufführen, die vor einem bestimmten Datum ausgeführt wurden
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-window-executions \
--window-id "mw-9a8b7c6d5eEXAMPLE
" \
--filters "Key=ExecutedBefore,Values=2019-05-12T05:00:00Z
"
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "WindowExecutions": [ { "WindowId": "mw-0c50858d01EXAMPLE", "WindowExecutionId": "14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE", "Status": "FAILED", "StatusDetails": "The following SSM parameters are invalid: LevelUp", "StartTime": 1557617747.993, "EndTime": 1557617748.101 }, { "WindowId": "mw-9a8b7c6d5eEXAMPLE", "WindowExecutionId": "791b72e0-f0da-4021-8b35-f95dfEXAMPLE", "Status": "SUCCESS", "StartTime": 1557594085.428, "EndTime": 1557594090.978 }, { "WindowId": "mw-0c50858d01EXAMPLE", "WindowExecutionId": "ecec60fa-6bb0-4d26-98c7-140308EXAMPLE", "Status": "SUCCESS", "StartTime": 1557593793.483, "EndTime": 1557593798.978 } ] }
Alle Aufgaben aufführen, die nach einem bestimmten Datum ausgeführt wurden
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-window-executions \
--window-id "mw-9a8b7c6d5eEXAMPLE
" \
--filters "Key=ExecutedAfter,Values=2018-12-31T17:00:00Z
"
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "WindowExecutions": [ { "WindowId": "mw-0c50858d01EXAMPLE", "WindowExecutionId": "14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE", "Status": "FAILED", "StatusDetails": "The following SSM parameters are invalid: LevelUp", "StartTime": 1557617747.993, "EndTime": 1557617748.101 }, { "WindowId": "mw-9a8b7c6d5eEXAMPLE", "WindowExecutionId": "791b72e0-f0da-4021-8b35-f95dfEXAMPLE", "Status": "SUCCESS", "StartTime": 1557594085.428, "EndTime": 1557594090.978 }, { "WindowId": "mw-0c50858d01EXAMPLE", "WindowExecutionId": "ecec60fa-6bb0-4d26-98c7-140308EXAMPLE", "Status": "SUCCESS", "StartTime": 1557593793.483, "EndTime": 1557593798.978 } ] }
Beispiele für 'describe-maintenance-windows' (wartungsfenster-zeitplan-beschreiben)
Die nächsten zehn Wartungsfenster-Ausführungen, die für einen bestimmten Knoten geplant sind, anzeigen
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-window-schedule \
--resource-type INSTANCE \
--targets "Key=InstanceIds,Values=i-07782c72faEXAMPLE" \
--max-results 10
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "ScheduledWindowExecutions": [ { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "My-First-Maintenance-Window", "ExecutionTime": "2019-05-18T23:35:24.902Z" }, { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "My-First-Maintenance-Window", "ExecutionTime": "2019-05-25T23:35:24.902Z" }, { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "My-First-Maintenance-Window", "ExecutionTime": "2019-06-01T23:35:24.902Z" }, { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "My-First-Maintenance-Window", "ExecutionTime": "2019-06-08T23:35:24.902Z" }, { "WindowId": "mw-9a8b7c6d5eEXAMPLE", "Name": "My-Second-Maintenance-Window", "ExecutionTime": "2019-06-15T23:35:24.902Z" }, { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "My-First-Maintenance-Window", "ExecutionTime": "2019-06-22T23:35:24.902Z" }, { "WindowId": "mw-9a8b7c6d5eEXAMPLE", "Name": "My-Second-Maintenance-Window", "ExecutionTime": "2019-06-29T23:35:24.902Z" }, { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "My-First-Maintenance-Window", "ExecutionTime": "2019-07-06T23:35:24.902Z" }, { "WindowId": "mw-9a8b7c6d5eEXAMPLE", "Name": "My-Second-Maintenance-Window", "ExecutionTime": "2019-07-13T23:35:24.902Z" }, { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "My-First-Maintenance-Window", "ExecutionTime": "2019-07-20T23:35:24.902Z" } ], "NextToken": "AAEABUXdceT92FvtKld/dGHELj5Mi+GKW/EXAMPLE" }
Den Wartungsfenster-Zeitplan für Knoten anzeigen, die mit einem bestimmten Schlüssel-Wert-Paar markiert sind
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-window-schedule \
--resource-type INSTANCE \
--targets "Key=tag:prod,Values=rhel7"
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "ScheduledWindowExecutions": [ { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "DemoRateStartDate", "ExecutionTime": "2019-10-20T05:34:56-07:00" }, { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "DemoRateStartDate", "ExecutionTime": "2019-10-21T05:34:56-07:00" }, { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "DemoRateStartDate", "ExecutionTime": "2019-10-22T05:34:56-07:00" }, { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "DemoRateStartDate", "ExecutionTime": "2019-10-23T05:34:56-07:00" }, { "WindowId": "mw-0c50858d01EXAMPLE", "Name": "DemoRateStartDate", "ExecutionTime": "2019-10-24T05:34:56-07:00" } ], "NextToken": "AAEABccwSXqQRGKiTZ1yzGELR6cxW4W/EXAMPLE" }
Startzeiten für die nächsten vier Ausführungen eines Wartungsfensters anzeigen
Führen Sie den folgenden Befehl aus.
aws ssm describe-maintenance-window-schedule \
--window-id "mw-0c50858d01EXAMPLE
" \
--max-results "4"
Die vom System zurückgegebenen Informationen ähneln den Folgenden.
{ "WindowSchedule": [ { "ScheduledWindowExecutions": [ { "ExecutionTime": "2019-10-04T10:10:10Z", "Name": "My-First-Maintenance-Window", "WindowId": "mw-0c50858d01EXAMPLE" }, { "ExecutionTime": "2019-10-11T10:10:10Z", "Name": "My-First-Maintenance-Window", "WindowId": "mw-0c50858d01EXAMPLE" }, { "ExecutionTime": "2019-10-18T10:10:10Z", "Name": "My-First-Maintenance-Window", "WindowId": "mw-0c50858d01EXAMPLE" }, { "ExecutionTime": "2019-10-25T10:10:10Z", "Name": "My-First-Maintenance-Window", "WindowId": "mw-0c50858d01EXAMPLE" } ] } ] }