Exécution de commandes à l'aide d'une version de document spécifique - AWS Systems Manager

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.

Exécution de commandes à l'aide d'une version de document spécifique

Vous pouvez utiliser le paramètre document-version pour spécifier la version d'un document AWS Systems Manager à utiliser lors de l'exécution de la commande. Vous pouvez spécifier l'une des options suivantes pour ce paramètre :

  • $DEFAULT

  • $LATEST

  • Version number

Appliquez la procédure suivante pour exécuter une commande à l'aide du paramètre document-version.

Linux
Pour exécuter des commandes à l'aide de AWS CLI sur des machines Linux locales

  1. Si vous ne l'avez pas déjà fait, installez et configurez l'AWS Command Line Interface (AWS CLI).

    Pour de plus amples informations, consultez Installation ou mise à jour de la version la plus récente de l'AWS CLI.

  2. Répertorier tous les documents disponibles

    Cette commande répertorie tous les documents disponibles pour votre compte en fonction des autorisations AWS Identity and Access Management (IAM).

    aws ssm list-documents

  3. Utilisez la commande suivante pour afficher les différentes versions d'un document. Remplacez document name (nom du document) avec vos propres informations.

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

  4. Exécutez la commande suivante pour exécuter une commande qui utilise une version de document SSM. Remplacez chaque example resource placeholder (espace réservé pour les ressources) avec vos propres informations.

    aws ssm send-command \
    --document-name "AWS-RunShellScript" \
    --parameters commands="echo Hello" \
    --instance-ids instance-ID \
    --document-version '$LATEST'
Windows
Pour exécuter des commandes à l'aide de AWS CLI sur des machines Windows locales

  1. Si vous ne l'avez pas déjà fait, installez et configurez l'AWS Command Line Interface (AWS CLI).

    Pour de plus amples informations, consultez Installation ou mise à jour de la version la plus récente de l'AWS CLI.

  2. Répertorier tous les documents disponibles

    Cette commande répertorie tous les documents disponibles pour votre compte en fonction des autorisations AWS Identity and Access Management (IAM).

    aws ssm list-documents

  3. Utilisez la commande suivante pour afficher les différentes versions d'un document. Remplacez document name (nom du document) avec vos propres informations.

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

  4. Exécutez la commande suivante pour exécuter une commande qui utilise une version de document SSM. Remplacez chaque example resource placeholder (espace réservé pour les ressources) avec vos propres informations.

    aws ssm send-command ^
    --document-name "AWS-RunShellScript" ^
    --parameters commands="echo Hello" ^
    --instance-ids instance-ID ^
    --document-version "$LATEST"
PowerShell
Pour exécuter des commandes avec les Tools for PowerShell

  1. Si vous ne l'avez pas déjà fait, installez et configurez AWS Tools for PowerShell (outils pour Windows PowerShell).

    Pour plus d'informations, consultez Installation d'AWS Tools for PowerShell.

  2. Répertorier tous les documents disponibles

    Cette commande répertorie tous les documents disponibles pour votre compte en fonction des autorisations AWS Identity and Access Management (IAM).

    Get-SSMDocumentList

  3. Utilisez la commande suivante pour afficher les différentes versions d'un document. Remplacez document name (nom du document) avec vos propres informations.

    Get-SSMDocumentVersionList `
    -Name "document name"

  4. Exécutez la commande suivante pour exécuter une commande qui utilise une version de document SSM. Remplacez chaque example resource placeholder (espace réservé pour les ressources) avec vos propres informations.

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