Delen via

Write-Output

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee schrijft u de opgegeven objecten naar de pijplijn.

Syntaxis

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

Description

Hiermee schrijft u de opgegeven objecten naar de pijplijn. Als Write-Output de laatste opdracht in de pijplijn is, worden de objecten weergegeven in de console.

Write-Output stuurt objecten naar de primaire pijplijn, ook wel bekend als de successtroom. Gebruik Write-Errorom foutobjecten naar de foutstroom te verzenden.

Deze cmdlet wordt meestal gebruikt in scripts om tekenreeksen en andere objecten op de console weer te geven. Een van de ingebouwde aliassen voor Write-Output is echo en vergelijkbaar met andere shells die gebruikmaken van echo. Het standaardgedrag is om de uitvoer aan het einde van een pijplijn weer te geven. In PowerShell is het over het algemeen niet nodig om de cmdlet te gebruiken in gevallen waarin de uitvoer standaard wordt weergegeven. Get-Process | Write-Output is bijvoorbeeld gelijk aan Get-Process. Of echo "Home directory: $HOME" kan geschreven worden als "Home directory: $HOME".

Standaard somt Write-Output objecten in een verzameling op. Write-Output kan echter ook verzamelingen doorgeven aan de pijplijn als één object met de parameter NoEnumerate.

Voorbeelden

Voorbeeld 1: Objecten ophalen en naar de console schrijven

In dit voorbeeld worden de resultaten van de cmdlet Get-Process opgeslagen in de variabele $P. Met de cmdlet Write-Output worden de procesobjecten in $P naar de console weergegeven.

$P = Get-Process
Write-Output $P

Voorbeeld 2: Uitvoer doorgeven aan een andere cmdlet

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

Write-Output "test output" | Get-Member

Voorbeeld 3: Opsomming in de uitvoer onderdrukken

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

Write-Output 1,2,3 | Measure-Object

Count    : 3
...

Write-Output 1,2,3 -NoEnumerate | Measure-Object

Count    : 1
...

Parameters

-InputObject

Specificeert de objecten die naar 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 Write-Output cmdlet inventariseert standaard altijd de uitvoer. De parameter NoEnumerate onderdrukt het standaardgedrag en voorkomt dat Write-Output uitvoer opsommen. De parameter NoEnumerate heeft geen effect als de opdracht tussen haakjes is verpakt, omdat de haakjes opsomming afdwingen. Bijvoorbeeld, (Write-Output 1,2,3 -NoEnumerate) somt nog steeds de array op.

De parameter NoEnumerate is alleen nuttig in een pijplijn. Het is problematisch om de effecten van NoEnumerate- in de console te zien, omdat PowerShell Out-Default toevoegt aan het einde van elke opdrachtregel, wat resulteert in opsomming. Maar als u Write-Output -NoEnumerate naar een andere cmdlet sluist, ontvangt de downstream-cmdlet het verzamelingsobject, niet de geïnventariseerd items van de verzameling.

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

Invoerwaarden

PSObject

U kunt objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

PSObject

Met deze cmdlet worden de objecten geretourneerd die als invoer worden verzonden.

Notities

PowerShell bevat de volgende aliassen voor Write-Output:

  • Alle platforms:

    • echo

  • Windows:

    • write