О потоках вывода
Объясняет доступность и назначение выходных потоков в PowerShell.
PowerShell предоставляет несколько потоков вывода. Потоки предоставляют каналы для различных типов сообщений. Эти потоки можно записать с помощью связанного командлета или перенаправления. Дополнительные сведения см. в about_Redirection.
PowerShell поддерживает следующие выходные потоки.
| Поток # | Description | Представлено в | Командлет записи |
|---|---|---|---|
| 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 |
| Н/Д | Progress поток | PowerShell 2.0 | Write-Progress |
Примечание
Поток Progress не поддерживает перенаправление.
Поток Success — это поток по умолчанию для обычных успешных результатов.
Используйте командлет для явной Write-Output записи объектов в этот поток. Этот поток используется для передачи объектов через конвейер PowerShell. Поток Success подключен к потоку stdout для собственных приложений.
Поток Error — это поток по умолчанию для результатов ошибок. Используйте командлет для явной Write-Error записи в этот поток. Поток Error подключен к потоку stderr для собственных приложений. В большинстве случаев эти ошибки могут завершить конвейер выполнения. Ошибки, записанные в этот поток, также добавляются в автоматическую $Error переменную. Дополнительные сведения см. в about_Automatic_Variables.
Поток Warning предназначен для условий ошибки, которые менее серьезны, чем ошибки, записанные в поток Error. В обычных условиях эти предупреждения не завершаются выполнением. Предупреждения не записываются в автоматическую $Error переменную. Используйте командлет для явной Write-Warning записи в этот поток.
Поток Verbose предназначен для сообщений, которые помогают пользователям устранять неполадки при интерактивном выполнении или из скрипта. Используйте командлет для явной Write-Verbose записи сообщений в этот поток. Многие командлеты предоставляют подробные выходные данные, полезные для понимания внутренних действий командлета. Подробные сообщения выводятся только в том случае, если используется общий параметр -Verbose. Дополнительные сведения см. в разделе about_CommonParameters.
Поток Debug используется для сообщений, которые помогают скриптам понять, почему их код завершается сбоем. Используйте командлет для явной Write-Debug записи в этот поток. Сообщения отладки выводятся только в том случае, если используется общий параметр -Debug. Дополнительные сведения см. в разделе about_CommonParameters.
Debug сообщения предназначены для разработчиков скриптов и командлетов больше, чем конечных пользователей. Эти сообщения отладки могут содержать внутренние сведения, необходимые для глубокого устранения неполадок.
Поток Information предназначен для предоставления сообщений, которые помогают пользователю понять, что делает скрипт. Его также можно использовать разработчиками в качестве дополнительного потока, используемого для передачи информации через PowerShell. Разработчик может пометить потоковые данные и иметь конкретную обработку для этого потока. Используйте командлет для явной Write-Information записи в этот поток.
Write-Host также записывается в Information поток. Разница между командлетами заключается в том, что Write-Host также записывается в консоль узла, если вы не перенаправляете Information поток.
Write-Information записывается только в Information поток.
Поток Progress используется для сообщений, которые передают информацию о ходе выполнения длительных команд и скриптов. Используйте командлет для явной Write-Progress записи сообщений в этот поток. Поток Progress не поддерживает перенаправление.
Отзыв о PowerShell
PowerShell — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: