Azure DevOps部署组代理安装报错 发布管道文件复制失败

核心优先级最高的修复项 #

• 立即升级故障虚拟机的.NET Framework版本：Azure DevOps Windows部署组代理的最低运行依赖为.NET Framework 4.5，故障机当前4.0版本仅能完成代理注册的表面流程，任务执行、文件传输相关的核心模块无法正常加载，这是平台能看到机器记录但执行任务报错的核心原因。直接安装.NET Framework 4.7.2以上的稳定长期支持版本，安装完成后重启虚拟机，在Windows服务列表中重启Azure Pipelines Agent服务后再做任务测试。

你之前尝试的任务版本切换、新建目标文件夹操作，都是在基础运行依赖不满足的前提下操作，不会解决问题。

无效排查项说明 #

• 免费层默认Azure托管代理无法ping通目标虚拟机属于正常现象：部署组模式下的任务执行逻辑是目标虚拟机本地安装的代理主动出站连接Azure DevOps服务拉取任务、执行操作，不需要微软托管的公网代理能直连你的私有虚拟机，这个测试结果和当前故障没有关联，不需要针对这个点做网络调整。

依赖修复后的补漏校验项 #

• 校验代理服务实际运行权限：不要仅以Azure DevOps平台显示的关联账户为准，打开故障机的Windows服务管理器，找到对应部署组的代理服务，查看「登录」标签页下配置的实际运行账户，确认该账户对目标部署路径拥有完全读写权限；如果安装代理时默认选择了本地系统账户，建议手动修改为你提前配置的、拥有本地管理员权限的域/本地账户后重启服务。
• 校验代理出站连通性：在故障机上直接访问你们组织使用的Azure DevOps服务地址，确认本地防火墙、上网代理没有拦截443端口的出站请求，同时查看代理安装目录下_diag文件夹中的最新运行日志，确认代理和服务端的心跳请求无报错。
• 调整复制任务配置：使用2.*版本的「复制文件到目标计算机」任务时，先取消勾选「使用管理员凭据复制」选项，避免系统UAC拦截写入操作；测试阶段先使用C:\deploy-test这类无特殊字符、无中文的简单路径做验证，确认复制功能正常后再切换到实际业务路径。

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