Write-Output
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.
Syntax
Default (Standaard)
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 in de uitvoer onderdrukken
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
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.
Parametereigenschappen
| Type: | PSObject[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
PSObject
U kunt objecten doorsluisen naar write-output.
Uitvoerwaarden
PSObject
write-output retourneert de objecten die als invoer worden verzonden.