PowerShell循环逻辑错误导致Azure DevOps管道运行数据拉取失败

• 接口调用顺序错位：「获取管道运行」的请求是在未获取项目名称、管道ID的阶段提前执行的，此时URL中的$projectname、$id均为空值，请求无法正常返回有效数据。
• 循环层级逻辑错配：原本需要按「项目→管道→管道运行记录」的层级逐次遍历，当前代码将空值初始化的运行结果数组放到外层循环维度，导致遍历过程无有效数据匹配。
• 变量字段赋值错配：代码中把管道ID的数组直接赋值给$lastrundate，和需要获取的「最新运行时间」字段完全不对应，即使拿到数据也会出现字段错填。
• 数据写入效率低下：每遍历一个管道就执行一次Export-Csv -Append，重复触发文件打开、写入、关闭的IO操作，不仅运行效率低，还容易出现CSV格式串行、文件占用的问题。

调整逻辑严格匹配接口依赖关系：全量项目拉取 → 逐项目拉取管道列表 → 逐管道拉取最新1条运行记录 → 全量数据内存收集完成后一次性导出，减少不必要的重复请求和IO开销。

$personalToken = "****************************"
# 基础认证逻辑保持不变
$token = [System.Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$($personalToken)"))
$header = @{authorization = "Basic $token" }
# 初始化结果收集数组
$resultList = @()

# 第一步：拉取组织下所有项目
$projecturl = "https://dev.azure.com/*******/_apis/projects?api-version=6.0"
$projects = Invoke-RestMethod -Uri $projecturl -Method Get -ContentType "application/json" -Headers $header

foreach ($project in $projects.value) {
    Write-Host "正在处理项目：$($project.name)"
    $projectName = $project.name

    # 第二步：拉取当前项目下的所有管道
    $pipelineListUrl = "https://dev.azure.com/*********/$projectName/_apis/pipelines?api-version=6.0-preview.1"
    $pipelineList = Invoke-RestMethod -Uri $pipelineListUrl -Method Get -ContentType "application/json" -Headers $header

    foreach ($pipeline in $pipelineList.value) {
        $pipelineId = $pipeline.id
        # 第三步：调用当前管道的运行接口，仅拉取最新1条运行记录减少返回数据量
        $latestRunUrl = "https://dev.azure.com/*********/$projectName/_apis/pipelines/$pipelineId/runs?api-version=6.0-preview.1&`$top=1&orderBy=finishedDateDescending"
        $latestRun = Invoke-RestMethod -Uri $latestRunUrl -Method Get -ContentType "application/json" -Headers $header

        # 组装单条结果对象
        $obj = [PSCustomObject]@{
            ProjectName   = $projectName
            PipelineName  = $pipeline.name
            PipelineFolder = $pipeline.folder
            PipelineID    = $pipelineId
            PipelineURL   = $pipeline._links.web.href
            LatestRunID   = $latestRun.value[0].id
            LastRunDate   = $latestRun.value[0].finishedDate
        }
        $resultList += $obj
    }
}

# 所有数据收集完成后一次性导出CSV
$resultList | Export-Csv -Path "c:\Temp\AzDoPipelineReport.csv" -NoTypeInformation -Encoding UTF8

• 调用管道运行接口时加上$top=1&orderBy=finishedDateDescending参数，不需要拉取该管道的全量运行历史，仅返回最新1条记录，能大幅减少接口响应的数据包大小，缩短请求耗时。
• 用[PSCustomObject]替代New-Object+Add-Member的写法，对象创建速度更快、代码更简洁。
• 全量数据收集完成后一次性导出CSV，相比逐行追加写入，在管道数量较多的场景下IO效率能提升数倍。

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