如何让Azure DevOps中Worker脚本调用Library脚本的输出显示在控制台

核心原因 #

Azure DevOps的日志捕获机制对PowerShell的Write-Output输出可能存在传递丢失的情况，尤其是在脚本作用域隔离或输出被变量捕获时。同时，直接用[INFO]这类自定义标记的输出无法被Azure DevOps日志系统识别为对应级别，需要适配其日志命令格式。

解决方案 #

1. 替换Write-Output为Azure DevOps专用日志命令 #

Azure DevOps支持通过特定格式的Write-Host输出将信息标记为不同日志级别，确保输出被正确捕获并显示在日志中。修改Library脚本中的函数：

function Stop-ScheduledTasks {
    # 输出INFO级别日志
    Write-Host "##vso[task.logissue type=info] 正在停止计划任务..."
    
    # 你的任务停止逻辑
    $tasks = Get-ScheduledTask -TaskName "MyTask"
    if ($tasks) {
        Stop-ScheduledTask -TaskName "MyTask"
        Write-Host "##vso[task.logissue type=info] 计划任务已成功停止"
    }
    else {
        # 输出WARNING级别日志
        Write-Host "##vso[task.logissue type=warning] 未找到目标计划任务"
    }
}

function Start-ScheduledTasks {
    Write-Host "##vso[task.logissue type=info] 正在启动计划任务..."
    
    # 你的任务启动逻辑
    try {
        Start-ScheduledTask -TaskName "MyTask"
        Write-Host "##vso[task.logissue type=info] 计划任务已成功启动"
    }
    catch {
        # 输出ERROR级别日志（会标记任务为失败，按需使用）
        Write-Host "##vso[task.logissue type=error] 启动计划任务失败: $_"
    }
}

2. 确保Library脚本正确加载到当前作用域 #

Worker脚本中必须使用点 sourcing方式加载Library脚本，保证函数在当前会话中运行，输出直接传递到控制台：

# Worker脚本开头：点 sourcing 加载库脚本（注意开头的点和空格）
. .\Library.ps1

# 直接调用函数，不要将输出赋值给变量（否则输出会被捕获到变量中，不会显示在日志）
Stop-ScheduledTasks
Start-ScheduledTasks

3. 配置Azure DevOps PowerShell任务的日志捕获设置 #

在发布管道的PowerShell任务中调整以下设置：

• Fail on standard error：设置为False（如果你的自定义警告/信息使用了stderr输出，避免任务误判失败）
• Redirect standard error to standard output：勾选此选项，确保所有输出流都被Azure DevOps捕获
• Enable verbose logging：如果使用Write-Verbose输出信息，需要在任务的"Arguments"中添加-Verbose参数，同时在脚本中设置$VerbosePreference = 'Continue'

4. 备选方案：使用PowerShell原生输出命令适配 #

如果不想使用Azure DevOps专用命令，也可以用PowerShell原生的输出命令，Azure DevOps会自动识别其级别：

• Write-Information：对应INFO级别，需在脚本开头设置$InformationPreference = 'Continue'
• Write-Warning：对应WARNING级别，会自动在Azure DevOps日志中显示为警告
• Write-Error：对应ERROR级别，会标记任务失败（按需使用）

示例：

function Stop-ScheduledTasks {
    $InformationPreference = 'Continue'
    Write-Information "[INFO] 正在停止计划任务..."
    
    # 逻辑代码
    Write-Warning "[WARNING] 任务停止耗时较长"
    Write-Information "[OK] 任务停止完成"
}

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