如何通过Azure DevOps部署.NET Framework控制台应用至远程服务器？

核心前提 #

你的构建流水线已能生成有效artefacts（Zip包或文件目录），部署阶段的核心是将artefacts传输到远程服务器并完成启动/配置，下面分场景给出具体方案：

场景1：自托管代理部署在目标远程服务器上 #

如果你的Azure DevOps自托管代理直接安装在要部署的远程服务器上，操作最简单：

• 添加Download Build Artifacts任务：指定artefacts名称，下载到代理本地的$(System.ArtifactsDirectory)目录
• 添加Copy Files任务：
  • 源路径：$(System.ArtifactsDirectory)\**（根据你的artefacts结构调整，比如如果是Zip解压后的目录，要指定到具体子目录）
  • 目标路径：填写服务器本地的部署目录，比如D:\Deploy\MyConsoleApp
• （可选）添加PowerShell任务：执行启动脚本，比如Start-Process D:\Deploy\MyConsoleApp\YourApp.exe，或者将应用注册为Windows服务（用New-Service命令）

场景2：代理不在目标服务器上（托管代理/其他机器的自托管代理） #

这种情况不能直接用Copy Files任务访问远程路径，必须通过WinRM协议远程传输：

1. 配置WinRM服务连接：
   在Azure DevOps项目的「项目设置」→「服务连接」中，添加「Windows Remote Management」类型的连接，填写目标服务器的IP/域名、端口（默认5985/http，5986/https）、认证信息（用户名密码或证书）
2. 部署任务流程：
   • 添加Download Build Artifacts任务：下载artefacts到代理本地的$(System.ArtifactsDirectory)
   • （如果artefacts是Zip包）添加Extract Files任务：将Zip解压到$(System.ArtifactsDirectory)\extracted
   • 添加Windows Machine File Copy任务：
     • 选择刚才配置的WinRM服务连接
     • 源路径：$(System.ArtifactsDirectory)\extracted\**（对应解压后的文件目录）
     • 目标路径：远程服务器上的部署目录，比如D:\Apps\MyConsoleApp
     • 可勾选「Clean target folder」清空旧部署文件
   • （可选）添加PowerShell on Target Machine任务：远程执行脚本，比如启动应用、注册Windows服务或配置环境变量

你遇到的Copy Files任务无反应的原因 #

Copy Files任务只能操作代理机器本地的文件系统：

• 如果用的是Azure托管代理，它无法直接访问你的远程服务器路径（比如\\server\path或D:\xxx），自然不会有任何操作
• 即使用自托管代理，若代理不在目标服务器上，远程路径需要是UNC共享且代理有访问权限，否则也会失败

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