Instalando e desinstalando manualmente SSM Agent em instâncias do EC2 para Windows Server

AWS Systems Manager O agente (SSM Agent) é pré-instalado, por padrão, no seguinte Amazon Machine Images (AMIs) Windows Server fornecido pela Amazon:

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

• Windows Server 2016, 2019 e 2022

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

SSM Agentexige que o Windows PowerShell 3.0 ou posterior execute determinados AWS Systems Manager documentos (documentos SSM) em Windows Server instâncias (por exemplo, o AWS-ApplyPatchBaseline documento legado). Verifique se as suas instâncias do Windows Server estão executando o Windows Management Framework 3.0 ou posterior. Essa estrutura 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 você precisar instalar o agente em um servidor on-premises ou em uma máquina virtual (VM) para que ele possa ser usado com o Systems Manager, consulte Install SSM Agent for a hybrid environment (Windows) (Instalar o SSM Agent para um ambiente híbrido (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 à instância no Guia do usuário do Amazon EC2 para instâncias do Windows.

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

   nota

   Os URLs desta etapa permitem que você faça o download SSM Agent de qualquer Região da AWS um. 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

   region representa o identificador de uma região Região da AWS suportada por 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 PowerShell comandos 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 quiser, atualize esse URL com um URL Região da AWS específico.

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

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

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

   Restart-Service AmazonSSMAgent

Desinstale SSM Agent das instâncias do EC2 para Windows Server

Para desinstalar o SSM Agent de uma Windows Server instância, 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).