SSM Agent용 EC2 인스턴스에 수동으로 Windows Server 설치 및 제거 - AWS Systems Manager
Windows Server용 EC2 인스턴스에 SSM Agent 설치

SSM Agent용 EC2 인스턴스에 수동으로 Windows Server 설치 및 제거

AWS Systems Manager 에이전트(SSM Agent)는 Amazon에서 제공하는 다음 Windows Server용 Amazon Machine Images(AMIs)에 기본적으로 사전 설치되어 있습니다.

  • Windows Server 2012 R2 AMIs는 2016년 11월 이후에 게시되었습니다.

  • Windows Server 2016, 2019 및 2022(Nano 버전 제외) 및 2025

Windows Server용 EC2 인스턴스에 SSM Agent 설치

필요할 경우 다음 절차에 따라 최신 버전의 SSM Agent를 Windows Server용 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스에 수동으로 다운로드하여 설치할 수 있습니다. 이 절차에서 제공되는 명령은 사용자 데이터를 통해 Amazon EC2 인스턴스에 스크립트로 전달될 수도 있습니다.

Windows Server 인스턴스에서 레거시 AWS-ApplyPatchBaseline 문서와 같은 특정 AWS Systems Manager 문서(SSM 문서)를 실행하려면 SSM Agent에 Windows PowerShell 3.0 이상이 필요합니다. Windows Server 인스턴스에서 Windows Management Framework 3.0 이상을 실행하고 있는지 확인합니다. 이 프레임워크에는 Windows PowerShell이 들어 있습니다. 자세한 내용은 Windows Management Framework 3.0을 참조하세요.

다른 머신 유형에 설치

이 주제의 절차는 특히 Windows Server용 EC2 인스턴스에 SSM Agent를 설치 또는 재설치하는 데 적용됩니다. 온프레미스 서버, 가상 머신 또는 EC2 외의 기타 환경에서는 하이브리드 Windows Server 노드에 SSM Agent 설치에 설명된 대로 ssm-setup-cli 도구를 사용합니다.

EC2 외의 시스템에서 EC2 설치 절차를 사용하면 보안 취약성이 발생할 수 있습니다. 이 ssm-setup-cli 도구는 EC2 외의 시스템에 대한 추가 보안 보호를 제공합니다.

Windows Server에 대한 EC2 인스턴스에 최신 버전의 SSM Agent를 수동으로 설치하려면

  1. 원격 데스크톱이나 Windows PowerShell을 사용하여 인스턴스에 연결합니다. 자세한 내용은 Amazon EC2 사용 설명서의 인스턴스에 연결을 참조하세요.

  2. 인스턴스에 최신 버전의 SSM Agent를 다운로드합니다. PowerShell 명령 또는 직접 다운로드 링크를 사용하여 다운로드할 수 있습니다.

    참고

    이 단계의 URL을 사용하면 모든 AWS 리전에서 SSM Agent를 다운로드할 수 있습니다. 특정 리전의 에이전트를 다운로드하려는 경우 대신에 다음과 같은 리전별 URL을 사용합니다.

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

    리전은 미국 동부(오하이오) 리전의 us-east-2 같이 AWS Systems Manager이 지원하는 AWS 리전의 식별자를 나타냅니다. 지원되는 리전 값 목록은 Amazon Web Services 일반 참조의 Systems Manager 서비스 엔드포인트에 있는 리전 열을 참조하세요.

    PowerShell

    다음 세 개의 PowerShell 명령을 순서대로 실행합니다. 이 명령을 사용하면 IE(Internet Explorer) 보안 강화 설정을 조정하지 않고 SSM Agent를 다운로드한 다음 에이전트를 설치하고 설치 파일을 제거할 수 있습니다.

    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
    직접 다운로드

    다음 링크를 사용하여 SSM Agent의 최신 버전을 인스턴스에 다운로드하세요. 원하는 경우 AWS 리전별 URL로 이 URL을 업데이트합니다.

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

    다운로드한 AmazonSSMAgentSetup.exe 파일을 실행하여 SSM Agent를 설치합니다.

  3. PowerShell에서 다음 명령을 전송하여 SSM Agent를 시작하거나 다시 시작합니다.

    Restart-Service AmazonSSMAgent
참고

Windows Server 인스턴스에서 SSM Agent를 제거하려면 제어판, 프로그램을 엽니다. Uninstall a program(프로그램 제거) 옵션을 선택합니다. Amazon SSM Agent를 마우스 오른쪽 버튼으로 클릭하여 컨텍스트 메뉴를 열고 Uninstall(제거)을 선택합니다.