如何在运行时获取另一台Azure DevOps构建服务器的系统目录？

核心方案：避免硬编码，用动态变量/API获取目标目录 #

硬编码目录的问题在于代理作业ID和服务器名称是动态变化的，你可以通过以下两种可靠方式获取目标代理的构建输出目录：

1. 跨作业传递构建目录变量（推荐） #

在目标构建作业（比如不带静态代码分析的作业）中，提前将构建输出目录存入可跨作业引用的变量：

• 在目标作业中添加PowerShell步骤，输出目录变量：

  # 将当前构建的二进制目录存入输出变量，供其他作业调用
  Write-Host "##vso[task.setvariable variable=TargetBuildDir;isOutput=true]$env:BUILD_BINARIESDIRECTORY"
  

  这里BUILD_BINARIESDIRECTORY是Azure DevOps预定义变量，自动对应代理上的_work/<作业ID>/b/路径，完全无需硬编码。
• 在需要复制制品的作业中，引用目标作业的输出变量，拼接成共享路径：

  # 假设目标作业的名称是NoStaticAnalysisBuild
  $targetDir = "$(NoStaticAnalysisBuild.TargetBuildDir)"
  $targetMachine = "$(NoStaticAnalysisBuild.Agent.MachineName)"
  # 转换为网络共享路径（把盘符冒号替换为$）
  $fullSharePath = "\\$targetMachine\$($targetDir.Replace(':', '$'))"
  
  # 执行复制操作
  Copy-Item -Path "$fullSharePath\*" -Destination "$env:BUILD_BINARIESDIRECTORY" -Recurse -Force
  

  注意：需确保两台代理机器之间配置了文件共享权限，且代理账户有访问对方目录的权限。

2. 通过Azure DevOps REST API查询目标作业目录 #

如果无法提前在目标作业中输出变量，可以调用API获取构建作业的代理信息：

• PowerShell示例代码：

  $orgUrl = "https://dev.azure.com/你的组织名"
  $projectName = "你的项目名"
  $targetBuildId = "目标构建的ID" # 可通过构建触发逻辑传递或手动指定
  $pat = "你的个人访问令牌" # 需授予Build读取权限
  
  # 调用API获取构建详情
  $buildApiUrl = "$orgUrl/$projectName/_apis/build/builds/$targetBuildId?api-version=7.1-preview.7"
  $buildInfo = Invoke-RestMethod -Uri $buildApiUrl -Headers @{Authorization = "Basic $([Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$pat")))"}
  
  # 提取代理机器名和工作目录
  $agentMachine = $buildInfo.assignedRequest.agent.machineName
  $workFolder = $buildInfo.assignedRequest.agent.workFolder # 代理的根工作目录（_work）
  $jobId = $buildInfo.assignedRequest.jobId
  $targetBinDir = "$workFolder\$jobId\b"
  
  # 转换为网络共享路径
  $fullSharePath = "\\$agentMachine\$($targetBinDir.Replace(':', '$'))"
  
  # 执行复制
  Copy-Item -Path "$fullSharePath\*" -Destination "$env:BUILD_BINARIESDIRECTORY" -Recurse -Force
  

额外注意事项 #

• 优先使用第一种方案，REST API方式需要额外配置权限，步骤更繁琐。
• 若代理使用了自定义工作目录，需确认BUILD_BINARIESDIRECTORY或API返回的路径是否匹配实际目录结构。

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