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 redirecionamento associado. Para obter mais informações, consulte about_Redirection.

O PowerShell dá suporte aos fluxos de saída a seguir.

Success riacho

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

Error riacho

O fluxo de Error é 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. Os erros gravados nesse fluxo também são adicionados à $Error variável automática. Para obter mais informações, confira about_Automatic_Variables.

Warning riacho

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. Os avisos não são gravados na $Error variável automática. Use o Write-Warning cmdlet para gravar explicitamente nesse fluxo.

Verbose riacho

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 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.

Debug riacho

O Debug fluxo é usado para mensagens que ajudam os criadores de scripts a entender por que seu código está falhando. Use o Write-Debug cmdlet para gravar explicitamente nesse fluxo. 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.

Debug As mensagens destinam-se 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.

Information riacho

O Information fluxo destina-se a fornecer mensagens que ajudam o 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 Write-Information cmdlet para gravar explicitamente nesse fluxo.

Write-Host também grava no Information fluxo. A diferença entre os cmdlets é que o 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 riacho

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

Consulte também

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