如何获取Azure自动化Runbook作业完成后的输出及实现作业错误处理

针对你遇到的两个问题，我整理了一套完整的解决方案，既能正确跟踪作业状态完成错误处理，又能获取到作业执行后的输出内容：

核心思路说明 #

你之前遇到的问题根源在于：

• 直接执行Start-AzAutomationRunbook返回的作业对象处于初始的New状态，因为作业刚提交还在排队/激活中，并未实际执行完成
• 添加-Wait参数后，命令会等待作业结束，但返回的仍然是作业元数据对象，而非作业的输出内容——输出需要通过专门的命令去获取

方案1：使用-Wait参数简化等待逻辑 #

如果希望快速实现等待作业完成并获取结果，可以用这个方案：

# 定义Runbook和自动化账户参数
$runbookConfig = @{
    AutomationAccountName = "你的自动化账户名"
    Name                  = "目标Runbook名称"
    ResourceGroupName     = "资源组名称"
    Wait                  = $true  # 等待作业执行完成
    Verbose               = $true  # 可选：查看作业执行进度日志
}

# 提交作业并等待完成
$completedJob = Start-AzAutomationRunbook @runbookConfig

# 错误处理逻辑：检查作业最终状态
if ($completedJob.Status -eq 'Failed') {
    Write-Error "Runbook作业执行失败！作业ID: $($completedJob.JobId)"
    # 这里添加你的自定义错误处理，比如发送警报、触发恢复流程等
}
else {
    # 获取作业的输出内容
    $jobOutput = Get-AzAutomationJobOutput -AutomationAccountName $runbookConfig.AutomationAccountName `
                                           -ResourceGroupName $runbookConfig.ResourceGroupName `
                                           -Id $completedJob.JobId `
                                           -Stream Output  # 指定获取正常输出流

    # 输出结果（如果是文本输出直接打印，如果是复杂对象可进一步解析）
    Write-Output "作业执行成功，输出内容："
    $jobOutput.Value | ForEach-Object { Write-Output $_.Text }
}

方案2：手动循环检查状态（更灵活） #

如果需要自定义等待间隔、添加进度提示，或者在等待过程中执行其他操作，可以用这个手动轮询的方案：

# 提交作业（不立即等待）
$runbookConfig = @{
    AutomationAccountName = "你的自动化账户名"
    Name                  = "目标Runbook名称"
    ResourceGroupName     = "资源组名称"
}
$job = Start-AzAutomationRunbook @runbookConfig

# 循环检查作业状态，直到进入完成类状态
$waitInterval = 10  # 每10秒检查一次
$inProgressStates = @('New', 'Activating', 'Running')
do {
    Start-Sleep -Seconds $waitInterval
    $job = Get-AzAutomationJob -AutomationAccountName $runbookConfig.AutomationAccountName `
                               -ResourceGroupName $runbookConfig.ResourceGroupName `
                               -Id $job.JobId
    Write-Output "当前作业状态：$($job.Status)"
} while ($inProgressStates -contains $job.Status)

# 状态判断与处理
if ($job.Status -eq 'Failed') {
    Write-Error "Runbook作业执行失败，作业ID: $($job.JobId)"
    # 自定义错误处理逻辑
}
else {
    # 获取作业输出，如需查看错误日志可将-Stream改为Error
    $jobOutput = Get-AzAutomationJobOutput -AutomationAccountName $runbookConfig.AutomationAccountName `
                                           -ResourceGroupName $runbookConfig.ResourceGroupName `
                                           -Id $job.JobId `
                                           -Stream Output

    # 处理输出：如果Runbook返回的是JSON对象，可使用ConvertFrom-Json解析
    Write-Output "作业输出："
    $jobOutput.Value | ForEach-Object {
        if ($_.DataType -eq 'Json') {
            ConvertFrom-Json $_.Text
        }
        else {
            Write-Output $_.Text
        }
    }
}

关键细节补充 #

• 输出流类型：Get-AzAutomationJobOutput的-Stream参数支持Output（正常输出）、Error（错误日志）、Warning、Verbose等，可根据需求选择
• 权限要求：执行命令的账号需要拥有Automation Job Reader和Runbook Operator等相关权限，确保能读取作业状态和输出
• 复杂对象输出：如果你的Runbook返回的是PowerShell对象，输出会被序列化为JSON，可通过ConvertFrom-Json还原为对象进行后续处理

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