如何通过Azure DevOps API使用PowerShell克隆经典生成管道

报错提示definition.Process为空，是因为你手动构造的请求体缺失了管道核心的流程配置字段，同时代码还有多处语法和逻辑错误。

• 你请求获取到原管道定义后，没有复用原管道的Process（任务流程）、Queue（代理队列）等必填字段，自行构造的JSON只包含了仓库信息，字段不全
• 手动定义的$JSON不是合法的PowerShell JSON字符串，也没有做变量转义，实际提交时服务端无法识别
• POST提交克隆请求时用错了URL，误用了查询原管道的$build_url，而不是你定义的克隆接口地址$clone_url
• 手动指定了id字段，克隆管道时id由服务端自动生成，手动传值会导致冲突

$resp = Invoke-RestMethod -Uri $url -Method GET -UseDefaultCredential -ContentType "application/json" -Headers $headers

foreach($pipe_id in $resp.value.id)
{
    Write-Output "正在处理管道ID：$pipe_id"
    # 获取原管道定义，先操作PS对象不要直接转JSON
    $build_url = "https://dev.azure.com/$organization/$project/_apis/build/definitions/$pipe_id?api-version=5.0-preview.7"
    $original_def = Invoke-RestMethod -Uri $build_url -Method GET -UseDefaultCredential -ContentType "application/json" -Headers $headers

    # 修改需要自定义的字段
    $original_def.name = "common-clone"
    $original_def.path = "\Releases"
    $original_def.repository.id = "repo_id"
    $original_def.repository.name = "common"
    $original_def.repository.url = "https://dev.azure.com/$organization/$project/_git/common"
    $original_def.repository.defaultBranch = "refs/heads/Releases/Release_branch"
    $original_def.repository.properties.cleanOptions = "1"
    $original_def.repository.properties.labelSources = "0"
    # 其他仓库配置按需修改

    # 清除不需要的字段，避免提交冲突
    $original_def.PSObject.Properties.Remove('id')
    $original_def.PSObject.Properties.Remove('revision')
    $original_def.PSObject.Properties.Remove('createdDate')
    $original_def.PSObject.Properties.Remove('lastChangedDate')
    $original_def.PSObject.Properties.Remove('url')
    $original_def.PSObject.Properties.Remove('_links')

    # 转成深度足够的JSON，避免嵌套字段被截断
    $post_body = $original_def | ConvertTo-Json -Depth 10

    # 提交克隆请求
    $clone_url = "https://dev.azure.com/$organization/$project/_apis/build/definitions?api-version=5.0-preview.7"
    $res = Invoke-RestMethod -Uri $clone_url -Method POST -Body $post_body -UseDefaultCredential -ContentType "application/json" -Headers $headers
    Write-Output "克隆成功，新管道ID：$($res.id)"
}

• 转JSON时一定要加-Depth参数，默认深度只有2，会导致嵌套的流程字段被截断
• 如果你需要修改代理队列配置，同步修改$original_def.queue字段为你目标队列的信息即可
• 确保你的账号有对应项目的生成管道创建权限，否则会报权限错误

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