• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # `aws:runCommand`: esecuzione di un comando su un'istanza gestita Esegue i comandi specificati. **Nota** L'automazione supporta solo l'*output* di un'operazione AWS Systems Manager Run Command. Un runbook può includere più operazioni Run Command, ma l'output è supportato solo per un'operazione alla volta. **Input** Questa operazione supporta la maggior parte dei parametri dell'operazione SendCommand. Per ulteriori informazioni, consulta [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 il documento di tipo Comando è di tua proprietà o AWS, specifica il nome del documento. Se stai usando un documento condiviso con te da un Account AWS differente, specifica il nome della risorsa Amazon (ARN) del documento. Per ulteriori informazioni sull'utilizzo di documenti condivisi, consulta [Utilizzo di documenti SSM condivisi](documents-ssm-sharing.md#using-shared-documents). Tipo: stringa Obbligatorio: sì InstanceIds L'istanza IDs in cui si desidera eseguire il comando. È possibile specificare un massimo di 50 IDs. È inoltre possibile utilizzare il parametro `{{RESOURCE_ID}}` pseudo al posto dell'istanza IDs per eseguire il comando su tutte le istanze del gruppo di destinazione. Per ulteriori informazioni sugli pseudoparametri, consulta [Utilizzo degli pseudo parametri durante la registrazione delle attività della finestra di manutenzione](maintenance-window-tasks-pseudo-parameters.md). Un'altra alternativa consiste nell'inviare comandi a un parco istanze utilizzando il parametro `Targets`. Il parametro `Targets` accetta i tag di Amazon Elastic Compute Cloud (Amazon EC2). Per ulteriori informazioni su come utilizzare il parametro `Targets`, consulta [Esecuzione di comandi su vasta scala](send-commands-multiple.md). Tipo: StringList Obbligatorio: No (se non si specifica InstanceIds o non si utilizza il parametro `{{RESOURCE_ID}}` pseudo, è necessario specificare il parametro). `Targets` Targets Una matrice di criteri di ricerca che individua le istanze utilizzando una combinazione Chiave e Valore specificata dall'utente. `Targets`è obbligatorio se non si forniscono una o più istanze IDs nella chiamata. Per ulteriori informazioni su come utilizzare il parametro `Targets`, consulta [Esecuzione di comandi su vasta scala](send-commands-multiple.md). Tipo: MapList (Lo schema della mappa nell'elenco deve corrispondere all'oggetto.) Per ulteriori informazioni, consulta [Target](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_Target.html) (Destinazione) nella *Documentazione di riferimento dell'API di AWS Systems Manager *. Obbligatorio: No (se non si specifica`Targets`, è necessario specificare InstanceIds o utilizzare lo `{{RESOURCE_ID}}` pseudo parametro.) Di seguito è riportato un esempio. ``` - 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 Parametri obbligatori e facoltativi specificati nel documento. Tipo: Map Obbligatorio: no CloudWatchOutputConfig Opzioni di configurazione per l'invio dell'output dei comandi ad Amazon CloudWatch Logs. Per ulteriori informazioni sull'invio dell'output del comando a CloudWatch Logs, consulta. [Configurazione di Amazon CloudWatch Logs per Run Command](sysman-rc-setting-up-cwlogs.md) Tipo: StringMap (Lo schema della mappa deve corrispondere all'oggetto. Per ulteriori informazioni, [CloudWatchOutputConfig](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_CloudWatchOutputConfig.html)consulta l'*AWS Systems Manager API Reference*). Obbligatorio: no Di seguito è riportato un esempio. ``` - 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 Informazioni definite dall'utente sul comando. ▬Tipo: stringa Obbligatorio: no DocumentHash Hash del documento. ▬Tipo: stringa Obbligatorio: no DocumentHashType Tipo di hash. Tipo: String Valori validi: `Sha256` \$1 `Sha1` Obbligatorio: no NotificationConfig Configurazioni per l'invio delle notifiche. Obbligatorio: no OutputS3 BucketName Nome del bucket S3 per le risposte dell'output del comando. Il nodo gestito deve disporre delle autorizzazioni, affinché il bucket S3 registri correttamente l'output. ▬Tipo: stringa Obbligatorio: no OutputS3 KeyPrefix Prefisso. ▬Tipo: stringa Obbligatorio: no ServiceRoleArn L'ARN del ruolo AWS Identity and Access Management (IAM). ▬Tipo: stringa Obbligatorio: no TimeoutSeconds La quantità di tempo, in secondi, di attesa per l'invio di un comando AWS Systems Manager SSM Agent su un'istanza. Se il comando non viene ricevuto da SSM Agent sull'istanza prima che venga raggiunto il valore specificato, lo stato del comando cambia in `Delivery Timed Out`. Tipo: Integer Obbligatorio: no Valori validi: 30-2592000Output CommandId ID del comando. Status Stato del comando. ResponseCode Codice di risposta del comando. Se il documento eseguito presenta più di un passaggio, non viene restituito un valore per questo output. Output Output del comando. Se il comando è rivolto a un tag o a più istanze, non viene restituito alcun valore di output. È possibile utilizzare le operazioni API `GetCommandInvocation` e `ListCommandInvocations` per recuperare l'output di singole istanze.