Out-Host

Odešle výstup do příkazového řádku.

Syntax

Out-Host
   [-Paging]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

Rutina Out-Host odešle výstup hostiteli PowerShellu pro zobrazení. Hostitel zobrazí výstup na příkazovém řádku. Protože Out-Host je výchozí, nemusíte ho zadávat, pokud nechcete používat jeho parametry.

Out-Host se automaticky připojí ke každému příkazu, který se spustí. Předává výstup kanálu hostiteli, který příkaz spouští. Out-Host ignoruje řídicí sekvence ANSI. Řídicí sekvence jsou zpracovávány hostitelem. Out-Host předá hostiteli řídicí sekvence ANSI, aniž by se je pokusil interpretovat nebo změnit.

Příklady

Příklad 1: Zobrazení výstupu jedné stránky najednou

Tento příklad zobrazuje systémové procesy najednou jednu stránku.

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 do 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 $io proměnné. 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ý získá objekty.

Type:PSObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Paging

Označuje, že Out-Host se zobrazí jedna stránka výstupu najednou a před zobrazením zbývajících stránek čeká na vstup uživatele. Ve výchozím nastavení se veškerý výstup zobrazí na jedné stránce. Velikost stránky je určena vlastnostmi hostitele.

Stisknutím mezerníku zobrazte další stránku výstupu nebo klávesu Enter a zobrazte další řádek výstupu. Stisknutím klávesy Q ukončete.

Stránkování se podobá více příkazům.

Poznámka

Parametr Stránkování není hostitelem ISE PowerShellu podporován.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

PSObject

Objekty můžete odeslat dolů do Out-Hostkanálu .

Výstupy

None

Out-Host nevygeneruje žádný výstup. Odesílá objekty hostiteli pro zobrazení.

Poznámky

Parametr Stránkování není podporován všemi hostiteli PowerShellu. Pokud například použijete parametr Stránkování v prostředí PowerShell ISE, zobrazí se následující chyba: out-lineoutput : The method or operation is not implemented.

Rutiny, které obsahují příkaz Out , Out-neformátují objekty. Vykreslují objekty a odesílají je do zadaného cíle zobrazení. Pokud do rutiny odešlete neformátovaný objekt Out- , rutina ho před vykreslením odešle do rutiny formátování.

Rutiny Out- nemají parametry pro názvy nebo cesty k souborům. Pokud chcete odesílat data do Out- rutiny, pomocí kanálu odešlete výstup příkazu PowerShellu do rutiny. Nebo můžete data ukládat do proměnné a pomocí parametru InputObject předat data rutině.

Out-Host odesílá data, ale nevygeneruje žádné výstupní objekty. Pokud kanálujete výstup Out-Host rutiny Get-Member , sestavy, Get-Member že nebyly zadány žádné objekty.