Sdílet prostřednictvím

Out-Host

  • Reference
Modul:
Microsoft.PowerShell.Core

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žít jeho parametry.

Out-Host se automaticky připojí ke každému příkazu, který se spustí. Předá 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á řídicí sekvence ANSI hostiteli bez pokusu o jejich interpretaci nebo změnu.

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 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 použije parametr InputObject k určení $io proměnné 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á.

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

-Paging

Označuje, že Out-Host zobrazuje jednu stránku výstupu najednou a čeká na vstup uživatele před zobrazením zbývajících stránek. 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ávesou Enter zobrazte další řádek výstupu. Stisknutím klávesy Q ukončete.

Stránkování je podobné příkazu more .

Poznámka

Parametr stránkování není podporován hostitelem PowerShell ISE.

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

Vstupy

PSObject

Objekty můžete posílat v kanálu do Out-Host.

Výstupy

None

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

Poznámky

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 odesílají je do zadaného cíle zobrazení. Pokud do rutiny odešlete neformátovaný objekt Out- , odešle ho rutina do rutiny formátování před jeho vykreslením.

Rutiny Out- nemají parametry pro názvy ani cesty k souborům. Pokud chcete odeslat data do Out- rutiny, 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 do rutiny.

Out-Host odesílá data, ale nevytváří žádné výstupní objekty. Pokud výstup kanálu do Out-Host rutiny Get-Member , hlásí, Get-Member že nebyly zadány žádné objekty.