Partilhar via

about_Output_Streams

Breve descrição

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 seguintes fluxos de saída.

Transmissão # Descrição Introduzido em Cmdlet de escrita
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/a Progress fluxo PowerShell 2.0 Write-Progress

Observação

O fluxo de Progress não suporta redirecionamento.

Success fluxo

O fluxo 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 pelo pipeline do PowerShell. O fluxo Success está conectado ao fluxo de stdout para aplicativos nativos.

Error fluxo

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

Warning fluxo

O fluxo de Warning destina-se a condições de erro que são 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 variável automática $Error. Use o cmdlet Write-Warning para gravar explicitamente nesse fluxo.

Verbose fluxo

O fluxo de Verbose destina-se a mensagens que ajudam os usuários a solucionar problemas de comandos à medida que são executados interativamente ou a partir de um script. Use o cmdlet Write-Verbose 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ídas somente quando você usa o parâmetro -Verbose comum. Para obter mais informações, consulte about_CommonParameters.

Debug fluxo

O fluxo de Debug é usado para mensagens que ajudam os scripters a entender por que seu código está falhando. Use o cmdlet Write-Debug para gravar explicitamente nesse fluxo. As mensagens de depuração são saídas somente quando você usa o parâmetro -Debug common. Para obter mais informações, consulte about_CommonParameters.

Debug 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 a solução profunda de problemas.

Information fluxo

O fluxo de Information destina-se a fornecer mensagens que ajudem 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 pelo PowerShell. O desenvolvedor pode marcar dados de fluxo e ter tratamento específico para esse fluxo. Use o cmdlet Write-Information para gravar explicitamente nesse fluxo.

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

Progress fluxo

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

Consulte também

  • Last updated on