Azure DevOps分支策略跨仓库复制失败，求解决方案

错误原因分析 #

触发PolicyChangeRejectedByPolicyException错误，通常是以下原因：

• 执行脚本的账号没有目标项目的分支策略管理权限（需添加到项目级的「分支策略管理员」组）
• 目标项目存在限制策略修改的规则，比如「必须通过拉取请求修改分支策略」

修复后的PowerShell脚本 #

以下脚本修复了原版本的变量错误、策略范围过滤、目标项目指向等问题，支持跨仓库复制分支策略：

[CmdletBinding()]
param(
    [Parameter(Mandatory=$true)][string] $AzureDevOpsPAT,
    [Parameter(Mandatory=$true)][string] $OrganizationName,
    [Parameter(Mandatory=$true)][string] $SourceProjectName,
    [Parameter(Mandatory=$true)][string] $SourcerepositoryName,
    [Parameter(Mandatory=$true)][string] $SourceBranch,
    [Parameter(Mandatory=$true)][string] $TargetProjectName,
    [Parameter(Mandatory=$true)][string] $TargetrepositoryName,
    [Parameter(Mandatory=$true)][string] $TargetBranch
)

$ErrorActionPreference = 'Stop'
$User = ""
$base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f $User, $AzureDevOpsPAT)))
$header = @{Authorization = ("Basic {0}" -f $base64AuthInfo)}

# 获取源仓库信息
$sourceRepoUrl = "https://dev.azure.com/$OrganizationName/$SourceProjectName/_apis/git/repositories/$SourcerepositoryName?api-version=7.1-preview.1"
$sourceRepo = Invoke-RestMethod -Uri $sourceRepoUrl -Method Get -ContentType application/json -Headers $header

# 获取源仓库指定分支的策略（仅获取该分支关联的策略）
$sourcePoliciesUrl = "https://dev.azure.com/$OrganizationName/$SourceProjectName/_apis/policy/configurations?repositoryId=$($sourceRepo.id)&refName=refs/heads/$SourceBranch&api-version=7.1-preview.1"
$sourcePolicies = Invoke-RestMethod -Uri $sourcePoliciesUrl -Method Get -ContentType application/json -Headers $header

# 获取目标仓库信息
$targetRepoUrl = "https://dev.azure.com/$OrganizationName/$TargetProjectName/_apis/git/repositories/$TargetrepositoryName?api-version=7.1-preview.1"
$targetRepo = Invoke-RestMethod -Uri $targetRepoUrl -Method Get -ContentType application/json -Headers $header

# 目标项目的策略创建URL
$targetPolicyCreateUrl = "https://dev.azure.com/$OrganizationName/$TargetProjectName/_apis/policy/configurations?api-version=7.1-preview.1"

foreach ($policy in $sourcePolicies.value) {
    # 跳过仓库设置策略（无需复制）
    if ($policy.type.id -eq '0517f88d-4ec5-4343-9d26-9930ebd53069') {
        continue
    }

    # 移除不需要的系统属性
    $policy.PSObject.Properties.Remove('createdBy')
    $policy.PSObject.Properties.Remove('createdDate')
    $policy.PSObject.Properties.Remove('revision')
    $policy.PSObject.Properties.Remove('id')
    $policy.PSObject.Properties.Remove('url')
    $policy._links.PSObject.Properties.Remove('self')

    # 更新策略的作用范围：替换仓库ID和分支名
    foreach ($scope in $policy.settings.scope) {
        if ($scope.repositoryId) {
            $scope.repositoryId = $targetRepo.id
        }
        if ($scope.refName) {
            $scope.refName = "refs/heads/$TargetBranch"
        }
    }

    # 更新搜索分支（如果存在）
    if ($null -ne $policy.settings.searchBranches) {
        $policy.settings.searchBranches = $policy.settings.searchBranches | ForEach-Object {
            $_ -replace "refs/heads/$SourceBranch", "refs/heads/$TargetBranch"
        }
    }

    # 转换为JSON并创建策略
    $body = $policy | ConvertTo-Json -Depth 10
    try {
        $response = Invoke-RestMethod -Uri $targetPolicyCreateUrl -Method Post -Body $body -ContentType application/json -Headers $header
        Write-Output "已成功创建策略：$($policy.type.displayName)"
    }
    catch {
        Write-Warning "创建策略失败 $($policy.type.displayName)：$($_.Exception.Message)"
    }
}

关键修复点说明 #

• 修正变量错误：替换未定义的变量，统一使用英文引号避免语法错误
• 精准获取策略：通过仓库ID和分支名过滤源策略，只复制目标分支需要的规则
• 跨项目创建策略：使用目标项目的API URL创建策略，而非源项目
• 更新策略范围：将策略中的仓库ID替换为目标仓库ID，确保策略绑定到正确仓库
• 添加错误捕获：避免单个策略创建失败导致整个脚本终止

Azure Pipeline 执行方案 #

可以将上述脚本集成到Azure Pipeline中，实现自动化复制分支策略：

1. 在项目中创建一个新的Pipeline，选择「Empty job」
2. 添加一个PowerShell任务，选择「Inline」模式，粘贴上述脚本
3. 在任务的「Arguments」中传入参数：

-AzureDevOpsPAT $(System.AccessToken) -OrganizationName $(System.TeamFoundationCollectionUri) -SourceProjectName 源项目名 -SourcerepositoryName 源仓库名 -SourceBranch 源分支名 -TargetProjectName 目标项目名 -TargetrepositoryName 目标仓库名 -TargetBranch 目标分支名

4. 确保Pipeline的服务账号（Project Collection Build Service）拥有目标项目的分支策略管理员权限

注意：如果使用$(System.AccessToken)，需要在Pipeline设置中开启「允许脚本访问OAuth令牌」选项

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