如何让Azure Pipelines中PowerShell任务的自定义错误消息显示在任务摘要及邮件通知中并终止任务？

我之前在Azure Pipelines里也踩过这个坑——明明用了官方文档里的日志命令，结果任务摘要和邮件通知里只显示模糊的PowerShell通用错误，自定义消息完全看不到。后来折腾了一阵才找到问题所在，给你分享下解决方法：

1. 换掉Write-Host，用更可靠的输出方式 #

Azure Pipelines的##vso[task.logissue]命令需要通过**标准输出（stdout）**传递，而Write-Host在PowerShell里默认是输出到主机控制台，有时候会被任务的日志处理逻辑忽略。你可以改用这两种写法：

写法一：用Write-Output输出日志命令 #

Write-Output "##vso[task.logissue type=error]Something went very wrong."
exit 1

写法二：直接输出字符串（PowerShell默认会丢到stdout） #

"##vso[task.logissue type=error]Something went very wrong."
exit 1

这两种写法都能让自定义错误消息被Azure Pipelines正确捕获，既会显示在任务的日志详情里，也会出现在任务摘要的错误板块中，邮件通知里也能看到这条自定义内容。同时exit 1会确保任务被标记为失败状态。

2. 检查PowerShell任务的配置 #

除了脚本本身，任务的设置也可能影响效果：

• 打开你的PowerShell脚本任务编辑界面，确认**错误操作（Error Action）**设置为Stop或者Continue（默认是Stop，如果设成Ignore的话，任务不会失败）
• 别勾选Fail on standard error选项，不然可能会覆盖自定义错误的显示逻辑

3. 验证效果 #

调整完脚本和配置后重新运行管道，你就能在：

• 任务的日志详情里看到清晰的自定义错误
• 任务摘要的「错误」区域找到这条消息，邮件通知也会同步包含它

为啥原来的写法不行？ #

简单说，Write-Host是给人看的控制台输出，Azure Pipelines的日志收集系统更信任标准输出（stdout）和标准错误（stderr），所以直接用Write-Output或者裸输出字符串，比Write-Host稳定得多，官方文档里的例子可能只是示意，实际用的时候得调整下输出方式。

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