Compartilhar via

about_Output_Streams

Descrição curta

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.

Fluxo # Descrição Introduzido no Gravar Cmdlet
1 Fluxo Success PowerShell 2.0 Write-Output
2 Fluxo Error PowerShell 2.0 Write-Error
3 Fluxo Warning PowerShell 2.0 Write-Warning
4 Fluxo Verbose PowerShell 2.0 Write-Verbose
5 Fluxo Debug PowerShell 2.0 Write-Debug
6 Fluxo Information PowerShell 5.0 Write-Information
n/a Fluxo Progress PowerShell 2.0 Write-Progress

Nota

O fluxo de Progress não dá suporte ao redirecionamento.

Fluxo Success

O fluxo de Success é o fluxo padrão para resultados normais e bem-sucedidos. Use o cmdlet Write-Output para gravar explicitamente objetos nesse fluxo. Esse fluxo é usado para passar objetos por meio do pipeline do PowerShell. O fluxo Success está conectado ao fluxo stdout para aplicativos nativos.

Fluxo Error

O fluxo de Error é o fluxo padrão para resultados de erro. Use o cmdlet Write-Error para gravar neste fluxo de forma explícita. O fluxo Error está conectado ao fluxo stderr para aplicativos nativos. Na maioria das condições, esses erros podem encerrar o pipeline de execução. Erros gravados nesse fluxo também são adicionados à variável automática $Error. Para obter mais informações, confira about_Automatic_Variables.

Fluxo Warning

O fluxo de Warning destina-se a condições de erro menos graves do que os erros gravados no fluxo de Error. Em condições normais, esses avisos não encerram a execução. Avisos não são gravados na variável automática $Error. Use o cmdlet Write-Warning para gravar neste fluxo de forma explícita.

Fluxo Verbose

O fluxo Verbose 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 cmdlet Write-Verbose para gravar mensagens explicitamente nesse fluxo. Muitos cmdlets fornecem uma saída detalhada que é útil para compreender o funcionamento interno do cmdlet. As mensagens detalhadas são exibidas somente quando você usa o parâmetro comum -Verbose. Para obter mais informações, consulte about_CommonParameters.

Fluxo Debug

O fluxo de Debug é usado para mensagens que ajudam os scripts a entender por que o código está falhando. Use o cmdlet Write-Debug para gravar neste fluxo de forma explícita. As mensagens de depuração são exibidas somente quando você usa o parâmetro comum -Debug. Para obter mais informações, consulte about_CommonParameters.

As mensagens Debug são destinadas mais a desenvolvedores de scripts e cmdlets do que a usuários finais. Essas mensagens de depuração podem conter detalhes internos necessários para uma solução de problemas profunda.

Fluxo Information

O fluxo de Information destina-se a fornecer mensagens que ajudam um usuário a entender o que um script está fazendo. Ele também pode ser usado pelos 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 cmdlet Write-Information para gravar neste fluxo de forma explícita.

O Write-Host também escreve no fluxo Information. A diferença entre os cmdlets é que Write-Host também grava no console do host, a menos que você redirecione o fluxo Information. Write-Information escreve somente no fluxo Information.

Fluxo Progress

O fluxo de Progress é usado para mensagens que comunicam o progresso em scripts e comandos de execução mais longos. Use o cmdlet Write-Progress para gravar mensagens explicitamente nesse fluxo. O fluxo de Progress não dá suporte ao redirecionamento.

Consulte também

  • Last updated on