Sdílet prostřednictvím

Write-Output

  • Reference
Modul:
Microsoft.PowerShell.Utility

Zapíše zadané objekty do kanálu.

Syntaxe

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

Description

Zapíše zadané objekty do kanálu. Pokud Write-Output je posledním příkazem v kanálu, zobrazí se v konzole objekty.

Write-Output odesílá objekty do primárního kanálu, označovaného také jako stream úspěchu. Chcete-li odeslat chybové objekty do datového proudu chyby, použijte Write-Error.

Tato rutina se obvykle používá ve skriptech k zobrazení řetězců a dalších objektů v konzole. Jeden z předdefinovaných aliasů pro Write-Output je echo a podobný jiným prostředím, které používají echo. Výchozím chováním je zobrazení výstupu na konci kanálu. V PowerShellu obvykle není nutné používat rutinu v instancích, kde se výstup zobrazuje ve výchozím nastavení. Například Get-Process | Write-Output je ekvivalentní s Get-Process. Nebo může echo "Home directory: $HOME" být napsán, "Home directory: $HOME".

Ve výchozím nastavení Write-Output vytvoří výčet objektů v kolekci. Write-Output Kolekce však mohou také předat kanál jako jeden objekt s parametrem NoEnumerate.

Příklady

Příklad 1: Získání objektů a jejich zápis do konzoly

V tomto příkladu Get-Process jsou výsledky rutiny uloženy v $P proměnné. Rutina Write-Output zobrazí objekty procesu v $P konzole.

$P = Get-Process
Write-Output $P

Příklad 2: Předání výstupu do jiné rutiny

Tento příkaz předá řetězec "testovací výstup" do Get-Member rutiny, která zobrazí členy třídy System.String , což demonstruje, že řetězec byl předán v kanálu.

Write-Output "test output" | Get-Member

Příklad 3: Potlačení výčtu ve výstupu

Tento příkaz přidá parametr NoEnumerate , který zpracovává kolekci nebo pole jako jeden objekt prostřednictvím kanálu.

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

Count    : 3
...

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

Count    : 1
...

Parametry

-InputObject

Určuje objekty, které se mají odeslat do kanálu. Zadejte proměnnou, která obsahuje objekty, nebo zadejte příkaz nebo výraz, který objekty získá.

Typ:PSObject[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NoEnumerate

Ve výchozím nastavení rutina Write-Output vždy vytvoří výčet výstupu. Parametr NoEnumerate potlačí výchozí chování a zabraňuje Write-Output výčtu výstupu. Parametr NoEnumerate nemá žádný vliv, pokud je příkaz zabalen v závorkách, protože závorky vynucují výčet. Například (Write-Output 1,2,3) stále vyčísluje pole.

Parametr NoEnumerate je užitečný pouze v rámci kanálu. Pokus o zobrazení efektů NoEnumerate v konzole je problematický, protože PowerShell přidá Out-Default na konec každého příkazového řádku, což vede k výčtu. Pokud ale kanálujete Write-Output -NoEnumerate do jiné rutiny, podřízená rutina obdrží objekt kolekce, nikoli výčtové položky kolekce.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSObject

Objekty můžete do této rutiny pipetovat.

Výstupy

PSObject

Tato rutina vrátí objekty odeslané jako vstup.

Poznámky

PowerShell obsahuje následující aliasy pro Write-Output:

  • Všechny platformy:

    • echo

  • Windows:

    • write