关于输出流

---

简短描述

解释 PowerShell 中输出流的可用性和用途。

详细描述

PowerShell 提供多个输出流。流为不同类型的消息提供通道。您可以使用关联的 cmdlet 或重定向写入这些流。有关详细信息，请参阅 about_Redirection。

PowerShell 支持以下输出流。

Stream # Description Introduced in Write Cmdlet 1 Success stream PowerShell 2.0 Write-Output 2 Error stream PowerShell 2.0 Write-Error 3 Warning stream PowerShell 2.0 Write-Warning 4 Verbose stream PowerShell 2.0 Write-Verbose 5 Debug stream PowerShell 2.0 Write-Debug 6 Information stream PowerShell 5.0 Write-Information n/a Progress stream PowerShell 2.0 Write-Progress

笔记

进度流不支持重定向。

成功流

成功流是正常成功结果的默认流。使用Write-Output cmdlet 将对象显式写入此流。此流用于通过 PowerShell 管道传递对象。 Success 流连接到本机应用程序的 stdout 流。

错误流

Error 流是错误结果的默认流。使用 Write-Error cmdlet 显式写入此流。 Error 流连接到本机应用程序的 stderr 流。在大多数情况下，这些错误可能会终止执行管道。写入此流的错误也会添加到 $Error 自动变量中。有关详细信息，请参阅 about_Automatic_Variables。

警告流

Warning 流适用于比写入 Error 流的错误不太严重的错误情况。在正常情况下，这些警告不会终止执行。警告不会写入 $Error 自动变量。使用 Write-Warning cmdlet 显式写入此流。

详细流

详细流旨在用于帮助用户在交互运行或从脚本运行命令时排除命令故障的消息。使用 Write-Verbose cmdlet 将消息显式写入此流。许多 cmdlet 提供详细的输出，这对于了解 cmdlet 的内部工作原理非常有用。仅当使用 -Verbose 公共参数时才会输出详细消息。有关更多信息，请参阅 about_CommonParameters。

调试流

调试流用于帮助脚本编写者了解代码失败原因的消息。使用 Write-Debug cmdlet 显式写入此流。仅当使用-Debug公共参数时才会输出调试消息。有关更多信息，请参阅 about_CommonParameters。

调试消息更多的是针对脚本和 cmdlet 开发人员而不是最终用户。这些调试消息可以包含深度故障排除所需的内部详细信息。

信息流

信息流旨在提供帮助用户了解脚本正在执行的操作的消息。开发人员还可以将其用作通过 PowerShell 传递信息的附加流。开发人员可以标记流数据并对该流进行特定处理。使用Write-Information cmdlet 显式写入此流。

Write-Host 还会写入信息流。这些 cmdlet 之间的区别在于，Write-Host 也会写入主机控制台，除非您重定向信息流。 Write-Information 仅写入Information 流。

进度流

进度流用于在较长时间运行的命令和脚本中传达进度的消息。使用 Write-Progress cmdlet 将消息显式写入此流。 进度流不支持重定向。

参见

• about_公共参数
• about_重定向
• Write-Debug
• Write-Error
• Write-Host
• Write-Information
• Write-Output
• Write-Progress
• Write-Verbose
• Write-Warning