Dela via

Write-Output

Modul:
Microsoft.PowerShell.Utility Module

Skriver de angivna objekten till pipelinen.

Syntax

Default (Standard) 

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

Description

Skriver de angivna objekten till pipelinen. Om Write-Output är det sista kommandot i pipelinen visas objekten i konsolen.

Write-Output skickar objekt till den primära pipelinen, även kallad framgångsström. Om du vill skicka felobjekt till felströmmen 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. Ett av de inbyggda aliasen för Write-Output är echo och liknar andra skal som använder echo. Standardbeteendet är att visa utdata i slutet av en pipeline. I PowerShell är det vanligtvis inte nödvändigt att använda cmdleten i instanser där utdata visas som standard. Get-Process | Write-Output motsvarar till exempel Get-Process. Eller så kan echo "Home directory: $HOME" skrivas "Home directory: $HOME".

Som standard räknar Write-Output upp objekt i en samling. Men Write-Output kan också skicka samlingar ned pipelinen som ett enda objekt med parametern NoEnumerate.

Exempel

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

I det här exemplet lagras resultatet av cmdleten Get-Process i variabeln $P. Cmdleten Write-Output visar processobjekten i $P till konsolen.

$P = Get-Process
Write-Output $P

Exempel 2: Skicka utdata till en annan cmdlet

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.

Write-Output "test output" | Get-Member

Exempel 3: Utelämna uppräkning i utdata

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

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

Count    : 3
...

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

Count    : 1
...

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.

Parameteregenskaper

Typ:

PSObject[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-NoEnumerate

Som standard räknar Write-Output-cmdleten alltid upp sina utdata. Parametern NoEnumerate undertrycker standardbeteendet och förhindrar Write-Output från att räkna upp utdata. Parametern NoEnumerate har ingen effekt om kommandot är omslutet i parenteser, eftersom parenteserna framtvingar uppräkning. Till exempel räknar (Write-Output 1,2,3 -NoEnumerate) fortfarande upp matrisen.

Parametern NoEnumerate är bara användbar i en pipeline. Det är problematiskt att försöka se effekterna av NoEnumerate- i konsolen eftersom PowerShell lägger till Out-Default i slutet av varje kommandorad, vilket resulterar i uppräkning. Men om du dirigerar Write-Output -NoEnumerate till en annan cmdlet tar den underordnade cmdleten emot samlingsobjektet, inte samlingsobjektens uppräknade objekt.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PSObject

Du kan skicka objekt till den här cmdleten.

Utdata

PSObject

Den här cmdleten returnerar de objekt som skickas som indata.

Kommentarer

PowerShell innehåller följande alias för Write-Output:

  • Alla plattformar:

    • echo

  • Windows:

    • write