• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). # `aws:runCommand` – Executa um comando em uma instância gerenciada Executa os comandos especificados. **nota** A automação comporta apenas a *output* de uma ação do AWS Systems Manager Run Command. Um runbook pode incluir várias ações do Run Command, mas apenas uma ação de cada vez pode gerar um output. **Input** Essa ação oferece suporte para a maioria dos parâmetros de comando de envio. Para obter mais informações, consulte [SendCommand](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_SendCommand.html). ------ #### [ YAML ] ``` - name: checkMembership action: 'aws:runCommand' inputs: DocumentName: AWS-RunPowerShellScript InstanceIds: - '{{InstanceIds}}' Parameters: commands: - (Get-WmiObject -Class Win32_ComputerSystem).PartOfDomain ``` ------ #### [ JSON ] ``` { "name": "checkMembership", "action": "aws:runCommand", "inputs": { "DocumentName": "AWS-RunPowerShellScript", "InstanceIds": [ "{{InstanceIds}}" ], "Parameters": { "commands": [ "(Get-WmiObject -Class Win32_ComputerSystem).PartOfDomain" ] } } } ``` ------ DocumentName Se o documento do tipo Comando for de sua propriedade ou da AWS, especifique o nome do documento. Se você estiver usando um documento compartilhado com você por uma Conta da AWSdiferente, especifique o nome do recurso da Amazon (ARN) do documento. Para obter mais informações sobre o uso de documentos compartilhados, consulte [Usar documentos compartilhados do](documents-ssm-sharing.md#using-shared-documents). Tipo: String Exigido: sim InstanceIds Os IDs de instâncias em que deseja que o comando seja executado. Você pode especificar um máximo de 50 IDs. Você também pode usar o pseudoparâmetro `{{RESOURCE_ID}}` no lugar de IDs de instância para executar o comando em todas as instâncias no grupo de destino. Para obter mais informações sobre pseudoparâmetros, consulte [Usar pseudoparâmetros ao registrar tarefas da janela de manutenção](maintenance-window-tasks-pseudo-parameters.md). Outra alternativa é enviar comandos para uma frota de instâncias usando o parâmetro `Targets`.. O parâmetro `Targets` aceita tags do Amazon Elastic Compute Cloud (Amazon EC2). Para obter mais informações sobre como usar o parâmetro `Targets`, consulte [Execução de comandos em escala](send-commands-multiple.md). Tipo: StringList Obrigatório: não (Se não especificar InstanceIds ou usar o pseudoparâmetro `{{RESOURCE_ID}}`, você deverá especificar o parâmetro `Targets`.) Targets Vários critérios de pesquisa que apontam para instâncias usando uma combinação de chave-valor especificada. As `Targets` serão necessárias se você não fornecer um ou mais IDs de instância na chamada. Para obter mais informações sobre como usar o parâmetro `Targets`, consulte [Execução de comandos em escala](send-commands-multiple.md). Tipo: MapList (o esquema do mapa na lista deve corresponder ao objeto). Para obter informações, consulte [Target](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_Target.html) na *Referência de API do AWS Systems Manager*. Obrigatório: não (Se não especificar `Targets`, você deverá especificar os IDs da instância ou usar o pseudoparâmetro `{{RESOURCE_ID}}`.) Veja um exemplo a seguir. ``` - name: checkMembership action: aws:runCommand inputs: DocumentName: AWS-RunPowerShellScript Targets: - Key: tag:Stage Values: - Gamma - Beta - Key: tag-key Values: - Suite Parameters: commands: - (Get-WmiObject -Class Win32_ComputerSystem).PartOfDomain ``` ``` { "name": "checkMembership", "action": "aws:runCommand", "inputs": { "DocumentName": "AWS-RunPowerShellScript", "Targets": [ { "Key": "tag:Stage", "Values": [ "Gamma", "Beta" ] }, { "Key": "tag:Application", "Values": [ "Suite" ] } ], "Parameters": { "commands": [ "(Get-WmiObject -Class Win32_ComputerSystem).PartOfDomain" ] } } } ``` Parameters Os parâmetros necessários e opcionais especificados no documento. Tipo: mapa Obrigatório: não CloudWatchOutputConfig Opções de configuração para enviar o output do comando para o Amazon CloudWatch Logs. Para obter mais informações sobre o envio do output do comando para o CloudWatch Logs, consulte [Configurar o Amazon CloudWatch Logs para Run Command](sysman-rc-setting-up-cwlogs.md). Tipo: StringMap (O esquema do mapa deve corresponder ao objeto. Para obter mais informações, consulte [CloudWatchOutputConfig](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_CloudWatchOutputConfig.html) na *Referência de API do AWS Systems Manager*). Obrigatório: não Veja um exemplo a seguir. ``` - name: checkMembership action: aws:runCommand inputs: DocumentName: AWS-RunPowerShellScript InstanceIds: - "{{InstanceIds}}" Parameters: commands: - "(Get-WmiObject -Class Win32_ComputerSystem).PartOfDomain" CloudWatchOutputConfig: CloudWatchLogGroupName: CloudWatchGroupForSSMAutomationService CloudWatchOutputEnabled: true ``` ``` { "name": "checkMembership", "action": "aws:runCommand", "inputs": { "DocumentName": "AWS-RunPowerShellScript", "InstanceIds": [ "{{InstanceIds}}" ], "Parameters": { "commands": [ "(Get-WmiObject -Class Win32_ComputerSystem).PartOfDomain" ] }, "CloudWatchOutputConfig" : { "CloudWatchLogGroupName": "CloudWatchGroupForSSMAutomationService", "CloudWatchOutputEnabled": true } } } ``` Comment Informações definidas pelo usuário sobre o comando. Tipo: string Obrigatório: não DocumentHash O hash do documento. Tipo: string Obrigatório: não DocumentHashType O tipo de hash. Tipo: string Valores válidos: `Sha256` \| `Sha1` Obrigatório: não NotificationConfig As configurações para enviar notificações. Obrigatório: não OutputS3BucketName O nome do bucket do S3 para as respostas do output dos comandos. Seu nó gerenciado deve ter permissões para o bucket do S3 para registrar o output com êxito. Tipo: string Obrigatório: não OutputS3KeyPrefix O prefixo. Tipo: string Obrigatório: não ServiceRoleArn O ARN da função do AWS Identity and Access Management (IAM). Tipo: string Obrigatório: não TimeoutSeconds O tempo, em segundos, para esperar que um comando seja entregue ao AWS Systems Manager SSM Agent em uma instância. Se o comando não for recebido pelo SSM Agent na instância antes que o valor especificado seja atingido, o status do comando mudará para `Delivery Timed Out`. Tipo: inteiro Obrigatório: não Valores válidos: 30 a 2592000Output CommandId O ID do comando. Status O status do comando. ResponseCode O código de resposta do comando. Se o documento executado tiver mais de uma etapa, nenhum valor será retornado para essa saída. Output O output do comando. Se você segmentar uma tag ou várias instâncias com seu comando, nenhum valor de output será retornado. Você pode usar as operações `GetCommandInvocation` e `ListCommandInvocations` da API para recuperar o output de instâncias individuais.