Installation et désinstallation manuelles de SSM Agent sur les instances EC2 pour Windows Server - AWS Systems Manager
Installer SSM Agent sur les instances EC2 pour Windows Server

Installation et désinstallation manuelles de SSM Agent sur les instances EC2 pour Windows Server

L'agent AWS Systems Manager (SSM Agent) est préinstallé par défaut sur les Amazon Machine Images (AMIs) suivantes pour Windows Server fourni par Amazon :

  • Les AMIs Windows Server 2008-2012 R2 publiées en novembre 2016 ou après

  • Windows Server 2016, 2019 et 2022 (à l’exception des versions Nano)

Installer SSM Agent sur les instances EC2 pour Windows Server

Si nécessaire, vous pouvez aussi télécharger et installer manuellement la version la plus récente de l'SSM Agent sur votre instance Amazon Elastic Compute Cloud (Amazon EC2) pour Windows Server à l'aide de la procédure suivante. Les commandes fournies dans cette procédure peuvent également être transmises aux instances Amazon EC2 sous forme de scripts via les données utilisateurs.

L'SSM Agent a besoin de Windows PowerShell 3.0 ou d'une version ultérieure pour exécuter certains documents AWS Systems Manager (documents SSM) sur des instances Windows Server (par exemple, le document AWS-ApplyPatchBaseline hérité). Vérifiez que vos instances Windows Server exécutent Windows Management Framework 3.0 ou version ultérieure. Ce framework inclut Windows PowerShell. Pour de plus amples informations, consultez Windows Management Framework 3.0.

Note

Cette procédure s'applique à l'installation ou la réinstallation de l'SSM Agent sur une instance EC2 pour Windows Server. Si vous devez installer l’agent sur un serveur sur site ou une machine virtuelle (VM) pour qu’il puisse être utilisé avec Systems Manager, consultez Comment installer le SSM Agent sur des nœuds Windows hybrides.

Pour installer manuellement la dernière version de l'SSM Agent sur les instances EC2 pour Windows Server

  1. Connectez-vous à votre instance en utilisant le Bureau à distance ou Windows PowerShell. Pour plus d’informations, consultez Se connecter à votre instance dans le Guide de l’utilisateur Amazon EC2.

  2. Téléchargez la version la plus récente de l'SSM Agent sur votre instance. Vous pouvez effectuer le téléchargement à l'aide de commandes PowerShell ou d'un lien de téléchargement direct.

    Note

    Les URL de cette étape vous permettent de télécharger l'SSM Agent à partir de n'importe quelle Région AWS. Si vous souhaitez télécharger l'agent à partir d'une région spécifique, utilisez plutôt une URL spécifique à la région :

    https://amazon-ssm-region.s3.region.amazonaws.com/latest/windows_amd64/AmazonSSMAgentSetup.exe

    region représente l'identifiant d'une Région AWS prise en charge par AWS Systems Manager, telle que us-east-2 pour la région USA Est (Ohio). Pour obtenir une liste des valeurs region prises en charge, consultez la colonne Région dans la rubrique Points de terminaison de service Systems Manager de la Référence générale d'Amazon Web Services.

    PowerShell

    Exécutez les trois commandes PowerShell suivantes dans l'ordre. Ces commandes vous permettent de télécharger l'SSM Agent sans ajuster les paramètres de sécurité renforcée d'Internet Explorer (IE), puis d'installer l'agent et de supprimer le fichier d'installation.

    64-bit
    [System.Net.ServicePointManager]::SecurityProtocol = 'TLS12'
$progressPreference = 'silentlyContinue'
Invoke-WebRequest `
    https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/windows_amd64/AmazonSSMAgentSetup.exe `
    -OutFile $env:USERPROFILE\Desktop\SSMAgent_latest.exe
    32-bit
    [System.Net.ServicePointManager]::SecurityProtocol = 'TLS12'
$progressPreference = 'silentlyContinue'
Invoke-WebRequest `
    https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/windows_386/AmazonSSMAgentSetup.exe `
    -OutFile $env:USERPROFILE\Desktop\SSMAgent_latest.exe
     
    Start-Process `
    -FilePath $env:USERPROFILE\Desktop\SSMAgent_latest.exe `
    -ArgumentList "/S"
    rm -Force $env:USERPROFILE\Desktop\SSMAgent_latest.exe
    Téléchargement direct

    Téléchargez la dernière version de l'SSM Agent sur votre instance en utilisant le lien suivant. Si vous le souhaitez, mettez à jour cette URL avec une URL spécifique à une Région AWS.

    https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/windows_amd64/AmazonSSMAgentSetup.exe

    Exécutez le fichier AmazonSSMAgentSetup.exe téléchargé pour installer SSM Agent.

  3. Démarrez ou redémarrez SSM Agent à l'aide de la commande PowerShell suivante : 

    Restart-Service AmazonSSMAgent
Note

Pour désinstaller l’SSM Agent depuis une instance Windows Server, ouvrez Panneau de configuration, Programmes. Choisissez l'option Uninstall a program (Désinstaller un programme). Ouvrez le menu contextuel (clic droit) pour Amazon SSM Agent et choisissez Uninstall (Désinstaller).