如何通过脚本自动下载Azure DevOps Server中TFVC集合的所有文件夹？

可以通过独立的tf命令行工具结合Azure DevOps Server的REST API实现自动化下载，无需安装完整的TFS或Visual Studio（仅需轻量的命令行工具）。具体步骤如下：

1. 获取独立的tf命令行工具 #

不需要安装完整TFS，只需安装轻量的命令行组件：

• 打开Visual Studio Installer，选择"修改"已安装的VS实例，勾选"单个组件"里的Team Foundation Server 命令行工具完成安装；
• 也可通过Chocolatey包管理器直接安装：choco install tf-cli（无需完整VS环境）。

2. 用REST API枚举所有集合、项目和TFVC路径 #

通过Azure DevOps Server的REST API批量获取所有需要下载的资源信息，需使用个人访问令牌（PAT）认证：

• 获取所有集合：

  GET http://<你的服务器地址>/_apis/collections?api-version=6.0
  

• 获取指定集合下的所有项目：

  GET http://<你的服务器地址>/<集合名称>/_apis/projects?api-version=6.0
  

• 获取指定项目下的所有TFVC文件/目录：

  GET http://<你的服务器地址>/<集合名称>/_apis/tfvc/items?scopePath=$/<项目名称>&recursionLevel=Full&api-version=6.0
  

认证方式：在请求头添加Authorization: Basic <Base64编码的PAT>（PAT前需加冒号，再转Base64）。

3. 编写自动化脚本下载代码 #

以PowerShell脚本为例，循环遍历所有资源并调用tf.exe下载：

$serverUrl = "http://你的AzureDevOpsServer地址"
$pat = "你的个人访问令牌" # 需拥有代码读取权限
$localRoot = "D:\TFVC_Code_Backup"

# 认证头
$authHeader = @{Authorization = "Basic $([Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$pat")))"}

# 枚举所有集合
$collections = Invoke-RestMethod -Uri "$serverUrl/_apis/collections?api-version=6.0" -Headers $authHeader

foreach ($collection in $collections.value) {
    $collectionName = $collection.name
    Write-Host "开始处理集合：$collectionName"

    # 枚举当前集合下的所有项目
    $projects = Invoke-RestMethod -Uri "$serverUrl/$collectionName/_apis/projects?api-version=6.0" -Headers $authHeader

    foreach ($project in $projects.value) {
        $projectName = $project.name
        $localProjectDir = Join-Path $localRoot "$collectionName\$projectName"
        New-Item -ItemType Directory -Path $localProjectDir -Force | Out-Null
        Write-Host "  开始处理项目：$projectName"

        # 枚举当前项目下的所有TFVC资源
        $tfvcItems = Invoke-RestMethod -Uri "$serverUrl/$collectionName/_apis/tfvc/items?scopePath=`$/`$projectName&recursionLevel=Full&api-version=6.0" -Headers $authHeader

        foreach ($item in $tfvcItems.value) {
            # 处理目录：创建本地对应目录
            if ($item.itemType -eq "Folder") {
                $localDir = Join-Path $localProjectDir $item.path.Substring(2 + $projectName.Length)
                New-Item -ItemType Directory -Path $localDir -Force | Out-Null
            }
            # 处理文件：调用tf get下载
            elseif ($item.itemType -eq "File") {
                $tfPath = "$serverUrl/$collectionName$($item.path)"
                & tf.exe get "$tfPath" /version:T /force /noprompt /login:.,$pat
                Write-Host "    已下载文件：$($item.path)"
            }
        }
    }
}

关键参数说明 #

• /version:T：获取TFVC仓库的最新版本代码；
• /force：强制覆盖本地已存在的文件；
• /noprompt：无交互模式，适合自动化脚本；
• /login:.,$pat：使用PAT进行身份验证。

注意事项 #

• 确保tf.exe已添加到系统PATH，或在脚本中指定其完整路径；
• PAT需授予代码读取权限，避免权限不足导致下载失败；
• 针对大型代码库，可添加API请求限流、错误捕获逻辑，避免脚本中断；
• 若需下载特定版本代码，可将/version:T替换为具体版本号（如/version:C12345）。

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