Instalar e desinstalar o SSM Agent manualmente em instâncias do EC2 para Windows Server

O AWS Systems Manager Agent (SSM Agent) é pré-instalado, por padrão, nas seguintes Amazon Machine Images (AMIs) para Windows Server, fornecidas pela Amazon:

• Windows Server 2012 R2 AMIs publicadas em novembro de 2016 ou mais tarde

• Windows Server 2016, 2019, 2022 (exceto versões Nano) e 2025

Instalar o SSM Agent em instâncias do EC2 para Windows Server

Se necessário, você pode fazer download e instalar manualmente a versão mais recente do SSM Agent na instância do Amazon Elastic Compute Cloud (Amazon EC2 para Windows Server usando o procedimento a seguir. Os comandos fornecidos neste procedimento também podem ser passados para instâncias do Amazon EC2 como scripts por meio de dados do usuário.

O SSM Agent requer o Windows PowerShell 3.0 ou posterior para executar determinados documentos do AWS Systems Manager (documentos SSM) em instâncias Windows Server (por exemplo, o documento AWS-ApplyPatchBaseline herdado). Verifique se as suas instâncias do Windows Server estão executando o Windows Management Framework 3.0 ou posterior. Esse framework inclui o Windows PowerShell. Para obter mais informações, consulte o Windows Management Framework 3.0.

Instalação em outros tipos de máquinas

Este procedimento neste tópico se aplica à instalação ou reinstalação do SSM Agent em uma instância do EC2 para o Windows Server. Para servidores on-premises, máquinas virtuais ou outros ambientes não EC2, use a ferramenta ssm-setup-cli conforme descrito em Instalar o SSM Agent em nós híbridos do Windows Server.

O uso de procedimentos de instalação do EC2 em sistemas não EC2 pode potencialmente resultar em vulnerabilidades de segurança. A ferramenta ssm-setup-cli fornece proteções de segurança adicionais para máquinas que não são EC2.

Para instalar manualmente a versão mais recente do SSM Agent em instâncias do EC2 para o Windows Server

1. Conecte-se à sua instância usando a área de trabalho remota ou o Windows PowerShell. Para obter mais informações, consulte Conectar-se à sua instância no Guia do usuário do Amazon EC2.

2. Faça download da versão mais recente do SSM Agent para sua instância. Você pode fazer download usando os comandos do PowerShell ou um link de download direto.

   nota

   Os URLs nesta etapa permitem que você baixe o SSM Agent de qualquer Região da AWS. Para fazer download do agente de uma região específica, em vez disso, use um URL específico da região:

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

   A região representa o identificador da região para uma região da Região da AWS compatível com o AWS Systems Manager, como us-east-2 para a região Leste dos EUA (Ohio). Para ver uma lista dos valores de região com suporte, consulte a coluna Region em Systems Manager service endpoints no Referência geral da Amazon Web Services.

   PowerShell

   Execute os três comandos do PowerShell a seguir em ordem. Esses comandos permitem que você faça download do SSM Agent sem ajustar as configurações de Segurança Avançada do Internet Explorer (IE) e, depois, instale o agente e remova o arquivo de instalação.

   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" `
       -Wait

   rm -Force $env:USERPROFILE\Desktop\SSMAgent_latest.exe

   Download direto

   Faça download da versão mais recente do SSM Agent para sua instância usando o link a seguir. Se preferir, substitua esse URL por um URL específico da Região da AWS.

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

   Execute o arquivo AmazonSSMAgentSetup.exe obtido por download para instalar o SSM Agent.

3. Inicie ou reinicie o SSM Agent enviando o seguinte comando no PowerShell:

   Restart-Service AmazonSSMAgent

nota

Para desinstalar o SSM Agent de uma instância do Windows Server abra o Painel de Controle, Programas. Escolha a opção Uninstall a program (Desinstalar um programa). Abra o menu contextual (clique com o botão direito) para o Amazon SSM Agent e escolha Uninstall (Desinstalar).