about_Output_Streams
简短说明
介绍 PowerShell 中输出流的可用性和用途。
长说明
PowerShell 提供多个输出流。 流为不同类型的消息提供通道。 可以使用关联的 cmdlet 或重定向写入这些流。 有关详细信息,请参阅 about_Redirection。
PowerShell 支持以下输出流。
流# | 说明 | 已引入的版本 | 写入 Cmdlet |
---|---|---|---|
1 | 成功 流 | PowerShell 2.0 | Write-Output |
2 | 错误 流 | PowerShell 2.0 | Write-Error |
3 | 警告 流 | PowerShell 2.0 | Write-Warning |
4 | 详细 流 | PowerShell 2.0 | Write-Verbose |
5 | 调试 流 | PowerShell 2.0 | Write-Debug |
6 | 信息 流 | PowerShell 5.0 | Write-Information |
不适用 | 进度 流 | PowerShell 2.0 | Write-Progress |
注意
进度流不支持重定向。
成功流
成功流是正常成功结果的默认流。
Write-Output
使用 cmdlet 将对象显式写入此流。 此流用于通过 PowerShell 管道传递对象。 成功流连接到本机应用程序的 stdout 流。
错误流
错误流是错误结果的默认流。 Write-Error
使用 cmdlet 显式写入此流。 错误流连接到本机应用程序的 stderr 流。 在大多数情况下,这些错误可以终止执行管道。 写入此流的错误也会添加 $Error
自动变量。 有关详细信息,请参阅 about_Automatic_Variables。
警告流
警告流适用于错误条件,其严重程度低于写入错误流的错误。 在正常情况下,这些警告不会终止执行。 警告不会写入 $Error
自动变量。 Write-Warning
使用 cmdlet 显式写入此流。
详细流
详细流适用于帮助用户在交互或从脚本中运行时对命令进行故障排除的消息。 Write-Verbose
使用 cmdlet 将消息显式写入此流。 许多 cmdlet 提供详细输出,有助于了解 cmdlet 的内部工作。 仅当使用 -Verbose
通用参数时,详细消息才会输出。 有关详细信息,请参阅 about_CommonParameters。
调试流
调试流用于帮助脚本编写者了解其代码失败的原因的消息。 Write-Debug
使用 cmdlet 显式写入此流。 仅当使用 -Debug
通用参数时,调试消息才会输出。 有关详细信息,请参阅 about_CommonParameters。
调试消息适用于脚本和 cmdlet 开发人员,而不是最终用户。 这些调试消息可以包含深度故障排除所需的内部详细信息。
信息流
信息流旨在提供有助于用户了解脚本执行的操作的消息。 开发人员也可以使用它作为用于通过 PowerShell 传递信息的其他流。 开发人员可以标记流数据并具有该流的特定处理。 Write-Information
使用 cmdlet 显式写入此流。
进度流
进度流用于在较长的运行命令和脚本中传达进度的消息。 Write-Progress
使用 cmdlet 将消息显式写入此流。 进度流不支持重定向。