AzurePowerShell@5任务报错：‘pwsh.exe’未被识别为可操作程序

排查与解决步骤 #

• 重启Azure Pipelines代理服务：系统PATH更新后，代理进程可能未加载新的环境变量。在Windows 10机器上打开服务管理器，找到Azure Pipelines Agent服务并重启，让新PATH生效。
• 验证pwsh.exe的可访问性：直接在问题机器的cmd窗口执行where pwsh，确认能返回C:\Program Files\PowerShell\7\pwsh.exe。如果找不到，重新安装PowerShell 7，或检查安装路径是否正确添加到系统PATH。
• 指定具体PowerShell版本：将任务配置里的azurePowerShellVersion: LatestVersion改为azurePowerShellVersion: '7.x'，强制任务调用PowerShell 7，避免版本检测逻辑出错。
• 检查管道会话的PATH：在管道中添加一个命令行任务，输出当前会话的PATH：

  echo %PATH%
  

  对比系统PATH，看PowerShell 7的路径是否存在。如果没有，说明代理未读取到系统PATH的更新，或代理是在特定用户账户下运行，需要给该用户添加对应PATH。
• 手动指定pwsh.exe路径：若上述方法无效，直接在任务里指定pwsh的绝对路径，修改后的配置如下：

  - task: AzurePowerShell@5
    inputs:
      azureSubscription: 'xyz'
      azurePowerShellVersion: '7.x'
      pwsh: true
      pwshPath: 'C:\Program Files\PowerShell\7\pwsh.exe'
      ScriptType: filePath
      ScriptPath: 'pathName'
      ScriptArguments: >
        (args)
  

兼容性说明 #

Windows 10 Enterprise与AzurePowerShell@5任务本身不存在兼容性问题，相同配置在Windows Server 2019能正常运行，说明问题出在Windows 10机器的环境加载或安装细节上，优先按上述步骤排查。

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