Write-Output

Skickar de angivna objekten till nästa kommando i pipelinen. Om kommandot är det sista kommandot i pipelinen visas objekten i konsolen.

Syntax

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

Description

Cmdleten Write-Output skickar det angivna objektet nedåt i pipelinen till nästa kommando. Om kommandot är det sista kommandot i pipelinen visas objektet i konsolen.

Write-Output skickar objekt nedåt i den primära pipelinen, även kallat "utdataströmmen" eller "lyckad pipeline". Om du vill skicka felobjekt i felpipelinen använder du Write-Error.

Den här cmdleten används vanligtvis i skript för att visa strängar och andra objekt i konsolen. Men eftersom standardbeteendet är att visa objekten i slutet av en pipeline är det vanligtvis inte nödvändigt att använda cmdleten. Till exempel motsvarar Get-Process | Write-OutputGet-Process.

Exempel

Exempel 1: Hämta objekt och skriv dem till konsolen

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

Det första kommandot hämtar processer som körs på datorn och lagrar dem i variabeln $P.

De andra och tredje kommandona visar processobjekten i $P i konsolen.

Exempel 2: Skicka utdata till en annan cmdlet

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

Det här kommandot dirigerar strängen "testutdata" till cmdleten Get-Member, som visar medlemmarna i klassen System.String, vilket visar att strängen skickades längs pipelinen.

Exempel 3: Utelämna uppräkning i utdata

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

Count    : 3
...

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

Count    : 1

Det här kommandot lägger till parametern NoEnumerate för att behandla en samling eller matris som ett enda objekt via pipelinen.

Parametrar

-InputObject

Anger vilka objekt som ska skickas nedåt i pipelinen. Ange en variabel som innehåller objekten eller skriv ett kommando eller uttryck som hämtar objekten.

Typ:PSObject[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NoEnumerate

Som standard räknar cmdleten Write-Output alltid upp dess utdata. Parametern NoEnumerate undertrycker standardbeteendet och förhindrar write-output- från att räkna upp utdata. Parametern NoEnumerate har ingen effekt på samlingar som skapades genom att omsluta kommandon inom parenteser, eftersom parenteserna framtvingar uppräkning.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSObject

Du kan skicka objekt till Write-Output.

Utdata

PSObject

Write-Output returnerar de objekt som skickas som indata.