自定义Windows AMI中UserData未执行，WinRM启用失败求解决方法

核心问题分析 #

自定义AMI缺失ECLaunch/EC2Config（或EC2Launch v2）组件，这是AWS Windows实例处理UserData的核心服务，导致你的UserData脚本无法被触发执行。以下是几种可行的替代方案：

方案1：为自定义AMI预装EC2Launch v2 #

要让UserData正常工作，必须先在源实例中安装EC2Launch v2，再重新制作AMI：

• 在创建自定义AMI的源Windows实例上，获取并安装EC2Launch v2（从AWS官方提供的安装程序进行部署）
• 安装完成后，确认EC2Launch服务已设置为自动启动
• 重新创建自定义AMI，后续启动该AMI的实例即可正常执行UserData脚本

方案2：直接在源实例预配置WinRM后制作AMI #

绕过UserData，直接在制作自定义AMI的源实例上完成WinRM配置：
在源实例本地运行以下PowerShell命令：

# 设置管理员密码
net user Administrator "Password1!"
# 快速初始化WinRM
winrm quickconfig -quiet
# 添加WinRM HTTP端口入站防火墙规则
New-NetFirewallRule -Name "AllowWinRM" -DisplayName "Allow WinRM over HTTP" -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 5985
# 启用WinRM基本认证
winrm set winrm/config/service/auth '@{Basic="true"}'
# 允许WinRM未加密传输
winrm set winrm/config/service '@{AllowUnencrypted="true"}'
# 启用PowerShell远程管理
Enable-PSRemoting -Force
# 重启WinRM服务使配置生效
Restart-Service winrm

配置完成后创建新的自定义AMI，后续启动的实例将直接具备可用的WinRM环境。

方案3：使用Cloud-Init替代（若系统支持） #

如果你的自定义AMI基于支持Cloud-Init的Windows镜像，可以改用Cloud-Init格式的配置：
将UserData替换为以下内容：

#cloud-config
power_shell:
  - net user Administrator "Password1!"
  - winrm quickconfig -quiet
  - New-NetFirewallRule -Name "AllowWinRM" -DisplayName "Allow WinRM over HTTP" -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 5985
  - winrm set winrm/config/service/auth '@{Basic="true"}'
  - winrm set winrm/config/service '@{AllowUnencrypted="true"}'
  - Enable-PSRemoting -Force
  - Restart-Service winrm

确保Cloud-Init服务在自定义AMI中处于正常运行状态。

方案4：通过SSM Run Command事后配置 #

如果实例已具备SSM访问条件（实例关联IAM权限、已安装SSM Agent），可以在实例启动后通过SSM Run Command执行WinRM配置：

• 登录AWS控制台，进入Systems Manager > Run Command
• 选择AWS-RunPowerShellScript文档，输入以下脚本内容并执行：

net user Administrator "Password1!"
winrm quickconfig -quiet
New-NetFirewallRule -Name "AllowWinRM" -DisplayName "Allow WinRM over HTTP" -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 5985
winrm set winrm/config/service/auth '@{Basic="true"}'
winrm set winrm/config/service '@{AllowUnencrypted="true"}'
Enable-PSRemoting -Force
Restart-Service winrm

内容的提问来源于stack exchange，提问作者C_09_Vaibhav Borate