Jenkins技术问题：无法执行Copy-Item操作至共享文件夹

这个问题我之前帮好几个开发者排查过，核心原因大多和Jenkins服务的运行身份以及共享文件夹的权限配置有关，咱们一步步来拆解：

1. 检查Jenkins服务的运行账户 #

Jenkins默认是用**Local System（本地系统账户）**运行的，这个账户没有网络访问权限，自然无法识别远程共享文件夹的UNC路径。你需要把Jenkins服务切换到一个有共享文件夹访问权限的账户：

• 打开Windows服务管理器（按下Win+R输入services.msc）
• 找到Jenkins服务，右键选择「属性」→「登录」选项卡
• 选择「此账户」，输入拥有共享文件夹读写权限的域账户或本地账户（比如你的管理员账户），输入密码后点击确定
• 重启Jenkins服务，再测试脚本

2. 确认共享文件夹的双重权限设置 #

共享文件夹有两层权限需要配置，缺一不可：

• 共享权限（Share Permissions）：在共享文件夹属性的「共享」选项卡中，添加Jenkins运行账户，授予「读取/写入」权限
• NTFS权限（Security）：在「安全」选项卡中，同样添加该账户，授予「修改」或「完全控制」权限（根据你的需求）

注意：很多人只设置了共享权限，忽略了NTFS权限，这是常见的坑！

3. 确保使用UNC路径而非映射盘符 #

不要用映射盘符（比如Z:\sharedfolder），因为映射盘符是绑定到当前登录用户的，Jenkins服务的账户不会继承这个映射。直接使用UNC格式路径：

Copy-Item -Path "C:\local\file.txt" -Destination "\\server-name\shared-folder\"

如果必须使用映射盘符，需要在脚本中显式创建映射（记得带上凭据）：

$cred = Get-Credential -Message "Enter account with share access"
New-PSDrive -Name Z -PSProvider FileSystem -Root "\\server-name\shared-folder" -Credential $cred
Copy-Item -Path "C:\local\file.txt" -Destination "Z:\"

4. 验证当前运行账户与权限 #

在你的PowerShell脚本开头添加以下命令，确认Jenkins实际使用的账户：

Write-Host "Current running user: $(whoami)"

如果输出的账户不是你设置的那个，说明Jenkins服务没重启生效。另外，也可以直接带凭据测试路径：

$cred = Get-Credential
Test-Path "\\server-name\shared-folder" -Credential $cred

如果这个测试返回True，说明权限没问题，问题出在Jenkins的服务账户配置上。

5. 排查防火墙与SMB协议 #

• 检查目标服务器的防火墙是否允许SMB流量（默认端口445），可以临时关闭防火墙测试是否能访问
• 确认Jenkins所在机器和目标服务器都开启了兼容的SMB版本（比如SMB 2.0或3.0），旧版本SMB可能被禁用

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