如何通过tf.exe在Azure DevOps代理上获取另一项目的文件？

问题核心 #

构建管道自动创建的TFVC工作区属于Build\<guid>专属用户，你的PowerShell脚本以代理本地用户执行，无法直接操作该专属工作区；同时本地工作目录已被该工作区占用，无法创建新工作区映射同一路径。

可行解决方法 #

方法1：直接操作Build专属工作区（推荐） #

复用管道自动创建的工作区，指定Build服务用户身份来添加新项目映射：

$collection = "你的集合地址"
$tfsProjectTargetPath = "`$/projectB/subdir/branch"
$localWorkDir = $env:SYSTEM_DEFAULTWORKINGDIRECTORY
# 获取Build服务用户标识
$buildUser = "Build\$($env:BUILD_BUILDID)"
$workspaceName = $env:Build_Repository_Tfvc_Workspace

# 为现有工作区添加项目B的映射（指定子目录避免冲突）
& $tf vc workfold /map $tfsProjectTargetPath "$localWorkDir\projectB" /workspace:$workspaceName;$buildUser /collection:$collection /noprompt

# 拉取映射的文件
& $tf vc get "$localWorkDir\projectB" /recursive /force /collection:$collection /noprompt

方法2：创建独立工作区映射到新路径 #

在默认工作目录外新建文件夹，创建独立工作区拉取项目B文件：

$collection = "你的集合地址"
$tfsProjectTargetPath = "`$/projectB/subdir/branch"
# 创建新本地目录，避开原有工作区路径
$newLocalDir = "$($env:SYSTEM_DEFAULTWORKINGDIRECTORY)\..\projectB_temp"
New-Item -Path $newLocalDir -ItemType Directory -Force

# 创建新工作区（使用当前代理用户）
$workspaceName = "WS_ProjectB_$($env:BUILD_BUILDID)"
& $tf vc workspace /new /location:local $workspaceName /collection:$collection /noprompt

# 映射项目B路径到新目录
& $tf vc workfold /map $tfsProjectTargetPath $newLocalDir /workspace:$workspaceName /collection:$collection /noprompt

# 拉取文件
& $tf vc get $newLocalDir /recursive /force /collection:$collection /noprompt

# 可选：将文件复制到默认工作目录供后续步骤使用
Copy-Item -Path "$newLocalDir\*" -Destination $env:SYSTEM_DEFAULTWORKINGDIRECTORY -Recurse -Force

# 可选：清理临时工作区
& $tf vc workspace /delete $workspaceName /collection:$collection /noprompt

注意事项 #

• 操作TFVC工作区时，必须明确指定工作区所属用户（格式：工作区名称;用户标识），否则会因用户上下文不匹配报错；
• 方法1无需额外清理，效率更高；方法2适合需要隔离文件的场景；
• 确保自托管代理的服务账号拥有项目B的TFVC读取权限。

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