AWS Systems Manager
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

在 Amazon EC2 Windows 实例上安装和配置 SSM 代理

在通过 Windows Server 2016 和 Windows Server 2019 Amazon 系统映像 (AMI) 创建的实例上,以及通过 2016 年 11 月或之后发布的 Windows Server 2003-2012 R2 AMI 创建的实例上,会默认安装 SSM 代理。

如果您的实例是在 2016 年 11 月之前 创建的 Windows Server 2003-2012 R2 实例,则 EC2Config 在您的实例上处理 Systems Manager 请求。我们建议您升级现有实例以使用最新版本的 EC2Config。您可以使用最新的 EC2Config 安装程序,在安装 EC2Config 的同时安装 SSM 代理。此并行版本 SSM 代理与通过之前的 Windows AMI 创建的实例兼容,借助此代理,您能够使用 2016 年 11 月之后发布的 SSM 功能。有关如何安装最新版本的 EC2Config 服务的信息,请参阅 Amazon EC2 User Guide for Windows Instances 中的安装最新版的 EC2Config

重要

SSM 代理 的更新版本在有新功能添加到 Systems Manager 或者对现有功能进行了更新时发布。如果较早版本的代理运行在实例上,一些 SSM 代理 过程会失败。因此,我们建议您自动完成确保实例上的 SSM 代理 为最新的过程。有关信息,请参阅 自动更新到 SSM 代理

如果需要,也可以使用以下过程在 Amazon EC2 Windows 实例上手动下载并安装最新版本的 SSM 代理。

重要

此过程适用于在 Amazon EC2 Windows 实例上安装或重新安装 SSM 代理。如果需要在本地实例或虚拟机 (VM) 上安装代理,以便与 Systems Manager 配合使用,请参阅Install SSM 代理 for a Hybrid Environment (Windows)

手动下载并安装最新版本的 SSM 代理

  1. 使用远程桌面或 Windows PowerShell 等工具登录实例。

  2. 将最新版本的 SSM 代理下载到实例:

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

    使用此 URL 可从任意 AWS 区域下载 SSM 代理。如果您要从特定区域下载代理,请改为使用特定于区域的 URL:

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

    区域 表示 AWS Systems Manager 支持的 AWS 区域的区域标识符,如US East (Ohio) Region的 us-east-2。有关受支持区域 值的列表,请参阅 AWS General ReferenceAWS Systems Manager 区域和终端节点表主题的区域列。

  3. 运行下载的 AmazonSSMAgentSetup.exe 文件以安装 SSM 代理。

  4. 在 PowerShell 中发送以下命令,以启动或重新启动 SSM 代理:

    Restart-Service AmazonSSMAgent

重要

SSM 代理需要 Windows PowerShell 3.0 或更高版本才能在 Windows 实例上运行特定 SSM 文档(例如,AWS-ApplyPatchBaseline 文档)。验证您的 Windows 实例是否在 Windows 管理框架 3.0 或更高版本上运行。此框架包括 Windows PowerShell。有关更多信息,请参阅 Windows 管理框架 3.0