Sdílet prostřednictvím

Out-Host

  • Reference
Modul:
Microsoft.PowerShell.Core

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

Syntaxe

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 se automaticky připojí ke každému příkazu, který se spustí. Předává výstup kanálu hostiteli, který spouští příkaz. 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á.

Typ:PSObject
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Paging

Označuje, že Out-Host zobrazí jednu stránku výstupu najednou a před zobrazením zbývajících stránek počká 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 charakteristikami hostitele.

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.

stránkovací se podobá více příkazu.

Poznámka

Hostitel ISE PowerShellu nepodporuje parametr stránkování.

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

Do této rutiny můžete převést libovolný objekt.

Výstupy

None

Tato rutina 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

Všichni hostitelé PowerShellu nepodporují parametr stránkování. 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 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- nemají parametry pro názvy nebo cesty k souborům. Pokud chcete odesílat data do rutiny Out-, použijte kanál k odeslání výstupu příkazu PowerShellu do rutiny. Nebo můžete data uložit 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 do rutiny Get-Member, Get-Member hlásí, že nebyly zadány žádné objekty.