Ejecución de comandos mediante una versión de documento específica - AWS Systems Manager

Ejecución de comandos mediante una versión de documento específica

Puede utilizar el parámetro document-version para especificar la versión de un documento de AWS Systems Manager que se va a usar cuando se ejecute el comando. Puede especificar una de las opciones siguientes para este parámetro:

  • $DEFAULT

  • $LATEST

  • Número de versión

Lleve a cabo el siguiente procedimiento para ejecutar un comando utilizando el parámetro de versión del documento.

Linux
Para ejecutar comandos mediante la AWS CLI en equipos locales con Linux

  1. Si aún no lo ha hecho, instale y configure la AWS Command Line Interface (AWS CLI).

    Para obtener más información, consulte Instalación o actualización de la última versión de la AWS CLI.

  2. Enumerar todos los documentos disponibles

    Este comando enumera todos los documentos disponibles para su cuenta en función de los permisos de AWS Identity and Access Management (IAM).

    aws ssm list-documents

  3. Ejecute el siguiente comando para ver las diferentes versiones de un documento. Reemplace el nombre del documento con su propia información.

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

  4. Utilice el siguiente comando para ejecutar un comando que utilice una versión del documento de SSM. Reemplace cada example resource placeholder con su propia información.

    aws ssm send-command \
    --document-name "AWS-RunShellScript" \
    --parameters commands="echo Hello" \
    --instance-ids instance-ID \
    --document-version '$LATEST'
Windows
Para ejecutar comandos mediante la AWS CLI en equipos locales con Windows

  1. Si aún no lo ha hecho, instale y configure la AWS Command Line Interface (AWS CLI).

    Para obtener más información, consulte Instalación o actualización de la última versión de la AWS CLI.

  2. Enumerar todos los documentos disponibles

    Este comando enumera todos los documentos disponibles para su cuenta en función de los permisos de AWS Identity and Access Management (IAM).

    aws ssm list-documents

  3. Ejecute el siguiente comando para ver las diferentes versiones de un documento. Reemplace el nombre del documento con su propia información.

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

  4. Utilice el siguiente comando para ejecutar un comando que utilice una versión del documento de SSM. Reemplace cada example resource placeholder con su propia información.

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

  1. Instale y configure Herramientas de AWS para PowerShell (Herramientas para Windows PowerShell), si aún no lo ha hecho.

    Para obtener más información, consulte Instalación de Herramientas de AWS para PowerShell.

  2. Enumerar todos los documentos disponibles

    Este comando enumera todos los documentos disponibles para su cuenta en función de los permisos de AWS Identity and Access Management (IAM).

    Get-SSMDocumentList

  3. Ejecute el siguiente comando para ver las diferentes versiones de un documento. Reemplace el nombre del documento con su propia información.

    Get-SSMDocumentVersionList `
    -Name "document name"

  4. Utilice el siguiente comando para ejecutar un comando que utilice una versión del documento de SSM. Reemplace cada example resource placeholder con su propia información.

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