如何在 PowerShell 中使用 Rest API 创建服务更改

问题描述

我需要使用 PowerShell 中的 Rest API 在 Azure DevOps（TFS 工作项）中创建一个服务变更。

我当前的代码对于任务创建工作正常。但我必须创建一个服务变更。我不确定 Resource Area IDs。我应该使用哪个 URI？

$relDefUrl = $DOConfig.tfsBaseUrl + $DOConfig.project + "/_apis/wit/workitems/`$task?api-version=5.1"

function Init-Devops
{
  [CmdletBinding()]
  param(
      $Pat
    )
    PROCESS
    {
        $orgUrl = "https://dev.azure.com/XXXXXX"
        $project = "XXXX"
        $Team = "XXXX"
        $token = [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes(":$($Pat)"))
        $header = @{authorization = "Basic $token"}
        $WorkItemTrackingAreaId = "85f8c7b6-92fe-4ba6-8b6d-fbb67c809341"
        $tfsBaseUrl = GetUrl -orgUrl $orgUrl -header $header -AreaId $WorkItemTrackingAreaId
        $DOConfig=@{
            "orgUrl"=$orgUrl;
            "project"=$project;
            "token"=$token;
            "header"=$header;
            "WorkItemTrackingAreaId"=$TFSQuery;
            "TFSQuery"=$TFSQuery;
            "tfsBaseUrl"=$tfsBaseUrl
            "Team"=$Team
        }
    return $DOConfig
    }
}

function GetUrl() {
    param(
        [string]$orgUrl,[hashtable]$header,[string]$AreaId
    )
    $orgResourceAreasUrl = [string]::Format("{0}/_apis/resourceAreas/{1}?api-preview=5.0-preview.1",$orgUrl,$AreaId)
    $results = Invoke-RestMethod -Uri $orgResourceAreasUrl -Headers $header
    if ("null" -eq $results) {
        $areaUrl = $orgUrl
    }
    else {
        $areaUrl = $results.locationUrl
    }
    return $areaUrl
}

function Add-DevopsTask
{
  [CmdletBinding()]
  param(
    $Body,$DOConfig,$Live
    )
    PROCESS
    {
        $relDefUrl = $DOConfig.tfsBaseUrl + $DOConfig.project + "/_apis/wit/workitems/`$task?api-version=5.1"
        $RestParams = @{
            Uri         = $relDefUrl   
            ContentType = 'application/json-patch+json'
            Headers     = $DOConfig.header
            Method      = "POST"
            Body        = $Body
        }
        Invoke-RestMethod @RestParams -Verbose          
    }
}

$pat = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
$DOConfig=Init-Devops $pat

$xbody=@()
$vstate="Proposed"
$xState = @{
            op    = "add"
            path  = "/fields/System.State"
            value = $vstate
           }
$xbody += $xState

$vAssignedto = '[e-mail]'
$xAssignedto = @{
                op    = "add"
                path  = "/fields/System.AssignedTo"
                value = $vAssignedto
                }
$xbody += $xAssignedto

$vTitle = "Compliance Project Test Task"
$xTitle = @{
            op    = "add"
            path  = "/fields/System.Title"
            value = $vTitle
            }
$xbody += $xTitle

$vTags = "CPXCompliance"
$xTags = @{
            op    = "add"
            path  = "/fields/System.Tags"
            value = $vTags
          }
$xbody += $xTags

$vAreaPath = "OSGS\CRE\Store Core\CSTSRE"
$xAreaPath = @{
                op    = "add"
                path  = "/fields/System.AreaPath"
                value = $vAreaPath
            }
$xbody += $xAreaPath
$body=$xbody | ConvertTo-Json

Add-DevopsTask $body $DOConfig

解决方法

实际上，我浏览了可用字段，并且能够使用 PowerShell 创建服务更改。我休息一下。感谢您的帮助。

我们可以使用下面的 WorkItemTrackingAreaId 来创建 Service Change。

$WorkItemTrackingAreaId = "85f8c7b6-92fe-4ba6-8b6d-fbb67c809341"