在AWS EC2 Windows Server 2022上用PowerShell 7+运行UserData

问题背景 #

AWS EC2的Windows Server 2022基础AMI默认会以PowerShell 5.1执行UserData脚本。如果需要使用仅支持PowerShell 7及以上版本的cmdlet，安装PS7后常规的递归调用或Invoke-Expression方式会静默失败，且UserData的故障排查难度较高。

解决方案 #

以下是修正后的脚本，解决了路径解析、环境变量刷新和脚本执行权限等问题：

# 检查当前PowerShell版本，若低于7则安装并重新执行
if ($PSVersionTable.PSVersion.Major -lt 7) {
    # 下载PS7安装包到临时目录
    $installerPath = "$env:TEMP\PowerShell-7.3.1-win-x64.msi"
    Invoke-WebRequest -Uri https://github.com/PowerShell/PowerShell/releases/download/v7.3.1/PowerShell-7.3.1-win-x64.msi -OutFile $installerPath
    
    # 静默安装PS7，同时添加右键菜单选项（可选）
    Start-Process msiexec.exe -ArgumentList "/i `"$installerPath`" /quiet ADD_EXPLORER_CONTEXT_MENU_OPENPOWERSHELL=1 ADD_FILE_CONTEXT_MENU_RUNPOWERSHELL=1" -Wait -NoNewWindow
    
    # 手动追加PS7路径到当前会话环境变量，避免路径未刷新导致无法调用pwsh
    $env:Path += ";C:\Program Files\PowerShell\7"
    
    # 读取当前脚本内容，直接通过PS7执行，避免临时文件路径访问问题
    $scriptContent = Get-Content -Path $PSCommandPath -Raw
    pwsh -Command $scriptContent
    exit
}

# PowerShell 7及以上版本执行的业务逻辑
if ($PSVersionTable.PSVersion.Major -ge 7) {
    Write-Host "当前运行PowerShell版本: $($PSVersionTable.PSVersion)"
    # 替换为你需要的PS7专属cmdlet逻辑
    # 示例：使用PS7特有的参数或命令
    Get-ChildItem -Path "C:\" -Depth 1 -File -Name
}

关键修正点 #

1. 指定临时目录存储安装包：避免系统路径权限问题，使用$env:TEMP目录存放安装文件
2. 刷新环境变量：安装PS7后手动将其路径追加到当前会话的$env:Path，确保能直接调用pwsh命令
3. 传递脚本内容而非文件路径：读取脚本原始内容通过pwsh -Command执行，规避UserData临时脚本文件的访问限制

故障排查技巧 #

• 查看官方执行日志：UserData的执行日志位于C:\ProgramData\Amazon\EC2-Windows\Launch\Log\UserdataExecution.log，可通过RDP连接实例或AWS Systems Manager的Run Command获取日志内容
• 添加自定义日志：在脚本关键步骤添加日志输出到本地文件，例如：

  "PS7安装开始时间: $(Get-Date)" | Out-File "C:\UserDataDebug.log" -Append
  

• 启用安装日志：修改msiexec命令添加日志参数，排查安装失败原因：

  Start-Process msiexec.exe -ArgumentList "/i `"$installerPath`" /quiet /lvx* `"C:\PS7InstallLog.txt`"" -Wait -NoNewWindow
  

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