Sdílet prostřednictvím

Write-Output

  • Reference
Modul:
Microsoft.PowerShell.Utility

Odešle zadané objekty do dalšího příkazu v kanálu. Pokud je příkaz posledním příkazem v kanálu, zobrazí se v konzole objekty.

Syntaxe

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

Description

Rutina Write-Output odešle zadaný objekt mimo kanál do dalšího příkazu. Pokud je příkaz posledním příkazem v kanálu, objekt se zobrazí v konzole.

zápisu odesílá objekty mimo primární kanál, označovaný také jako "výstupní stream" nebo "kanál úspěchu". Chcete-li odeslat chybové objekty v kanálu chyby, použijte write-Error.

Tato rutina se obvykle používá ve skriptech k zobrazení řetězců a dalších objektů v konzole. Vzhledem k tomu, že výchozím chováním je zobrazení objektů na konci kanálu, obvykle není nutné tuto rutinu používat. Například Get-Process | Write-Output je ekvivalentní Get-Process.

Příklady

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

PS C:\> $P = Get-Process
PS C:\> Write-Output $P
PS C:\> $P

První příkaz načte procesy spuštěné v počítači a uloží je do proměnné $P.

Druhý a třetí příkaz zobrazí objekty procesu v $P v konzole.

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

PS C:\> Write-Output "test output" | Get-Member

Tento příkaz předá ř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 kanálu.

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

PS C:\> Write-Output @(1,2,3) | measure

Count    : 3
...

PS C:\> Write-Output @(1,2,3) -NoEnumerate | measure

Count    : 1

Tento příkaz přidá NoEnumerate parametr pro zpracování kolekce nebo pole jako jednoho objektu prostřednictvím kanálu.

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 zápisu výstupu výčtu výstupu. Parametr NoEnumerate nemá žádný vliv na kolekce vytvořené zabalením příkazů do závorek, protože závorky vynucují výčet.

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 write-output .

Výstupy

PSObject

write-output vrátí objekty odeslané jako vstup.