Azure DevOps部署作业中CopyFiles任务无法更新新版本，如何解决？

针对你遇到的自托管虚拟机代理上CopyFiles任务无法更新的问题，核心原因是自托管代理会本地缓存任务包，默认更新机制未触发或缓存干扰了新版本下载，可按以下步骤解决：

1. 手动触发代理的任务更新 #

登录到注册的目标服务器，找到自托管代理的安装目录（常见路径如Windows的C:\agent、Linux的/home/{user}/agent），执行对应系统的更新命令：

• Windows：打开命令提示符，进入代理目录后运行 .\config.cmd update
• Linux/macOS：打开终端，进入代理目录后运行 ./config.sh update
  更新完成后重启代理服务：Windows可在「服务」列表找到Azure Pipelines Agent重启；Linux可执行 systemctl restart azure-pipelines-agent.service（若用systemd管理）

2. 清理任务缓存后重新同步 #

如果更新命令无效，大概率是旧版本任务的缓存残留：

1. 先停止代理服务
2. 进入代理目录下的_work\_tasks文件夹，删除所有以CopyFilesV2开头的文件夹（比如CopyFilesV2-2.246.0）
3. 回到代理目录重新执行步骤1的更新命令
4. 启动代理服务后重新运行流水线

3. 确保YAML中正确指定任务版本 #

在流水线YAML里明确指定目标版本号，示例：

- task: CopyFiles@2.256.0
  displayName: 'Copy website'
  inputs:
    SourceFolder: '$(Pipeline.Workspace)\Artifact\subfolder\'
    Contents: '**'
    TargetFolder: 'dest path'
    OverWrite: True

注意版本号要和Azure DevOps组织内任务库中提供的最新版本一致，你可以在流水线编辑界面添加CopyFiles任务时，从版本下拉列表确认准确版本号。

额外检查 #

• 确认服务器能正常访问Azure DevOps Services的网络，代理需要连通dev.azure.com及相关CDN地址，否则无法下载任务包
• 检查代理运行的服务账户是否具备读取组织任务库的权限

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