Sdílet prostřednictvím

Write-Output

  • Reference
Modul:
Microsoft.PowerShell.Utility

Zapíše zadané objekty do roury.

Syntaxe

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

Description

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

Write-Output odesílá objekty do primárního kanálu, označovaného také jako úspěšný tok . 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 vestavěných aliasů pro Write-Output je echo a je podobný jiným shellů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 cmdlet v případech, kdy se výstup zobrazuje automaticky. Například Get-Process | Write-Output je ekvivalentní Get-Process. Nebo echo "Home directory: $HOME" lze psát jako "Home directory: $HOME".

Ve výchozím nastavení Write-Output čísluje objekty v kolekci. Write-Output ale také může předat kolekce potrubím 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í objekty procesu v $P na konzoli.

$P = Get-Process
Write-Output $P

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

Tento příkaz předá řetězec "test output" přes rutinu 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, aby byla kolekce nebo pole zpracovávána jako jeden objekt prostřednictvím 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 potrubí. 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) stále vyčísluje pole.

Parametr NoEnumerate je užitečný pouze v rámci pipeliny. 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 přesměrujete Write-Output -NoEnumerate do jiné rutiny, následující 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