about_Output_Streams
Descrizione breve
Illustra la disponibilità e lo scopo dei flussi di output in PowerShell.
Descrizione lunga
PowerShell offre più flussi di output. I flussi forniscono canali per diversi tipi di messaggi. È possibile scrivere in questi flussi usando il cmdlet o il reindirizzamento associati. Per altre informazioni, vedere about_Redirection.
PowerShell supporta i flussi di output seguenti.
| Flusso # | Descrizione | Introdotto in | Write Cmdlet |
|---|---|---|---|
| 1 | Success Flusso | PowerShell 2.0 | Write-Output |
| 2 | Error Flusso | PowerShell 2.0 | Write-Error |
| 3 | Warning Flusso | PowerShell 2.0 | Write-Warning |
| 4 | Verbose Flusso | PowerShell 2.0 | Write-Verbose |
| 5 | Debug Flusso | PowerShell 2.0 | Write-Debug |
| 6 | Information Flusso | PowerShell 5.0 | Write-Information |
| n/d | Progress Flusso | PowerShell 2.0 | Write-Progress |
Nota
Il Progress flusso non supporta il reindirizzamento.
Success Flusso
Il Success flusso è il flusso predefinito per i risultati normali e riusciti.
Usare il Write-Output cmdlet per scrivere in modo esplicito oggetti in questo flusso. Questo flusso viene usato per passare oggetti tramite la pipeline di PowerShell. Il Success flusso è connesso al flusso stdout per le applicazioni native.
Error Flusso
Il Error flusso è il flusso predefinito per i risultati degli errori. Usare il Write-Error cmdlet per scrivere in modo esplicito in questo flusso. Il Error flusso è connesso al flusso stderr per le applicazioni native. Nella maggior parte delle condizioni, questi errori possono terminare la pipeline di esecuzione. Errors scritti in questo flusso vengono aggiunti anche alla $Error variabile automatica. Per altre informazioni, vedere about_Automatic_Variables.
Warning Flusso
Il Warning flusso è destinato a condizioni di errore meno gravi rispetto agli errori scritti nel Error flusso. In condizioni normali, questi avvisi non terminano l'esecuzione. Warnings non vengono scritti nella $Error variabile automatica. Usare il Write-Warning cmdlet per scrivere in modo esplicito in questo flusso.
Verbose Flusso
Il Verbose flusso è destinato ai messaggi che consentono agli utenti di risolvere i problemi relativi ai comandi mentre vengono eseguiti in modo interattivo o da uno script. Usare il Write-Verbose cmdlet per scrivere in modo esplicito messaggi in questo flusso. Molti cmdlet forniscono un output dettagliato utile per comprendere le operazioni interne del cmdlet. I messaggi dettagliati vengono restituiti solo quando si usa il -Verbose parametro comune. Per altre informazioni, vedi about_CommonParameters.
Debug Flusso
Il Debug flusso viene usato per i messaggi che aiutano gli script a comprendere il motivo per cui il codice ha esito negativo. Usare il Write-Debug cmdlet per scrivere in modo esplicito in questo flusso. I messaggi di debug vengono restituiti solo quando si usa il -Debug parametro comune. Per altre informazioni, vedi about_CommonParameters.
Debug i messaggi sono destinati agli sviluppatori di script e cmdlet più che agli utenti finali. Questi messaggi di debug possono contenere i dettagli interni necessari per la risoluzione dei problemi più approfondita.
Information Flusso
Il Information flusso è progettato per fornire messaggi che consentono a un utente di comprendere le operazioni di uno script. Può essere usato anche dagli sviluppatori come flusso aggiuntivo usato per passare informazioni tramite PowerShell. Lo sviluppatore può contrassegnare i dati del flusso e avere una gestione specifica per tale flusso. Usare il Write-Information cmdlet per scrivere in modo esplicito in questo flusso.
Write-Host scrive anche nel Information flusso. La differenza tra i cmdlet è che scrive anche nella console host a meno che Write-Host non si reindirizzi il Information flusso. Write-Information scrive solo nel Information flusso.
Progress Flusso
Il Progress flusso viene usato per i messaggi che comunicano lo stato di avanzamento in comandi e script più lunghi in esecuzione. Usare il Write-Progress cmdlet per scrivere in modo esplicito messaggi in questo flusso. Il Progress flusso non supporta il reindirizzamento.
