Execução de comandos usando uma versão específica de documento - AWS Systems Manager

Execução de comandos usando uma versão específica de documento

Você pode usar o parâmetro de versão de documento para especificar qual versão de um documento do AWS Systems Manager usar quando o comando for executado. Você pode especificar uma das seguintes opções para este parâmetro:

  • $DEFAULT

  • $LATEST

  • Número da versão

Execute o procedimento a seguir para executar um comando usando o parâmetro de versão do documento.

Linux
Como executar comandos usando a AWS CLI em máquinas Linux locais

  1. Instale e configure a AWS Command Line Interface (AWS CLI), caso ainda não o tenha feito.

    Para obter informações, consulte Instalar ou atualizar a versão mais recente da AWS CLI.

  2. Listar todos os documentos disponíveis

    Esse comando lista todos os documentos disponíveis para sua conta com base em permissões do AWS Identity and Access Management (IAM).

    aws ssm list-documents

  3. Execute o comando a seguir para visualizar as diferentes versões de um documento. Substitua nome do documento pelas próprias informações.

    aws ssm list-document-versions \
    --name "document name"

  4. Execute o comando a seguir para executar um comando que use uma versão do documento do SSM. Substitua cada espaço reservado para recurso de exemplo por suas próprias informações.

    aws ssm send-command \
    --document-name "AWS-RunShellScript" \
    --parameters commands="echo Hello" \
    --instance-ids instance-ID \
    --document-version '$LATEST'
Windows
Como executar comandos usando a AWS CLI em computadores Windows locais

  1. Instale e configure a AWS Command Line Interface (AWS CLI), caso ainda não o tenha feito.

    Para obter informações, consulte Instalar ou atualizar a versão mais recente da AWS CLI.

  2. Listar todos os documentos disponíveis

    Esse comando lista todos os documentos disponíveis para sua conta com base em permissões do AWS Identity and Access Management (IAM).

    aws ssm list-documents

  3. Execute o comando a seguir para visualizar as diferentes versões de um documento. Substitua nome do documento pelas próprias informações.

    aws ssm list-document-versions ^
    --name "document name"

  4. Execute o comando a seguir para executar um comando que use uma versão do documento do SSM. Substitua cada espaço reservado para recurso de exemplo por suas próprias informações.

    aws ssm send-command ^
    --document-name "AWS-RunShellScript" ^
    --parameters commands="echo Hello" ^
    --instance-ids instance-ID ^
    --document-version "$LATEST"
PowerShell
Para executar comandos usando as Tools for PowerShell

  1. Instale e configure o AWS Tools for PowerShell (Ferramentas para Windows PowerShell), caso ainda não o tenha feito.

    Para obter informações, consulte Instalar o AWS Tools for PowerShell.

  2. Listar todos os documentos disponíveis

    Esse comando lista todos os documentos disponíveis para sua conta com base em permissões do AWS Identity and Access Management (IAM).

    Get-SSMDocumentList

  3. Execute o comando a seguir para visualizar as diferentes versões de um documento. Substitua nome do documento pelas próprias informações.

    Get-SSMDocumentVersionList `
    -Name "document name"

  4. Execute o comando a seguir para executar um comando que use uma versão do documento do SSM. Substitua cada espaço reservado para recurso de exemplo por suas próprias informações.

    Send-SSMCommand `
    -DocumentName "AWS-RunShellScript" `
    -Parameter @{commands = "echo helloWorld"} `
    -InstanceIds "instance-ID" `
    -DocumentVersion $LATEST