Delen via

Write-Output

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee worden de opgegeven objecten verzonden naar de volgende opdracht in de pijplijn. Als de opdracht de laatste opdracht in de pijplijn is, worden de objecten weergegeven in de console.

Syntaxis

Write-Output
     [-InputObject] <PSObject[]>
     [-NoEnumerate]
     [<CommonParameters>]

Description

De write-output cmdlet verzendt het opgegeven object omlaag in de pijplijn naar de volgende opdracht. Als de opdracht de laatste opdracht in de pijplijn is, wordt het object weergegeven in de console.

write-output objecten naar beneden verzendt naar de primaire pijplijn, ook wel de 'uitvoerstroom' of de 'succespijplijn' genoemd. Als u foutobjecten in de foutpijplijn wilt verzenden, gebruikt u Write-Error.

Deze cmdlet wordt meestal gebruikt in scripts om tekenreeksen en andere objecten op de console weer te geven. Omdat het standaardgedrag echter is om de objecten aan het einde van een pijplijn weer te geven, is het over het algemeen niet nodig om de cmdlet te gebruiken. Get-Process | Write-Output is bijvoorbeeld gelijk aan Get-Process.

Voorbeelden

Voorbeeld 1: Objecten ophalen en naar de console schrijven

PS C:\> $P = Get-Process
PS C:\> Write-Output $P
PS C:\> $P

Met de eerste opdracht worden processen uitgevoerd op de computer en worden deze opgeslagen in de $P variabele.

In de tweede en derde opdracht worden de procesobjecten in $P op de console weergegeven.

Voorbeeld 2: Uitvoer doorgeven aan een andere cmdlet

PS C:\> Write-Output "test output" | Get-Member

Met deze opdracht wordt de tekenreeks 'testuitvoer' doorgegeven aan de Get-Member-cmdlet, waarin de leden van de klasse System.String worden weergegeven, waarmee wordt aangegeven dat de tekenreeks is doorgegeven aan de pijplijn.

Voorbeeld 3: Opsomming onderdrukken in uitvoer

PS C:\> Write-Output @(1,2,3) | measure

Count    : 3
...

PS C:\> Write-Output @(1,2,3) -NoEnumerate | measure

Count    : 1

Met deze opdracht wordt de parameter NoEnumerate toegevoegd om een verzameling of matrix als één object via de pijplijn te behandelen.

Parameters

-InputObject

Hiermee geeft u de objecten op die de pijplijn moeten worden verzonden. Voer een variabele in die de objecten bevat of typ een opdracht of expressie waarmee de objecten worden opgehaald.

Type:PSObject[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NoEnumerate

De cmdlet Write-Output bevat standaard altijd de uitvoer. De parameter NoEnumerate onderdrukt het standaardgedrag en voorkomt dat write-output- uitvoer opsommen. De parameter NoEnumerate heeft geen effect op verzamelingen die zijn gemaakt door opdrachten tussen haakjes te verpakken, omdat de haakjes opsomming afdwingen.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSObject

U kunt objecten doorsluisen naar write-output.

Uitvoerwaarden

PSObject

write-output retourneert de objecten die als invoer worden verzonden.