Azure DevOps添加UAT预部署工件分支后发布定义空白，求代码优化

我尝试将新分支release/24.3添加至目标环境UAT，作为预部署工件的前置条件。但运行代码后，发布定义无法显示，仅呈现空白页面。恳请帮忙审查并改进我的代码。

原始代码片段 #

$organization = "org"
$project = "contoso"
$token = "weird_token"

$token = [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes(":$($token)"))

$definitionids = 510

$branchName = "release/24.3"
$targetEnv = "UAT"

foreach ($definitionid in $definitionids) 
{
    $url = "https://vsrm.dev.azure.com/${organization}/${project}/_apis/release/definitions/${definitionId}?api-version=7.0"

    $Def = Invoke-RestMethod -Uri $url -Headers @{Authorization = "Basic $token" } -Method GET -ContentType application/json
    
    $envId = 0
    $targetEnvId = 0

    foreach ($environment in $Def.environments)
    {
        $environmentName = $environment.name
        $envId++

        if ( $environmentName -eq $targetEnv )
        {
            Write-Host "INFO: Environment Name is $environmentName"
            
            $targetEnvId = $envId

            foreach ($condition in $environment.conditions)
            {
                if ($condition.conditionType -eq 'artifact')
                {
                    $newCondition = @{
                        sourceBranch = "$branchName"
                        tagFilter = $null
                        useBuildDefinitionBranch = $false
                        createReleaseOnBuildTagging = $false
                    }

                    Write-Host "INFO: Target Environment ID is $targetEnvId"

                    $artifactConditions = $Def.environments[$targetEnvId].conditions
                    $artifactConditions += $newCondition
                    $Def.environments[$targetEnvId].conditions = $artifactConditions
                    $updateDef_body = @($Def) | ConvertTo-Json -Depth 100

                    $updateDef_body

                    Write-Host "INFO: adding release branch to release '$branchName' to release pipeline"
                    $updateDef_uri = "https://vsrm.dev.azure.com/${organization}/${project}/_apis/release/definitions?api-version=7.0"
                    $updateDef = Invoke-RestMethod -Uri $updateDef_uri -Headers @{Authorization = "Basic $token" } -Method PUT -Body $updateDef_body -ContentType application/json
                    $updateDef
                }
            }
        }
    }
}

问题分析与修复方案 #

关键错误点 #

• 数组索引错误：PowerShell数组采用0索引，但代码中$envId从1开始计数，导致$Def.environments[$targetEnvId]访问错误的环境对象，甚至触发越界问题。
• 错误包装数组：@($Def) | ConvertTo-Json将发布定义对象强制包装成数组，而Azure DevOps API要求PUT请求体为单个对象，这会导致API解析失败，直接破坏定义结构。
• 重复更新请求：遍历每个artifact条件时都执行PUT请求，会重复添加分支条件，导致条件列表冗余，引发结构错误。
• 缺少必要属性：新的artifact条件未包含conditionType: 'artifact'字段，API无法识别条件类型，导致定义损坏。
• PUT请求URL错误：更新发布定义的URL必须包含definitionId，否则API无法定位目标定义。

修复后的代码 #

$organization = "org"
$project = "contoso"
$token = "weird_token"

# 转换令牌为Base64格式
$token = [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes(":$token"))

$definitionids = 510
$branchName = "release/24.3"
$targetEnv = "UAT"

foreach ($definitionid in $definitionids) 
{
    # 获取发布定义详情
    $getUrl = "https://vsrm.dev.azure.com/${organization}/${project}/_apis/release/definitions/${definitionId}?api-version=7.0"
    $Def = Invoke-RestMethod -Uri $getUrl -Headers @{Authorization = "Basic $token" } -Method GET -ContentType application/json
    
    # 遍历环境，找到目标UAT环境
    for ($i = 0; $i -lt $Def.environments.Count; $i++) {
        $environment = $Def.environments[$i]
        if ($environment.name -eq $targetEnv) {
            Write-Host "INFO: 找到目标环境: $targetEnv"
            
            # 检查是否已存在相同分支的artifact条件，避免重复添加
            $hasExistingBranch = $environment.conditions | Where-Object {
                $_.conditionType -eq 'artifact' -and $_.sourceBranch -eq $branchName
            }
            
            if (-not $hasExistingBranch) {
                # 构造新的artifact分支条件
                $newCondition = @{
                    conditionType = 'artifact'
                    sourceBranch = $branchName
                    tagFilter = $null
                    useBuildDefinitionBranch = $false
                    createReleaseOnBuildTagging = $false
                }
                
                # 添加新条件到环境的条件列表
                $Def.environments[$i].conditions += $newCondition
                
                # 转换为JSON（注意不要包装成数组）
                $updateDef_body = $Def | ConvertTo-Json -Depth 100
                
                # 更新发布定义的URL（必须包含definitionId）
                $updateUrl = "https://vsrm.dev.azure.com/${organization}/${project}/_apis/release/definitions/${definitionId}?api-version=7.0"
                
                Write-Host "INFO: 正在将分支 $branchName 添加到发布管道"
                $updateDef = Invoke-RestMethod -Uri $updateUrl -Headers @{Authorization = "Basic $token" } -Method PUT -Body $updateDef_body -ContentType application/json
                
                Write-Host "INFO: 更新成功，定义ID: $($updateDef.id)"
            } else {
                Write-Host "INFO: 分支 $branchName 已存在于目标环境的条件中，无需重复添加"
            }
            break # 找到目标环境后退出循环，避免遍历其他环境
        }
    }
}

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