通过AWS Systems Manager Run Command运行PowerShell脚本失败如何解决

核心触发原因 #

你当前使用的Start-Process C:\Path\NameOfPowerShellScript.ps1写法本身存在逻辑问题：.ps1属于PowerShell脚本文件，并非可直接执行的二进制程序，本地手动运行时，系统依赖当前登录用户配置的文件关联自动调用PowerShell打开脚本，但AWS Run Command的执行上下文是Session 0隔离会话，运行身份为本地SYSTEM账户，既不继承你登录用户的文件关联配置，也不具备交互桌面权限，和本地手动运行的环境完全不同，直接调用脚本文件必然无法正常执行。

分步修复方案 #

• 修正脚本调用命令，显式指定PowerShell宿主进程执行
  禁止直接用Start-Process调用.ps1后缀的文件，必须显式传入powershell.exe作为执行程序，同时绕过非交互环境下的执行策略限制：

  # 基础调用写法，替换为你实际的脚本绝对路径
  powershell.exe -ExecutionPolicy Bypass -NoProfile -NonInteractive -File "C:\Path\Your-JRE-Install-Script.ps1"
  

  如果需要等待脚本执行完成、捕获退出码判断安装结果，使用Start-Process的正确写法如下：

  $installProc = Start-Process -FilePath "powershell.exe" `
    -ArgumentList "-ExecutionPolicy Bypass -NoProfile -NonInteractive -File `"C:\Path\Your-JRE-Install-Script.ps1`"" `
    -Wait -PassThru -NoNewWindow
  # 退出码为0代表执行成功，非0值可对应微软官方文档排查错误
  Write-Host "脚本执行退出码：$($installProc.ExitCode)"
  

• 适配脚本内容兼容Session 0非交互环境
  针对JRE安装类脚本，需要调整三处容易踩坑的逻辑：
  • 所有安装操作必须加静默参数，禁止出现任何需要用户点击确认、输入内容的交互逻辑，JRE离线安装包默认静默参数为/s，部分版本需要追加REBOOT=Suppress禁止安装后触发重启
  • 脚本内不要使用依赖登录用户的环境变量路径，比如$env:LOCALAPPDATA、$env:USERPROFILE这类路径在SYSTEM账户上下文下指向的是系统目录，不是你日常登录的管理员用户目录，所有路径统一写绝对路径
  • 脚本、JRE安装包不要存放在个人用户目录（比如C:\Users\你的用户名\Desktop），统一放到C:\Temp这类全局可读目录，给SYSTEM账户分配读取、执行权限
• 核对Run Command配置项
  • 执行文档必须选择Windows对应的AWS-RunPowerShellScript，不要误选Linux适用的Shell脚本文档
  • 执行超时时间设置为300秒以上，给安装包解压、写入注册表留足时间，避免进程被Run Command强制终止
• 加日志捕获具体报错
  在安装脚本的最开头开启PowerShell转录日志，所有执行输出、报错都会持久化到本地文件，方便定位问题：

  # 脚本首行加日志配置
  Start-Transcript -Path "C:\Temp\jre_install_log.txt" -Append -Force
  # 此处保留你原有的JRE安装逻辑
  # 脚本末尾停止日志记录
  Stop-Transcript
  

常见误区：本地双击脚本能跑不代表脚本本身适配非交互环境，绝大多数手动运行正常的PowerShell脚本，放到计划任务、Run Command这类非交互Session 0环境下运行时，都会因为权限、上下文、交互逻辑的问题失效，必须显式指定执行宿主、适配静默逻辑。

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