Azure DevOps发布流水线部署统计PowerShell脚本无数据求助

你编写的PowerShell脚本未返回数据，核心问题集中在Azure DevOps API请求的语法、授权逻辑以及过滤条件上，以下是具体排查点和修复方法：

1. API过滤条件逻辑错误 #

原脚本的filter参数存在逻辑运算符优先级问题：AND的优先级高于OR，导致实际生效的条件是所有成功的部署（不限制时间） + 时间范围内失败的部署，完全不符合你"提取近2周内成功/失败部署"的需求。

修复方法：将状态判断的部分用括号包裹，确保时间范围同时作用于两种状态：

$filter = "(deploymentStatus eq 'succeeded' or deploymentStatus eq 'failed') and startedTime ge $startDate and startedTime le $endDate"
$queryUrl = "$baseUrl/_apis/release/deployments?definitionId=$pipelineId&top=100&expand=All&filter=$filter"

2. PAT授权格式错误 #

Azure DevOps REST API不支持Bearer授权方式，必须使用Basic Auth：将PAT转换为user:PAT格式的Base64编码字符串（user部分留空即可）。

修复方法：替换授权头的生成逻辑：

$patToken = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$pat"))
$headers = @{Authorization = "Basic $patToken"}

3. API参数语法错误 #

原URL中的$top、$expand、$filter前缀的$是多余的，这些是URL查询参数，不需要PowerShell变量符号。

4. 增加数据验证步骤 #

在处理API返回数据前，先验证是否获取到有效数据，避免后续逻辑空转：

if (-not $response.value -or $response.value.Count -eq 0) {
    Write-Host "未获取到符合条件的部署数据"
    exit
}

修正后的完整脚本 #

# 设置Azure DevOps组织和项目名称
$orgName = "<org-name>"
$projectName = "<project-name>"

# 设置Azure DevOps发布流水线ID和阶段名称
$pipelineId = <pipeline-id>                       
$stageNames = @("<stage-name-1>", "<stage-name-2>", "<stage-name-3>")

# 设置Azure DevOps PAT和基础URL
$pat = "<personal-access-token>"
$baseUrl = "https://dev.azure.com/$orgName/$projectName"

# 设置查询的日期范围
$startDate = (Get-Date).AddDays(-14).ToString("yyyy-MM-ddTHH:mm:ssZ")
$endDate = (Get-Date).ToString("yyyy-MM-ddTHH:mm:ssZ")

# 构建正确的过滤条件
$filter = "(deploymentStatus eq 'succeeded' or deploymentStatus eq 'failed') and startedTime ge $startDate and startedTime le $endDate"
# 创建Azure DevOps REST API查询URL
$queryUrl = "$baseUrl/_apis/release/deployments?definitionId=$pipelineId&top=100&expand=All&filter=$filter"

# 生成正确的Basic Auth授权头
$patToken = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$pat"))
$headers = @{Authorization = "Basic $patToken"}

try {
    $response = Invoke-RestMethod -Uri $queryUrl -Headers $headers -Method Get -ErrorAction Stop

    # 验证是否获取到数据
    if (-not $response.value -or $response.value.Count -eq 0) {
        Write-Host "未获取到符合条件的部署数据"
        exit
    }

    # 创建新的Excel工作簿和工作表
    $excel = New-Object -ComObject Excel.Application
    $workbook = $excel.Workbooks.Add()
    $worksheet = $workbook.Worksheets.Item(1) # 使用默认第一个工作表，避免重复添加

    # 将部署结果写入Excel工作表
    $row = 1
    $col = 1
    $worksheet.Cells.Item($row, $col) = "Stage"
    $worksheet.Cells.Item($row, $col+1) = "Successful Count"
    $worksheet.Cells.Item($row, $col+2) = "Failed Count"
    $row++

    foreach ($stageName in $stageNames) {
        $stageDeployments = $response.value | Where-Object {$_.releaseEnvironment.name -eq $stageName}
        $successfulCount = ($stageDeployments | Where-Object {$_.deploymentStatus -eq "succeeded"}).Count
        $failedCount = ($stageDeployments | Where-Object {$_.deploymentStatus -eq "failed"}).Count
        
        $worksheet.Cells.Item($row, $col) = $stageName
        $worksheet.Cells.Item($row, $col+1) = $successfulCount
        $worksheet.Cells.Item($row, $col+2) = $failedCount
        
        $row++
    }

    # 保存Excel工作簿并关闭Excel应用
    $workbook.SaveAs("$PWD\DeploymentResults.xlsx") # 使用当前路径确保可找到文件
    $excel.Quit()
    # 清理COM对象避免内存泄漏
    [System.Runtime.Interopservices.Marshal]::ReleaseComObject($worksheet) | Out-Null
    [System.Runtime.Interopservices.Marshal]::ReleaseComObject($workbook) | Out-Null
    [System.Runtime.Interopservices.Marshal]::ReleaseComObject($excel) | Out-Null
    [GC]::Collect()
    [GC]::WaitForPendingFinalizers()
}
catch {
    Write-Host "请求API或处理数据时出错: $_"
}

额外优化说明：

• 增加try/catch块捕获错误，便于排查API请求问题
• 优化Excel对象的清理逻辑，避免后台残留Excel进程
• 指定Excel文件保存到当前工作目录，方便查找

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