Write-Output
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.
Syntax
Default (Výchozí)
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ředat výstup do jiného cmdletu
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á parametr NoEnumerate pro zacházení s kolekcí nebo polem jako s jediným objektem prostřednictvím pipeliny.
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á.
Vlastnosti parametru
| Typ: | PSObject[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
PSObject
Objekty můžete write-output .
Výstupy
PSObject
write-output vrátí objekty odeslané jako vstup.