寻求Azure DevOps TFVC分支删除与创建的API/PowerShell方案

针对TFVC的分支操作，你可以通过官方的tf.exe命令行工具或Azure DevOps REST API实现流水线自动化，以下是具体的脚本和使用说明：

一、使用tf.exe命令行（推荐用于Azure DevOps Pipeline） #

tf.exe是TFVC的官方命令行工具，Azure DevOps Pipeline代理默认预装，本地环境可随Visual Studio或Azure DevOps Server安装。

1. 创建分支 #

命令格式示例：

# 替换为你的实际参数
$collectionUrl = "https://dev.azure.com/YourOrg"
$project = "YourProject"
$sourceBranch = "$/$project/Main"
$targetBranch = "$/$project/Features/YourNewFeature"
$pat = "YourPersonalAccessToken"

# 执行分支创建
tf branch $sourceBranch $targetBranch /login:.,$pat /collection:$collectionUrl

• 权限要求：PAT需要拥有TFVC分支创建权限，建议勾选"Code (Full)"范围。
• 说明：该命令会从源分支复制版本历史到目标分支，完成分支创建。

2. 删除分支 #

TFVC支持两种删除方式：

标记删除（可恢复）

$branchToDelete = "$/$project/Features/OldFeature"
tf delete $branchToDelete /login:.,$pat /collection:$collectionUrl /recursive

标记删除的分支可在TFVC的"已删除项"中恢复。

永久销毁（不可恢复）

tf destroy $branchToDelete /login:.,$pat /collection:$collectionUrl /recursive /stopat:none

警告：永久销毁会彻底删除分支数据，执行前务必确认。

二、使用Azure DevOps REST API（跨平台自动化） #

如果需要跨平台执行，可调用Azure DevOps REST API：

1. 创建分支 #

$headers = @{
    Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$pat"))
}

$body = @{
    sourcePath = "$/$project/Main"
    targetPath = "$/$project/Features/YourNewFeatureAPI"
} | ConvertTo-Json

Invoke-RestMethod -Uri "$collectionUrl/$project/_apis/tfvc/branches?api-version=7.1-preview.1" `
    -Method Post -Headers $headers -Body $body -ContentType "application/json"

2. 删除分支 #

API仅支持标记删除（与tf delete效果一致）：

$encodedPath = [Uri]::EscapeDataString($branchToDelete)
Invoke-RestMethod -Uri "$collectionUrl/$project/_apis/tfvc/branches?path=$encodedPath&api-version=7.1-preview.1" `
    -Method Delete -Headers $headers

三、流水线使用提示 #

• 在Azure DevOps Pipeline中，直接用Command Line或PowerShell任务执行上述脚本即可，代理环境已自带tf.exe。
• PAT请存储在Pipeline的秘密变量中，避免明文泄露。

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