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.
| 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 flusso Error è 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. Anche gli errori scritti in questo flusso vengono aggiunti alla $Error variabile automatica. Per ulteriori informazioni, vedere about_Automatic_Variables.
Warning corrente
Il flusso Warning è destinato a condizioni di errore meno gravi rispetto agli errori scritti nel flusso Error. 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 un output dettagliato utile per comprendere le operazioni interne di un cmdlet. I messaggi verbosi vengono emessi solo quando si utilizza il parametro comune -Verbose. Per altre informazioni, 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 messaggi di debug vengono restituiti solo quando si usa il parametro comune -Debug. Per altre informazioni, vedere 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 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 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 corrente
Il flusso Progress viene usato per i messaggi che comunicano lo stato di avanzamento in comandi e script più lunghi. Usare il Write-Progress cmdlet per scrivere in modo esplicito messaggi in questo flusso. Il Progress flusso non supporta il reindirizzamento.
