Jenkins Pipeline Powershell步骤报错：‘powershell未找到’

阿华AIGC实验室

2026-5-29

Jenkins Windows Agent: 'powershell' Not Recognized in Pipeline But Works Manually

我之前处理过好几个类似的案例，这个问题的核心矛盾点很明确：Jenkins代理服务运行时的系统环境和你手动登录Windows时的环境不一样，最常见的就是PATH环境变量的差异导致找不到powershell命令。

为什么手动运行没问题？

当你手动登录Windows并执行脚本时，用的是当前用户的环境变量，其中PATH已经包含了PowerShell的安装路径（通常是C:\Windows\System32\WindowsPowerShell\v1.0\）。但Jenkins代理默认是用Local System账户作为服务运行的，这个账户的环境变量是受限的，可能没有包含PowerShell的路径，所以执行Pipeline时会抛出找不到命令的错误。

解决方案1：修复系统级PATH环境变量

这是最彻底的解决方式，确保所有服务都能找到PowerShell：

右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
在「系统变量」区域找到Path，点击「编辑」
添加以下路径（根据你用的PowerShell版本选择）：
- Windows PowerShell：C:\Windows\System32\WindowsPowerShell\v1.0\
- PowerShell Core 7+：C:\Program Files\PowerShell\7\
点击「确定」保存，然后重启Jenkins代理服务（在Windows服务列表里找到Jenkins Agent，右键重启）
重新运行你的Pipeline

解决方案2：在Pipeline中指定PowerShell的绝对路径

如果暂时不想修改系统环境变量，可以直接在Pipeline脚本里硬编码PowerShell的完整路径：

pipeline {
    stages {
        stage('test') {
            steps {
                // 针对Windows PowerShell的写法
                powershell(script: '& "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe" -Command "Write-Output Hello"')
                
                // 如果是用PowerShell Core，替换成这个路径
                // powershell(script: '& "C:\\Program Files\\PowerShell\\7\\pwsh.exe" -Command "Write-Output Hello"')
            }
        }
    }
}