Azure DevOps Pipelines PowerShell任务：如何捕获RetryHelper相关信息

Azure DevOps的RetryHelper是任务层级的内置重试机制，不会暴露为PowerShell会话内的变量或可直接查询的对象，你之前尝试的Get-Variable、$warnings、Get-ScheduledTask都无法获取到它的运行信息，核心原因如下：

• RetryHelper由Azure DevOps Agent在任务外部管控，不属于PowerShell脚本的执行上下文，因此PowerShell内部无法直接访问它的状态。
• 控制台输出的##[warning]RetryHelper encountered task failure, will retry (attempt #: 2 out of 3) after 4000 ms是Agent直接输出的日志，不会被捕获到PowerShell的$warnings变量中。

如果需要在PowerShell脚本内感知重试次数或状态，可以通过以下两种方式实现：

1. 自定义重试逻辑替代内置RetryHelper #

放弃任务控制选项里的内置重试，在PowerShell脚本内自行实现重试逻辑，从而完全掌控重试次数、间隔和状态：

$maxRetries = 3
$retryIntervalMs = 4000
$currentAttempt = 1

do {
    try {
        # 替换为你的核心任务逻辑
        Write-Host "执行任务，尝试次数：$currentAttempt"
        # 模拟失败（测试时可注释）
        throw "任务执行失败"
        
        # 任务成功则跳出循环
        break
    }
    catch {
        if ($currentAttempt -lt $maxRetries) {
            Write-Warning "任务失败，将在$retryIntervalMs毫秒后重试（尝试 #: $($currentAttempt+1) out of $maxRetries）"
            Start-Sleep -Milliseconds $retryIntervalMs
            $currentAttempt++
        }
        else {
            Write-Error "已达到最大重试次数$maxRetries，任务最终失败"
            throw $_
        }
    }
} while ($currentAttempt -le $maxRetries)

2. 通过Agent环境变量间接感知重试状态 #

Azure DevOps Agent会设置环境变量SYSTEM_TASKATTEMPTCOUNT，可通过它获取当前任务的尝试次数（从1开始计数）：

$currentAttempt = [int]$env:SYSTEM_TASKATTEMPTCOUNT
$maxRetries = 3 # 需与任务控制选项中设置的重试次数保持一致

if ($currentAttempt -gt 1) {
    Write-Host "当前是第$currentAttempt次尝试，最大重试次数为$maxRetries"
}

注意：该环境变量仅能获取当前尝试次数，无法获取重试间隔或剩余重试次数，需手动与任务设置的参数对齐。

总结：内置RetryHelper的运行信息不会暴露给PowerShell脚本上下文，要么自行实现重试逻辑，要么通过SYSTEM_TASKATTEMPTCOUNT环境变量间接获取尝试次数。

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