Invia gli oggetti specificati al comando successivo nella pipeline. Se il comando è lultimo comando nella pipeline, gli oggetti vengono visualizzati nella console.
Sintassi
Descrizione
Il cmdlet Write-Output invia loggetto specificato lungo la pipeline al comando successivo. Se il comando è lultimo comando nella pipeline, loggetto viene visualizzato nella console.
Write-Output invia gli oggetti lungo la pipeline principale, nota anche come “flusso di output” o “pipeline di successo”. Per inviare oggetti di errore lungo la pipeline di errore, utilizzare Write-Error.
Questo cmdlet viene in genere utilizzato negli script per visualizzare stringhe e altri oggetti sulla console. Uno degli alias integrati per Write-Output è echo e simile ad altre shell che utilizzano echo, il comportamento predefinito è visualizzare loutput alla fine di una pipeline. In PowerShell, in genere non è necessario utilizzare il cmdlet nelle istanze in cui loutput viene visualizzato per impostazione predefinita. Ad esempio, Get-Process | Write-Output è equivalente a Get-Process. Oppure, echo "Home directory: $HOME" può essere scritto, "Home directory: $HOME".
Per impostazione predefinita, Write-Output enumera le raccolte fornite al cmdlet. Tuttavia, Write-Output può anche essere utilizzato per passare le raccolte lungo la pipeline come un singolo oggetto con il parametroNoEnumerate.
Esempi
Esempio 1: Ottieni oggetti e scrivili nella console
Il primo comando esegue i processi sul computer e li memorizza nella $P variabile.
Il secondo e il terzo comando visualizzano gli oggetti del processo in $P sulla console.
Esempio 2: passare loutput a un altro cmdlet
Questo comando invia la stringa “test output” al cmdlet Get-Member, che visualizza il membri della classe System.String, a dimostrazione che la stringa è stata passata lungo la pipeline.
Esempio 3: soppressione dellenumerazione nelloutput
Questo comando aggiunge il parametro NoEnumerate per trattare una raccolta o un array come un singolo oggetto attraverso la pipeline.
Parametri
Specifica gli oggetti da inviare lungo la pipeline. Immettere una variabile che contiene gli oggetti oppure digitare un comando o unespressione che ottenga gli oggetti.
| Tipo: | PSObject |
| Posizione: | 0 |
| Valore predefinito: | Nessuno |
| Accetta input pipeline: | True |
| Accetta caratteri jolly: | Falso |
Per impostazione predefinita, Write-Output cmdlet enumera sempre il suo output. Il parametro NoEnumerate sopprime il comportamento predefinito e impedisce a Write-Output di enumerare loutput. Il parametroNoEnumerate non ha effetto se il comando è racchiuso tra parentesi, perché le parentesi forzano lenumerazione. Ad esempio, (Write-Output 1,2,3) enumera ancora larray.
Nota
Questa opzione funziona correttamente solo con PowerShell Core 6.2 e versioni successive. Nelle versioni precedenti di PowerShell Core, la raccolta è ancora enumerata anche con luso di questa opzione.
| Tipo: | SwitchParameter |
| Posizione: | Con nome |
| Valore predefinito: | Nessuno |
| Accetta input pipeline: | False |
| Accetta caratteri jolly: | Falso |
Input
PSObject
Puoi reindirizza gli oggetti a Write-Output.
Output
PSObject
Write-Output restituisce gli oggetti inviati come input.
- about_Output_Streams
- about_Redirection
- Tee-Object
- Write-Debug
- Write-Error
- Write-Host
- Write-Information
- Write-Progress
- Write-Verbose
- Avviso di scrittura