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