Condividi tramite


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.

Vedi anche