Out-Host
Odešle výstup do příkazového řádku.
Syntaxe
All
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]
Description
Rutina Out-Host odešle výstup do hostitele PowerShellu pro zobrazení. Hostitel zobrazí výstup na příkazovém řádku. Vzhledem k tomu, že Out-Host je výchozí, nemusíte ho zadávat, pokud nechcete použít jeho parametry.
Out-Host předá výstup kanálu hostiteli, který příkaz spouští.
Out-Host ignoruje řídicí sekvence ANSI. Řídicí sekvence zpracovává hostitel.
Out-Host předá hostiteli řídicí sekvence ANSI bez nutnosti je interpretovat nebo měnit.
Příklady
Příklad 1: Zobrazení výstupu po jedné stránce
Tento příklad zobrazuje systémové procesy po jedné stránce.
Get-Process | Out-Host -Paging
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
30 24.12 36.95 15.86 21004 14 ApplicationFrameHost
55 24.33 60.48 10.80 12904 14 BCompare
<SPACE> next page; <CR> next line; Q quit
9 4.71 8.94 0.00 16864 14 explorer
<SPACE> next page; <CR> next line; Q quit
Get-Process získá systémové procesy a odešle objekty dolů kanálu.
Out-Host používá parametr stránkování k zobrazení jedné stránky dat najednou.
Příklad 2: Použití proměnné jako vstupu
Tento příklad používá objekty uložené v proměnné jako vstup pro Out-Host.
$io = Get-History
Out-Host -InputObject $io
Get-History získá historii relace PowerShellu a uloží objekty do proměnné $io.
Out-Host pomocí parametru InputObject určí proměnnou $io a zobrazí historii.
Parametry
-InputObject
Určuje objekty, které jsou zapsány do konzoly. 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: | Named |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Paging
Označuje, že Out-Host se najednou zobrazí jedna stránka výstupu. Velikost stránky je určena charakteristikami hostitele.
Po výstupu první stránky příkaz před zobrazením zbývajících stránek počká na vstup uživatele. Stisknutím mezerníku zobrazte další stránku výstupu nebo klávesu Enter a zobrazte další řádek výstupu. Stisknutím Q ukončete.
Použití stránkování se podobá použití dalšího příkazu.
Poznámka:
Hostitel ISE PowerShellu nepodporuje parametr stránkování.
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
K tomuto cmdletu můžete přesměrovat libovolný objekt.
Výstupy
None
Tento cmdlet nevrátí žádný výstup. Odesílá objekty hostiteli pro zobrazení.
Poznámky
PowerShell obsahuje následující aliasy pro Out-Host:
- Všechny platformy:
oh
Ne všichni hostitelé PowerShellu podporují parametr stránkování . Pokud například použijete parametr Stránkování v prostředí Windows PowerShell ISE, zobrazí se následující chyba:
out-lineoutput: Metoda nebo operace není implementována.
Rutiny, které obsahují příkaz Out, Out-, neformátují objekty. Vykreslují objekty a posílají je do zadaného cíle zobrazení. Pokud do rutiny Out- odešlete neformátovaný objekt, rutina ho před vykreslením odešle do rutiny formátování.
Rutiny Out- nečtou vstup ze souborů. Pokud chcete odesílat data do Out- rutiny, použijte kanál k odeslání dat do rutiny. Nebo můžete data uložit do proměnné a pomocí parametru InputObject předat data rutině.
Out-Host odesílá data pouze hostiteli. Tt negeneruje výstupní objekty do kanálu. Pokud kanálujete výstup Out-Host do rutiny Get-Member, Get-Member hlásí, že nebyly zadány žádné objekty.
