使用 PowerShell 更新 Azure DevOps 中的服务挂钩

Question

想知道是否有人知道如何做到这一点，因为我一直在努力这样做。

我正在尝试组合一个 PowerShell 脚本，该脚本有望更新我们在 Azure DevOps 中设置的任何服务挂钩，因此它们的状态变为启用。 偶尔ADO会禁用它们，我想是由于长时间不活动，这是一种痛苦。

到目前为止，我有以下内容，但我收到一条错误消息

“服务挂钩订阅“2e0a69e7-c4aa-44ad-89d7-ca1e3809585e”的通知订阅“2092cfc4-a95b-4800-976e-67ccf9deb4b1”不再存在。”

我明白这一点，但不确定如何解决它。 我确定它存在，因为如果我使用 $uri2，在循环中使用 $item 变量之一填充 subscriptionId，然后放入浏览器中，我会得到 json 像这样返回，所以它找到它对吗？

我一直在参考此页面上的各种文档： https://docs.microsoft.com/en-us/rest/api/azure/devops/hooks/subscriptions/replace%20subscription?view=azure-devops-rest- 5.1

我认为我首先需要获取所有 web 挂钩订阅的列表，然后遍历每个获取 ID 的订阅，在另一个请求中使用该 ID 来更新服务挂钩。 我怀疑问题的一半与我对如何完成的理解有关，如果可能的话，我想在这里问。

有没有人完成这个或者可能有一些关于如何更新字段的示例脚本？ 不确定我是否需要将更多数据传递到正文中。

cls

$User = 'myUser'
$PersonalAccessToken = 'myPatToken'
$base64authinfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f  $User, $PersonalAccessToken)))
$vstsAccount = "myOrgName"

$uri1 = "https://dev.azure.com/$vstsAccount/_apis/hooks/subscriptions?api-version=5.1"

$hooks = Invoke-RestMethod -Method Get -ContentType application/json -Uri $uri1 -Headers @{Authorization=("Basic {0}" -f $base64authinfo)}

foreach ($item in $hooks.value) {

    $body = @{
        "publisherId" = "tfs"
        "eventType" = "$($item.eventType)"
        "resourceVersion" = "1.0"
        "consumerId" = "webHooks"
        "consumerActionId" = "httpRequest"
        "status" = "enabled"
    }

    $bodyJson = $body | ConvertTo-Json

    write-host "current status: $($item.status)"
    write-host "$($item.id)"
    write-host "$($item.eventType)"

    $uri2 = "https://dev.azure.com/$vstsAccount/_apis/hooks/subscriptions/$($item.id)?api-version=5.1"
    write-host $uri2
    Invoke-RestMethod -Method Put -ContentType application/json -Uri $uri2 -Headers @{Authorization=("Basic {0}" -f $base64authinfo)} -Body $bodyJson
    
}

Answer 1

使用 PowerShell 更新 Azure DevOps 中的服务挂钩

我可以用您的请求正文重现此问题。

那是因为我们在请求正文中丢失了一些基本参数：

从上图可以看出，如果我注释掉参数projectId ，那么我会得到和你一样的错误。

根据REST API Subscriptions - Replace Subscription的示例，我们可以得到请求正文：

{
  "publisherId": "tfs",
  "eventType": "build.complete",
  "resourceVersion": "1.0-preview.1",
  "consumerId": "webHooks",
  "consumerActionId": "httpRequest",
  "publisherInputs": {
    "buildStatus": "Failed",
    "definitionName": "MyWebSite CI",
    "projectId": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c"
  },
  "consumerInputs": {
    "url": "https://myservice/myhookeventreceiver"
  }
}

所以，我们可以使用这个请求体来调用 REST API。

笔记：

• 在您的请求正文中使用:而不是= 。
• 在请求正文中替换与您的订阅匹配的值，并根据您的需要添加其他参数。

另外，我看到你使用foreach来更新所有的Subscriptions ，但是你需要特别注意的是不是所有Subscription的publisherId 、 consumerId 、 consumerActionId都是一样的。 批量修改时应特别注意这一点。

测试结果：

希望这可以帮助。