Azure DevOps Rest API交互式与PowerShell调用返回结果不一致问题

核心问题分析 #

1. URL特殊字符解析错误：PowerShell中双引号包裹的字符串里，&会被当作命令分隔符处理，导致你的URL被截断，api-version参数丢失，API默认返回最顶层数据。
2. depth参数不一致：你交互式调用用的是$depth=4，但脚本里写的是$depth=2，层级参数值过小，无法获取下级查询节点。
3. 认证变量错误：脚本里定义了$user变量，但拼接认证信息时用了未定义的$token，可能导致认证异常。

解决步骤 #

1. 统一depth参数值：将脚本中的$depth=2改为$depth=4，和交互式调用保持一致，确保能获取足够层级的子查询。
2. 正确处理URL中的&符号：三种可选方式：
   • 用单引号包裹URL，避免PowerShell解析内部特殊字符：

     $posturl= 'https://dev.azure.com/{organization}/{project}/_apis/wit/queries?$depth=4&api-version=7.1-preview.2'
     

   • 在双引号中对&转义（Windows PowerShell用^，PowerShell Core用\）：

     # Windows PowerShell
     $posturl= "https://dev.azure.com/{organization}/{project}/_apis/wit/queries?$depth=4^&api-version=7.1-preview.2"
     # PowerShell Core
     $posturl= "https://dev.azure.com/{organization}/{project}/_apis/wit/queries?$depth=4\&api-version=7.1-preview.2"
     

   • 将&替换为HTML实体&：

     $posturl= "https://dev.azure.com/{organization}/{project}/_apis/wit/queries?$depth=4&api-version=7.1-preview.2"
     

3. 修正认证变量：Azure DevOps的Basic认证用户名可留空，只需传入PAT作为密码，统一变量名避免错误：

   $token = "my patcode"
   $base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f "", $token)))
   

4. 避免JSON截断：给ConvertTo-Json添加-Depth参数，防止默认深度不够导致子节点被截断：

   | ConvertTo-Json -Depth 10
   

修正后的完整脚本 #

$token = "my patcode"
$base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f "", $token)))
$posturl= 'https://dev.azure.com/{organization}/{project}/_apis/wit/queries?$depth=4&api-version=7.1-preview.2'

Invoke-RestMethod -Uri $PostUrl -Method Get -ContentType "application/json" -Headers @{Authorization= ("Basic {0}" -f $base64AuthInfo)} | ConvertTo-Json -Depth 10

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