Azure DevOps指定仓库批量删分支及PowerShell脚本优化问询

以下针对你提出的3个问题逐一给出解决方案，所有修改可直接嵌入你现有脚本使用：

a. 为分支输出表格添加索引 #

你可以在拿到分支列表后，为每个分支对象手动添加索引属性，再输出表格即可，替换你原脚本中输出分支表格的代码段即可：

$branchInfo = az repos ref list --organization $organizationURL --project $projectName --repository $repoName
$branchInfo = $branchInfo | ConvertFrom-Json

# 新增：为每个分支添加索引字段，从1开始计数
for ($i = 0; $i -lt $branchInfo.Count; $i++) {
    $branchInfo[$i] | Add-Member -MemberType NoteProperty -Name "Index" -Value ($i + 1) -Force
}

# 输出带索引的分支表格
$branchInfo | Format-Table -Property Index, name, objectId

执行后输出的表格会第一列展示索引序号，用户无需再手动匹配分支名和objectId。

b. 通过分支名称直接获取对应objectId #

完全可以实现，无需用户手动输入objectId，通过分支名过滤分支列表即可直接拿到对应objectId，实现代码如下：

# 方式1：用户输入完整分支名（带refs/heads/前缀）
$inputBranchName = Read-Host "输入要删除的完整分支名"
$targetBranch = $branchInfo | Where-Object { $_.name -eq $inputBranchName }

# 方式2：用户输入短分支名，自动补前缀（更易用）
$inputShortBranch = Read-Host "输入要删除的分支短名（无需带refs/heads/前缀）"
$fullBranchName = "refs/heads/$inputShortBranch"
$targetBranch = $branchInfo | Where-Object { $_.name -eq $fullBranchName }

# 获取到的objectId
$targetObjectId = $targetBranch.objectId

# 可选：加分支不存在的校验逻辑
if (-not $targetBranch) {
    Write-Host "输入的分支名不存在，请重新输入" -ForegroundColor Red
    exit
}

注意：Azure CLI返回的分支名默认带refs/heads/前缀，比如dev分支的完整名称是refs/heads/dev，如果用短名查询记得补全前缀。

c. 支持输入多个索引批量删除分支 #

你可以让用户输入多个索引，用分隔符拆分后循环执行删除即可，实现代码如下：

# 提示用户输入多个索引，用英文逗号分隔
$inputIndexStr = Read-Host "输入要删除的分支索引，多个用英文逗号分隔（示例：2,4,7）"
# 拆分输入内容并转为数字数组
$indexArray = $inputIndexStr.Split(',') | ForEach-Object { [int]$_.Trim() }

foreach ($index in $indexArray) {
    # 索引从1开始，数组下标要减1
    $currentBranch = $branchInfo[$index - 1]
    if (-not $currentBranch) {
        Write-Host "索引$index 不存在，已跳过" -ForegroundColor Yellow
        continue
    }
    Write-Host "正在删除分支：$($currentBranch.name)" -ForegroundColor Red
    # 调用删除命令
    az repos ref delete --name $currentBranch.name --object-id $currentBranch.objectId --organization $organizationURL --project $projectName --repository $repoName
    Write-Host "分支$($currentBranch.name) 删除成功" -ForegroundColor Green
}

整合优化后的完整脚本 #

你可以直接使用以下整合了所有功能的脚本：

$projectName= "xyz"
$organizationURL= "https://dev.azure.com/xyz"
$repoList= az repos list --organization $organizationURL --project $projectName 
$repoList= $repoList | ConvertFrom-Json
$repoNames= $repoList.name

function getRepositories {
    Write-Output "Repositories available in the $projectName project"
    foreach ($repo in $repoNames) {
        Write-Output "  $($repoNames.IndexOf($repo)+1)-$($repo)"
    }
}
getRepositories;

$repoNumber = Read-Host -Prompt "Enter repo number to list its branches";
$repoNumber = $repoNumber - 1;
$repoName= "$($repoNames[$repoNumber])"
Write-Output "已选择仓库：$repoName";

$branchInfo = az repos ref list --organization $organizationURL --project $projectName --repository $repoName
$branchInfo = $branchInfo | ConvertFrom-Json

# 给分支添加索引
for ($i = 0; $i -lt $branchInfo.Count; $i++) {
    $branchInfo[$i] | Add-Member -MemberType NoteProperty -Name "Index" -Value ($i + 1) -Force
}

# 输出带索引的分支表格
Write-Output "仓库$repoName 的分支列表如下："
$branchInfo | Format-Table -Property Index, name, objectId;

# 批量删除逻辑
$inputIndexStr = Read-Host "输入要删除的分支索引，多个用英文逗号分隔（示例：2,4,7）"
$indexArray = $inputIndexStr.Split(',') | ForEach-Object { [int]$_.Trim() }

foreach ($index in $indexArray) {
    $currentBranch = $branchInfo[$index - 1]
    if (-not $currentBranch) {
        Write-Host "索引$index 不存在，已跳过" -ForegroundColor Yellow
        continue
    }
    Write-Host "正在删除分支：$($currentBranch.name)" -ForegroundColor Red
    az repos ref delete --name $currentBranch.name --object-id $currentBranch.objectId --organization $organizationURL --project $projectName --repository $repoName
    Write-Host "分支$($currentBranch.name) 删除成功" -ForegroundColor Green
}

Write-Host "所有操作执行完成！"

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