about_Output_Streams

Краткое описание

Объясняет доступность и назначение выходных потоков в PowerShell.

Длинное описание

PowerShell предоставляет несколько потоков вывода. Потоки предоставляют каналы для различных типов сообщений. Эти потоки можно записать с помощью связанного командлета или перенаправления. Дополнительные сведения см. в about_Redirection.

PowerShell поддерживает следующие выходные потоки.

Поток #	Описание	Представлено в	Командлет записи
1	поток Success	PowerShell 2.0	Write-Output
2	поток Error	PowerShell 2.0	Write-Error
3	поток Warning	PowerShell 2.0	Write-Warning
4	поток Verbose	PowerShell 2.0	Write-Verbose
5	поток Debug	PowerShell 2.0	Write-Debug
6	поток Information	PowerShell 5.0	Write-Information
n/a	поток Progress	PowerShell 2.0	Write-Progress

Заметка

Поток Progress не поддерживает перенаправление.

поток Success

Поток Success — это поток по умолчанию для обычных успешных результатов. Используйте командлет Write-Output для явной записи объектов в этот поток. Этот поток используется для передачи объектов через конвейер PowerShell. Поток Success подключен к потоку stdout для собственных приложений.

поток Error

Поток Error — это поток по умолчанию для результатов ошибок. Используйте командлет Write-Error для явной записи в этот поток. Поток Error подключен к потоку stderr для собственных приложений. В большинстве случаев эти ошибки могут завершить конвейер выполнения. Ошибки, записанные в этот поток, также добавляются в $Error автоматическую переменную. Дополнительные сведения см. в about_Automatic_Variables.

поток Warning

Поток Warning предназначен для условий ошибки, которые менее серьезны, чем ошибки, записанные в поток Error. В обычных условиях эти предупреждения не завершаются выполнением. Предупреждения не записываются в $Error автоматическую переменную. Используйте командлет Write-Warning для явной записи в этот поток.

поток Verbose

Поток Verbose предназначен для сообщений, которые помогают пользователям устранять неполадки при интерактивном выполнении или из скрипта. Используйте командлет Write-Verbose для явной записи сообщений в этот поток. Многие командлеты предоставляют подробные выходные данные, полезные для понимания внутренних действий командлета. Подробные сообщения выводятся только в том случае, если используется общий параметр -Verbose. Дополнительные сведения см. в about_CommonParameters.

поток Debug

Поток Debug используется для сообщений, которые помогают скриптам понять, почему их код завершается ошибкой. Используйте командлет Write-Debug для явной записи в этот поток. Сообщения отладки выводятся только в том случае, если используется общий параметр -Debug. Дополнительные сведения см. в about_CommonParameters.

Debug сообщения предназначены для разработчиков скриптов и командлетов больше, чем конечных пользователей. Эти сообщения отладки могут содержать внутренние сведения, необходимые для глубокого устранения неполадок.

поток Information

Поток Information предназначен для предоставления сообщений, которые помогают пользователю понять, что делает скрипт. Его также можно использовать разработчиками в качестве дополнительного потока, используемого для передачи информации через PowerShell. Разработчик может пометить потоковые данные и иметь конкретную обработку для этого потока. Используйте командлет Write-Information для явной записи в этот поток.

Write-Host также записывается в поток Information. Разница между командлетами заключается в том, что Write-Host также записывается в консоль узла, если вы не перенаправляете поток Information. Write-Information записывает только в поток Information.

поток Progress

Поток Progress используется для сообщений, которые обмениваются данными о ходе выполнения более длительных команд и скриптов. Используйте командлет Write-Progress для явной записи сообщений в этот поток. Поток Progress не поддерживает перенаправление.

См. также

• about_CommonParameters
• about_Redirection
• Write-Debug
• Write-Error
• Write-Host
• Write-Information
• Write-Output
• Write-Progress
• Write-Verbose
• Write-Warning