about_Output_Streams
Descrição breve
Explica a disponibilidade e a finalidade dos fluxos de saída no PowerShell.
Descrição longa
O PowerShell fornece vários fluxos de saída. Os fluxos fornecem canais para diferentes tipos de mensagens. Você pode gravar nesses fluxos usando o cmdlet ou o redirecionamento associado. Para obter mais informações, consulte about_Redirection.
O PowerShell dá suporte aos fluxos de saída a seguir.
Stream # | Descrição | Introduzido no | Cmdlet de gravação |
---|---|---|---|
1 | Success Fluxo | PowerShell 2.0 | Write-Output |
2 | Error Fluxo | PowerShell 2.0 | Write-Error |
3 | Warning Fluxo | PowerShell 2.0 | Write-Warning |
4 | Verbose Fluxo | PowerShell 2.0 | Write-Verbose |
5 | Debug Fluxo | PowerShell 2.0 | Write-Debug |
6 | Information Fluxo | PowerShell 5.0 | Write-Information |
n/d | Progress Fluxo | PowerShell 2.0 | Write-Progress |
Observação
O Progress fluxo não dá suporte ao redirecionamento.
Success Fluxo
O Success fluxo é o fluxo padrão para resultados normais e bem-sucedidos.
Use o Write-Output
cmdlet para gravar explicitamente objetos nesse fluxo. Esse fluxo é usado para passar objetos por meio do pipeline do PowerShell. O Success fluxo está conectado ao fluxo stdout para aplicativos nativos.
Error Fluxo
O Error fluxo é o fluxo padrão para resultados de erro. Use o Write-Error
cmdlet para gravar explicitamente nesse fluxo. O Error fluxo está conectado ao fluxo stderr para aplicativos nativos. Na maioria das condições, esses erros podem encerrar o pipeline de execução. Errors gravados nesse fluxo também são adicionados à $Error
variável automática. Para obter mais informações, confira about_Automatic_Variables.
Warning Fluxo
O Warning fluxo destina-se a condições de erro menos graves do que os erros gravados no Error fluxo. Em condições normais, esses avisos não encerram a execução. Warnings não são gravados na $Error
variável automática. Use o Write-Warning
cmdlet para gravar explicitamente nesse fluxo.
Verbose Fluxo
O Verbose fluxo destina-se a mensagens que ajudam os usuários a solucionar problemas de comandos à medida que são executados interativamente ou de um script. Use o Write-Verbose
cmdlet para gravar mensagens explicitamente nesse fluxo. Muitos cmdlets fornecem uma saída detalhada que é útil para entender o funcionamento interno do cmdlet. As mensagens detalhadas são saída somente quando você usa o -Verbose
parâmetro comum. Para obter mais informações, confira about_CommonParameters.
Debug Fluxo
O Debug fluxo é usado para mensagens que ajudam os scripts a entender por que o código está falhando. Use o Write-Debug
cmdlet para gravar explicitamente nesse fluxo. As mensagens de depuração são saída somente quando você usa o -Debug
parâmetro comum. Para obter mais informações, confira about_CommonParameters.
Debug as mensagens destinam-se mais aos desenvolvedores de script e cmdlet do que aos usuários finais. Essas mensagens de depuração podem conter detalhes internos necessários para uma solução de problemas profunda.
Information Fluxo
O Information fluxo destina-se a fornecer mensagens que ajudam um usuário a entender o que um script está fazendo. Ele também pode ser usado por desenvolvedores como um fluxo adicional usado para passar informações por meio do PowerShell. O desenvolvedor pode marcar dados de fluxo e ter tratamento específico para esse fluxo. Use o Write-Information
cmdlet para gravar explicitamente nesse fluxo.
Write-Host
também grava no Information fluxo. A diferença entre os cmdlets é que também grava no console do host, a menos que Write-Host
você redirecione o Information fluxo. Write-Information
grava apenas no Information fluxo.
Progress Fluxo
O Progress fluxo é usado para mensagens que comunicam o progresso em comandos e scripts de execução mais longa. Use o Write-Progress
cmdlet para gravar mensagens explicitamente nesse fluxo. O Progress fluxo não dá suporte ao redirecionamento.