Jenkins代理由任务计划程序启动时PowerShell cmdlet无法识别问题

问题原因 #

任务计划程序启动Jenkins代理时，使用的系统账户或指定账户的PowerShell环境，和你手动登录启动代理的用户环境存在差异：

• PnP.PowerShell模块仅安装在个人用户目录，系统/任务账户无法访问
• 代理启动时未自动加载PnP模块
• 任务计划的运行账户缺少必要的环境变量或权限

解决方案 #

• 检查并重新安装PnP模块到公共路径

  1. 手动打开PowerShell，执行Get-Module -Name PnP.PowerShell -ListAvailable，查看模块安装位置。如果路径包含C:\Users\<你的用户名>，说明是仅当前用户可用。
  2. 以管理员身份打开PowerShell，执行Install-Module -Name PnP.PowerShell -Scope AllUsers，将模块安装到所有用户可访问的公共目录（如C:\Program Files\WindowsPowerShell\Modules）。

• 在Jenkins任务中显式加载模块
  在执行Connect-PnPOnline的PowerShell步骤前，添加一行强制加载模块的命令：

  Import-Module -Name PnP.PowerShell -Force
  

  确保模块被正确加载，避免环境变量导致的模块查找失败。

• 统一任务计划的运行账户
  打开任务计划程序，找到启动Jenkins代理的任务：

  1. 切换到「安全选项」，将运行账户改为你手动启动代理时使用的用户账户
  2. 勾选「不管用户是否登录都要运行」，并输入该账户的密码
  3. 保存后重启任务，确保代理在和手动启动一致的用户环境下运行

• 补全环境变量（可选）
  如果上述方法无效，可在任务计划的启动命令中手动添加模块路径：

  cmd /c "set PSModulePath=%PSModulePath%;C:\Users\<你的用户名>\Documents\WindowsPowerShell\Modules && javaws http://jenkins/computer/agentName/slave-agent.jnlp"
  

  替换<你的用户名>为实际用户名，确保代理启动时能找到PnP模块。

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