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-Output
Get-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
Du kan skicka objekt till Write-Output.
Utdata
Write-Output returnerar de objekt som skickas som indata.