使用PowerShell调用Azure Test Plan API更新测试点测试人员信息时遇`tester`参数为空异常排查

我刚碰到过一模一样的问题，这个错误的核心原因很明确：你只传递了tester的displayName，但Azure Test Plan的Patch API没办法仅通过显示名定位到唯一用户——毕竟存在重名的可能性，所以API会判定tester参数无效（等同于空值）。

下面是具体的排查和解决步骤：

1. 先获取目标测试人员的完整身份标识 #

Azure DevOps API需要用户的唯一标识（比如id或uniqueName即用户邮箱）来确认测试人员。你可以先调用Identity API拿到这些关键信息：

# 替换成你的组织名和目标用户名
$orgName = "MyOrg"
$targetUserName = "Veeresh Kokkalla"

$userUri = "https://dev.azure.com/$orgName/_apis/identities?searchFilter=General&value=$targetUserName&api-version=6.0"
$userInfo = Invoke-RestMethod -Uri $userUri -Headers $headers -Method Get

# 取第一个匹配的用户（如果有重名，需要添加额外逻辑筛选）
$targetUser = $userInfo.value[0]

执行后，$targetUser里会包含用户的id、uniqueName、displayName等核心字段。

2. 修改请求体，使用正确的身份字段 #

把原来的请求体改成包含唯一标识的格式，推荐用id（最可靠的唯一标识）：

$testerNameBody = @{ 
    tester = @{ 
        "id" = $targetUser.id
        "displayName" = $targetUser.displayName
    } 
}
# 一定要加-Depth参数，避免JSON序列化时丢失嵌套字段
$testerName = $testerNameBody | ConvertTo-Json -Depth 10

如果是外部用户，id可能无效，可以换成uniqueName（用户邮箱）试试：

$testerNameBody = @{ 
    tester = @{ 
        "uniqueName" = $targetUser.uniqueName
        "displayName" = $targetUser.displayName
    } 
}

3. 验证并重新执行请求 #

先打印生成的JSON确认格式正确：

Write-Output $testerName

然后再执行Patch请求：

$UpdateTesterNameUri = "https://dev.azure.com/MyOrg/MyProj/_apis/test/Plans/" + $Id + "/Suites/121221/points/" + $node + "?api-version=6.0"
Invoke-RestMethod -Uri $UpdateTesterNameUri -Headers $headers -Method Patch -Body $testerName -ContentType 'application/json'

额外排查点 #

• 确认你的$headers里包含有效的PAT令牌，且令牌拥有Test Management > Read & Write的权限；
• 检查$Id和$node变量是否正确，确保API URL指向了有效的测试计划和测试点；
• 如果测试点本身从未关联过测试人员，也可能触发类似错误，但你的情况是调试时确认字段有值，所以主要还是身份标识的问题。

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