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 informationinformazioni, vedere about_Redirection.
PowerShell supporta i flussi di output seguenti.
| Corrente # | Descrizione | Introduzione in | Write Cmdlet |
|---|---|---|---|
| 1 | Success corrente | PowerShell 2.0 | Write-Output |
| 2 | Error corrente | PowerShell 2.0 | Write-Error |
| 3 | Warning corrente | PowerShell 2.0 | Write-Warning |
| 4 | Verbose corrente | PowerShell 2.0 | Write-Verbose |
| 5 | Debug corrente | PowerShell 2.0 | Write-Debug |
| 6 | Information corrente | PowerShell 5.0 | Write-Information |
| n/d | Progress corrente | PowerShell 2.0 | Write-Progress |
Nota
Il Progress flusso non supporta il reindirizzamento.
Success corrente
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 corrente
Il Error flusso è il flusso predefinito per error i risultati. 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. Anche gli errori scritti in questo flusso vengono aggiunti alla $Error variabile automatica. Per altre informationinformazioni, vedere about_Automatic_Variables.
Warning corrente
Il Warning flusso è destinato a error condizioni meno gravi rispetto agli errori scritti nel Error flusso. In condizioni normali, questi avvisi non terminano l'esecuzione. Gli avvisi non vengono scritti nella $Error variabile automatica. Usare il Write-Warning cmdlet per scrivere in modo esplicito in questo flusso.
Verbose corrente
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 verbose l'output utile per comprendere le operazioni interne del cmdlet. I verbose messaggi vengono restituiti solo quando si usa il -Verbose parametro comune. Per altre informationinformazioni, vedere about_CommonParameters.
Debug corrente
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 debug messaggi vengono restituiti solo quando si usa il -Debug parametro comune. Per altre informationinformazioni, vedere about_CommonParameters.
Debug i messaggi sono destinati agli sviluppatori di script e cmdlet più che agli utenti finali. Questi debug messaggi possono contenere dettagli interni necessari per la risoluzione dei problemi più approfondita.
Information corrente
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 information 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 corrente
Il Progress flusso viene usato per i messaggi che comunicano progress in comandi e script con esecuzione più lunga. Usare il Write-Progress cmdlet per scrivere in modo esplicito messaggi in questo flusso. Il Progress flusso non supporta il reindirizzamento.
