无需额外安装：从私有VSTS的TFVC仓库下载文件的PowerShell方案咨询

嘿，这个需求我太熟了！完全可以不用装任何额外工具（比如Visual Studio或者TF命令行），直接用原生PowerShell结合VSTS的REST API就能搞定，刚好符合你要的轻量级、无依赖的要求。下面给你详细的实现方案：

核心思路 #

VSTS（现在已更名为Azure DevOps Services）提供了完整的REST API来操作TFVC仓库，我们可以通过这些API获取文件/文件夹的最新版本，再用PowerShell的Invoke-RestMethod命令直接下载到本地。整个过程只需要一个有效的个人访问令牌（PAT）做认证，不需要安装任何客户端软件。

第一步：创建VSTS个人访问令牌（PAT） #

首先你需要在VSTS账户里生成一个有读取代码权限的PAT：

• 登录你的VSTS账户，点击右上角的个人头像，选择“个人访问令牌”
• 点击“新建令牌”，填写名称、过期时间，然后在“权限”里找到“Code”，勾选“Read”权限
• 生成令牌后一定要复制保存好，因为之后再也看不到完整的令牌内容了

第二步：PowerShell脚本实现 #

方案1：下载单个指定文件 #

这个脚本可以直接下载TFVC仓库里的单个文件到本地指定路径：

# 配置你的参数
$vstsAccount = "你的VSTS账户名"
$projectName = "目标项目名称"
$tfvcFilePath = "$/项目根路径/具体文件.ps1" # 示例：$/MyCustomerProject/Scripts/UpdateConfig.ps1
$localSavePath = "C:\本地要保存的路径\UpdateConfig.ps1"
$patToken = "你刚才生成的PAT令牌"

# 构建API请求URL（转义特殊字符避免报错）
$apiUrl = "https://$vstsAccount.visualstudio.com/$projectName/_apis/tfvc/items?path=$([Uri]::EscapeDataString($tfvcFilePath))&api-version=7.1-preview.2"

# 生成认证头（PAT需要转成Base64格式）
$authHeader = @{Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$patToken"))}

# 发送请求并保存文件
Invoke-RestMethod -Uri $apiUrl -Headers $authHeader -OutFile $localSavePath

Write-Host "✅ 文件已成功下载到：$localSavePath"

方案2：下载整个文件夹（包含子目录） #

如果需要下载整个文件夹的所有内容，我们需要先调用API列出文件夹里的所有文件，再逐个下载：

# 配置你的参数
$vstsAccount = "你的VSTS账户名"
$projectName = "目标项目名称"
$tfvcFolderPath = "$/项目根路径/目标文件夹" # 示例：$/MyCustomerProject/Scripts/
$localSaveFolder = "C:\本地要保存的文件夹路径"
$patToken = "你刚才生成的PAT令牌"
$apiVersion = "7.1-preview.2"

# 先创建本地保存文件夹（如果不存在）
if (-not (Test-Path $localSaveFolder)) {
    New-Item -ItemType Directory -Path $localSaveFolder | Out-Null
}

# 构建获取文件夹内容的API URL
$folderApiUrl = "https://$vstsAccount.visualstudio.com/$projectName/_apis/tfvc/items?path=$([Uri]::EscapeDataString($tfvcFolderPath))&recursionLevel=Full&api-version=$apiVersion"

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

# 获取文件夹下的所有文件和子目录
$items = Invoke-RestMethod -Uri $folderApiUrl -Headers $authHeader

# 遍历每个文件并下载
foreach ($item in $items.value) {
    if ($item.itemType -eq "File") {
        # 计算文件的相对路径，保持本地目录结构和TFVC一致
        $relativePath = $item.path.Substring($tfvcFolderPath.Length + 1)
        $localFilePath = Join-Path $localSaveFolder $relativePath

        # 创建文件的父目录（如果不存在）
        $parentDir = Split-Path $localFilePath -Parent
        if (-not (Test-Path $parentDir)) {
            New-Item -ItemType Directory -Path $parentDir | Out-Null
        }

        # 下载单个文件
        $fileApiUrl = "https://$vstsAccount.visualstudio.com/$projectName/_apis/tfvc/items?path=$([Uri]::EscapeDataString($item.path))&api-version=$apiVersion"
        Invoke-RestMethod -Uri $fileApiUrl -Headers $authHeader -OutFile $localFilePath

        Write-Host "✅ 已下载：$localFilePath"
    }
}

Write-Host "🎉 文件夹内容已全部下载完成！"

一些实用的注意事项 #

• 不要硬编码PAT：为了安全，你可以把PAT存在环境变量里，比如$patToken = [System.Environment]::GetEnvironmentVariable("VSTS_PAT", "User")，然后在系统环境变量里添加VSTS_PAT
• 私有部署的VSTS：如果你的VSTS是本地部署的（比如Azure DevOps Server），API URL要改成https://你的服务器地址/tfs/项目集合/_apis/tfvc/items...的格式
• API版本兼容：脚本里用的7.1-preview.2是比较新的API版本，兼容大部分现代VSTS/Azure DevOps实例，如果遇到报错，可以尝试调整为6.0等稳定版本

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