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 2008-2012 R2 AMIs publicadas em novembro de 2016 ou mais tarde

• Windows Server 2016, 2019 e 2022

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.

nota

Este procedimento se aplica à instalação ou reinstalação do SSM Agent em uma instância do EC2 para o Windows Server. Se for necessário instalar o agente em um servidor ou em uma máquina virtual (VM) on-premises para que ele possa ser usado com o Systems Manager, consulte Como instalar o SSM Agent para nós híbridos do Windows.

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"

   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

Desinstalar o SSM Agent das instâncias do EC2 para Windows Server

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).