Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Utilisation de `DescribeMaintenanceWindowTasks` avec une CLI Les exemples de code suivants illustrent comment utiliser `DescribeMaintenanceWindowTasks`. ------ #### [ CLI ] **AWS CLI** **Exemple 1 : répertorier toutes les tâches d’une fenêtre de maintenance** L’exemple `describe-maintenance-window-tasks` suivant répertorie toutes les tâches pour la fenêtre de maintenance spécifiée. ``` aws ssm describe-maintenance-window-tasks \ --window-id {{"mw-06cf17cbefEXAMPLE"}} ``` Sortie : ``` { "Tasks": [ { "WindowId": "mw-06cf17cbefEXAMPLE", "WindowTaskId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "TaskArn": "AWS-RestartEC2Instance", "TaskParameters": {}, "Type": "AUTOMATION", "Description": "Restarting EC2 Instance for maintenance", "MaxConcurrency": "1", "MaxErrors": "1", "Name": "My-Automation-Example-Task", "Priority": 0, "ServiceRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/ssm.amazonaws.com/AWSServiceRoleForAmazonSSM", "Targets": [ { "Key": "WindowTargetIds", "Values": [ "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" ] } ] }, { "WindowId": "mw-06cf17cbefEXAMPLE", "WindowTaskId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "TaskArn": "AWS-DisableS3BucketPublicReadWrite", "TaskParameters": {}, "Type": "AUTOMATION", "Description": "Automation task to disable read/write access on public S3 buckets", "MaxConcurrency": "10", "MaxErrors": "5", "Name": "My-Disable-S3-Public-Read-Write-Access-Automation-Task", "Priority": 0, "ServiceRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/ssm.amazonaws.com/AWSServiceRoleForAmazonSSM", "Targets": [ { "Key": "WindowTargetIds", "Values": [ "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" ] } ] } ] } ``` **Exemple 2 : Pour répertorier toutes les tâches d'une fenêtre de maintenance qui invoque AWS-RunPowerShellScript document de commande** L’exemple `describe-maintenance-window-tasks` suivant répertorie toutes les tâches de la fenêtre de maintenance spécifiée qui invoque le document de commande `AWS-RunPowerShellScript`. ``` aws ssm describe-maintenance-window-tasks \ --window-id {{"mw-ab12cd34eEXAMPLE"}} \ --filters {{"Key=TaskArn,Values=AWS-RunPowerShellScript"}} ``` Sortie : ``` { "Tasks": [ { "WindowId": "mw-ab12cd34eEXAMPLE", "WindowTaskId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE44444", "TaskArn": "AWS-RunPowerShellScript", "Type": "RUN_COMMAND", "Targets": [ { "Key": "WindowTargetIds", "Values": [ "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" ] } ], "TaskParameters": {}, "Priority": 1, "ServiceRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/ssm.amazonaws.com/AWSServiceRoleForAmazonSSM", "MaxConcurrency": "1", "MaxErrors": "1", "Name": "MyTask" } ] } ``` **Exemple 3 : pour répertorier toutes les tâches d’une fenêtre de maintenance dont la priorité est de 3** L’exemple `describe-maintenance-window-tasks` suivant liste toutes les tâches de la fenêtre de maintenance spécifiée qui ont une `Priority` de `3`. ``` aws ssm describe-maintenance-window-tasks \ --window-id {{"mw-ab12cd34eEXAMPLE"}} \ --filters {{"Key=Priority,Values=3"}} ``` Sortie : ``` { "Tasks": [ { "WindowId": "mw-ab12cd34eEXAMPLE", "WindowTaskId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE44444", "TaskArn": "AWS-RunPowerShellScript", "Type": "RUN_COMMAND", "Targets": [ { "Key": "WindowTargetIds", "Values": [ "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" ] } ], "TaskParameters": {}, "Priority": 3, "ServiceRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/ssm.amazonaws.com/AWSServiceRoleForAmazonSSM", "MaxConcurrency": "1", "MaxErrors": "1", "Name": "MyRunCommandTask" }, { "WindowId": "mw-ab12cd34eEXAMPLE", "WindowTaskId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE55555", "TaskArn": "AWS-RestartEC2Instance", "Type": "AUTOMATION", "Targets": [ { "Key": "WindowTargetIds", "Values": [ "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" ] } ], "TaskParameters": {}, "Priority": 3, "ServiceRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/ssm.amazonaws.com/AWSServiceRoleForAmazonSSM", "MaxConcurrency": "10", "MaxErrors": "5", "Name": "My-Automation-Task", "Description": "A description for my Automation task" } ] } ``` **Exemple 4 : pour répertorier toutes les tâches d’une fenêtre de maintenance qui ont une priorité de 1 et qui utilisent Run Command** Ce qui suit `describe-maintenance-window-tasks` L'exemple répertorie toutes les tâches pour la fenêtre de maintenance spécifiée qui ont un `Priority` de `1` et utilisez `Run Command`. ``` aws ssm describe-maintenance-window-tasks \ --window-id {{"mw-ab12cd34eEXAMPLE"}} \ --filters {{"Key=Priority,Values=1"}} {{"Key=TaskType,Values=RUN_COMMAND"}} ``` Sortie : ``` { "Tasks": [ { "WindowId": "mw-ab12cd34eEXAMPLE", "WindowTaskId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE44444", "TaskArn": "AWS-RunPowerShellScript", "Type": "RUN_COMMAND", "Targets": [ { "Key": "WindowTargetIds", "Values": [ "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" ] } ], "TaskParameters": {}, "Priority": 1, "ServiceRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/ssm.amazonaws.com/AWSServiceRoleForAmazonSSM", "MaxConcurrency": "1", "MaxErrors": "1", "Name": "MyRunCommandTask" } ] } ``` Pour plus d'informations, voir [Afficher des informations sur les fenêtres de maintenance (AWS CLI)](https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-cli-tutorials-describe.html) dans le *AWS Guide de l'utilisateur de Systems Manager*. + Pour plus de détails sur l'API, voir [DescribeMaintenanceWindowTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm/describe-maintenance-window-tasks.html) dans *AWS CLI Référence de commande*. ------ #### [ PowerShell ] **Outils pour PowerShell V4** **Exemple 1 : cet exemple répertorie toutes les tâches d’une fenêtre de maintenance.** ``` Get-SSMMaintenanceWindowTaskList -WindowId "mw-06cf17cbefcb4bf4f" ``` **Sortie** : ``` LoggingInfo : MaxConcurrency : 1 MaxErrors : 1 Priority : 10 ServiceRoleArn : arn:aws:iam::123456789012:role/MaintenanceWindowsRole Targets : {InstanceIds} TaskArn : AWS-RunShellScript TaskParameters : {[commands, Amazon.SimpleSystemsManagement.Model.MaintenanceWindowTaskParameterValueExpression]} Type : RUN_COMMAND WindowId : mw-06cf17cbefcb4bf4f WindowTaskId : a23e338d-ff30-4398-8aa3-09cd052ebf17 ``` + Pour plus de détails sur l'API, voir [DescribeMaintenanceWindowTasks](https://docs.aws.amazon.com/powershell/v4/reference) dans *Outils AWS pour PowerShell Référence de l'applet de commande (V4)*. **Outils pour PowerShell V5** **Exemple 1 : cet exemple répertorie toutes les tâches d’une fenêtre de maintenance.** ``` Get-SSMMaintenanceWindowTaskList -WindowId "mw-06cf17cbefcb4bf4f" ``` **Sortie** : ``` LoggingInfo : MaxConcurrency : 1 MaxErrors : 1 Priority : 10 ServiceRoleArn : arn:aws:iam::123456789012:role/MaintenanceWindowsRole Targets : {InstanceIds} TaskArn : AWS-RunShellScript TaskParameters : {[commands, Amazon.SimpleSystemsManagement.Model.MaintenanceWindowTaskParameterValueExpression]} Type : RUN_COMMAND WindowId : mw-06cf17cbefcb4bf4f WindowTaskId : a23e338d-ff30-4398-8aa3-09cd052ebf17 ``` + Pour plus de détails sur l'API, voir [DescribeMaintenanceWindowTasks](https://docs.aws.amazon.com/powershell/v5/reference) dans *Outils AWS pour PowerShell Référence de l'applet de commande (V5)*. ------ Pour une liste complète des AWS Guides du développeur du SDK et exemples de code, voir [L'utilisation de ce service avec AWS Kit SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.