about_Output_Streams
Breve descrizione
Illustra la disponibilità e lo scopo dei flussi di output in PowerShell.
Descrizione lunga
PowerShell fornisce più flussi di output. I flussi forniscono canali per diversi tipi di messaggi. È possibile scrivere in questi flussi usando il cmdlet associato o il reindirizzamento. Per altre informazioni, vedere about_Redirection.
PowerShell supporta i flussi di output seguenti.
Stream # | Descrizione | Introdotto in | Cmdlet di scrittura |
---|---|---|---|
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 gli 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 dei comandi durante l'esecuzione interattiva o da uno script. Usare il Write-Verbose
cmdlet per scrivere in modo esplicito i messaggi in questo flusso. Molti cmdlet forniscono un output dettagliato utile per comprendere i processi interni 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 consentono agli script di comprendere perché 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 dettagli interni necessari per la risoluzione dei problemi approfonditi.
Information Flusso
Il Information flusso è destinato a fornire messaggi che consentono a un utente di comprendere cosa sta facendo uno script. Può essere usato anche dagli sviluppatori come flusso aggiuntivo usato per passare informazioni tramite PowerShell. Lo sviluppatore può contrassegnare i dati di 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 i messaggi in questo flusso. Il Progress flusso non supporta il reindirizzamento.