Write-Output
Scrive gli oggetti specificati nella pipeline.
Sintassi
Write-Output
[-InputObject] <PSObject[]>
[-NoEnumerate]
[<CommonParameters>]
Descrizione
Scrive gli oggetti specificati nella pipeline. Se Write-Output
è l'ultimo comando nella pipeline, gli oggetti vengono visualizzati nella console.
Write-Output
invia oggetti alla pipeline primaria, noto anche come flusso di esito positivo. Per inviare oggetti errore al flusso di errori, usare Write-Error
.
Questo cmdlet viene in genere usato negli script per visualizzare stringhe e altri oggetti nella console. Uno degli alias predefiniti per Write-Output
è echo
ed è simile ad altre shell che usano echo
. Il comportamento predefinito consiste nel visualizzare l'output alla fine di una pipeline. In PowerShell in genere non è necessario usare il cmdlet nelle istanze in cui l'output viene visualizzato per impostazione predefinita. Ad esempio, Get-Process | Write-Output
equivale a Get-Process
. In alternativa, è possibile scrivere echo "Home directory: $HOME"
, "Home directory: $HOME"
.
Per impostazione predefinita, Write-Output
enumera gli oggetti in una raccolta. Tuttavia, anche Write-Output
può passare le raccolte alla pipeline come un singolo oggetto utilizzando il parametro NoEnumerate.
Esempio
Esempio 1: Ottenere oggetti e scriverli nella console
In questo esempio i risultati del cmdlet Get-Process
vengono archiviati nella variabile $P
. Il cmdlet Write-Output
visualizza gli oggetti del processo in $P
sulla console.
$P = Get-Process
Write-Output $P
Esempio 2: Passare l'output a un altro cmdlet
Questo comando invia tramite pipe la stringa "test output" al cmdlet Get-Member
, che visualizza i membri della classe System.String, dimostrando che la stringa è stata passata lungo la pipeline.
Write-Output "test output" | Get-Member
Esempio 3: Eliminare l'enumerazione nell'output
Questo comando aggiunge il parametro NoEnumerate per considerare una raccolta o una matrice come un singolo oggetto tramite la pipeline.
Write-Output 1,2,3 | Measure-Object
Count : 3
...
Write-Output 1,2,3 -NoEnumerate | Measure-Object
Count : 1
...
Parametri
-InputObject
Specifica gli oggetti da inviare alla pipeline. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti .
Tipo: | PSObject[] |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-NoEnumerate
Per impostazione predefinita, il cmdlet Write-Output
enumera sempre il relativo output. Il parametro NoEnumerate elimina il comportamento predefinito e impedisce Write-Output
di enumerare l'output. Il parametro NoEnumerate non ha alcun effetto se il comando è racchiuso tra parentesi, perché le parentesi forzano l'enumerazione. Ad esempio, (Write-Output 1,2,3 -NoEnumerate)
enumera ancora la matrice.
Il parametro NoEnumerate è utile solo all'interno di una pipeline. Il tentativo di visualizzare gli effetti di NoEnumerate nella console è problematico perché PowerShell aggiunge Out-Default
alla fine di ogni riga di comando, che comporta l'enumerazione. Tuttavia, se si invia tramite pipe Write-Output -NoEnumerate
a un altro cmdlet, il cmdlet downstream riceve l'oggetto raccolta, non gli elementi enumerati dell'insieme.
Importante
Si è verificato un problema con questa opzione in Windows PowerShell che è stato risolto in PowerShell 6.2 e versioni successive. Quando si usa
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
Input
È possibile inviare tramite pipe oggetti a questo cmdlet.
Output
Questo cmdlet restituisce gli oggetti inviati come input.
Note
Windows PowerShell include gli alias seguenti per Write-Output
:
echo
write