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 je Write-Output posledním příkazem v pipelině, zobrazí se v konzole objekty.

Write-Output odesílá objekty do primárního kanálu, také známého jako datový proud úspěchu . Chcete-li odeslat chybové objekty do datového proudu chyb, 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ě jako jiné shelly, 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 příkaz v případech, kde je výstup zobrazen ve výchozím nastavení. Například Get-Process | Write-Output je ekvivalentní Get-Process. Nebo echo "Home directory: $HOME" lze psát "Home directory: $HOME".

Ve výchozím nastavení Write-Output vytváří seznam objektů v kolekci. Write-Output ale také může předat kolekce skrze 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 jsou výsledky rutiny Get-Process uloženy v proměnné $P. Cmdlet Write-Output zobrazí procesní objekty v $P na konzoli.

$P = Get-Process
Write-Output $P

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

Tento příkaz přesměruje řetězec "testovací výstup" do rutiny Get-Member, která zobrazí členy třídy System.String, což demonstruje, že řetězec byl předán v rámci 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ý umožní zpracovat kolekci nebo pole jako jeden objekt v rámci potrubí.

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ý do závorek, protože závorky vynucují výčet. Například (Write-Output 1,2,3 -NoEnumerate) pole stále vyčísluje.

Parametr NoEnumerate je užitečný pouze v rámci roury. 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. Když ale předáte Write-Output -NoEnumerate do jiné rutiny pomocí pipe, příslušná rutina zpracuje objekt kolekce, nikoli jednotlivé 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 přesměrovat do této příkazové rutiny.

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