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 redirecionamento associado. Para mais informationinformações, consulte about_Redirection.
O PowerShell dá suporte aos fluxos de saída a seguir.
| Riacho # | Descrição | Introduzido no | Cmdlet de gravação |
|---|---|---|---|
| 1 | Success riacho | PowerShell 2.0 | Write-Output |
| 2 | Error riacho | PowerShell 2.0 | Write-Error |
| 3 | Warning riacho | PowerShell 2.0 | Write-Warning |
| 4 | Verbose riacho | PowerShell 2.0 | Write-Verbose |
| 5 | Debug riacho | PowerShell 2.0 | Write-Debug |
| 6 | Information riacho | PowerShell 5.0 | Write-Information |
| N/D | Progress riacho | PowerShell 2.0 | Write-Progress |
Observação
O Progress fluxo não dá suporte ao redirecionamento.
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 Error fluxo é o fluxo padrão para error resultados. 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 informationinformações, consulte about_Automatic_Variables.
Warning riacho
O Warning fluxo destina-se a error condições menos graves do que erros gravados no Error fluxo. 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 verbose uma saída útil para entender o funcionamento interno do cmdlet. As verbose mensagens são geradas somente quando você usa o -Verbose parâmetro comum. Para saber mais information, 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 debug mensagens são geradas somente quando você usa o -Debug parâmetro comum. Para saber mais information, consulte about_CommonParameters.
Debug As mensagens destinam-se mais a desenvolvedores de scripts e cmdlets do que a usuários finais. Essas debug mensagens 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 por desenvolvedores como um fluxo adicional usado para passar information pelo 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 Progress fluxo é usado para mensagens que se comunicam progress 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.
