Write-Output
Invia gli oggetti specificati al comando successivo nella pipeline. Se il comando è l'ultimo comando della pipeline, gli oggetti vengono visualizzati nella console.
Sintassi
Default (Impostazione predefinita)
Write-Output
[-InputObject] <PSObject[]>
[-NoEnumerate]
[<CommonParameters>]
Descrizione
Il cmdlet Write-Output invia l'oggetto specificato lungo la pipeline al comando successivo. Se il comando è l'ultimo comando nella pipeline, l'oggetto viene visualizzato nella console.
Write-Output invia gli oggetti lungo la pipeline primaria, nota anche come "flusso di output" o "pipeline di successo". Per inviare oggetti di errore alla pipeline degli errori, usare Write-Error.
Questo cmdlet viene in genere usato negli script per visualizzare stringhe e altri oggetti nella console.
Tuttavia, poiché il comportamento predefinito consiste nel visualizzare gli oggetti alla fine di una pipeline, in genere non è necessario utilizzare il cmdlet.
Ad esempio, Get-Process | Write-Output è equivalente a Get-Process.
Esempio
Esempio 1: Ottenere oggetti e scriverli nella console
PS C:\> $P = Get-Process
PS C:\> Write-Output $P
PS C:\> $P
Il primo comando consente di eseguire i processi nel computer e di memorizzarli nella variabile $P.
Il secondo e il terzo comando visualizzano gli oggetti di processo in $P sulla console.
Esempio 2: Passare l'output a un altro cmdlet
PS C:\> Write-Output "test output" | Get-Member
Questo comando invia 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.
Esempio 3: Eliminare l'enumerazione nell'output
PS C:\> Write-Output @(1,2,3) | measure
Count : 3
...
PS C:\> Write-Output @(1,2,3) -NoEnumerate | measure
Count : 1
Questo comando aggiunge il parametro NoEnumerate per considerare una raccolta o una matrice come un singolo oggetto tramite la pipeline.
Parametri
-InputObject
Specifica gli oggetti da inviare lungo la pipeline. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti .
Proprietà dei parametri
| Tipo: | PSObject[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-NoEnumerate
Per impostazione predefinita, il cmdlet Write-Output enumera sempre l'output. Il parametro NoEnumerate elimina il comportamento predefinito e impedisce a Write-Output di enumerare l'output. Il parametro NoEnumerate non ha alcun effetto sugli insiemi creati eseguendo il wrapping dei comandi tra parentesi, in quanto le parentesi forzano l'enumerazione.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
PSObject
È possibile reindirizzare gli oggetti a Write-Output.
Output
PSObject
Write-Output restituisce gli oggetti inviati come input.