Udostępnij za pośrednictwem

Out-Host

  • Odwołanie
Moduł:
Microsoft.PowerShell.Core

Wysyła dane wyjściowe do wiersza polecenia.

Składnia

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

Opis

Polecenie Out-Host cmdlet wysyła dane wyjściowe do hosta programu PowerShell na potrzeby wyświetlania. Host wyświetla dane wyjściowe w wierszu polecenia. Ponieważ Out-Host jest to ustawienie domyślne, nie musisz go określać, chyba że chcesz użyć jego parametrów.

Out-Host jest automatycznie dołączany do każdego wykonywanego polecenia. Przekazuje dane wyjściowe potoku do hosta wykonującego polecenie. Out-Host ignoruje sekwencje ucieczki ANSI. Sekwencje ucieczki są obsługiwane przez hosta. Out-Host przekazuje sekwencje ucieczki ANSI do hosta bez próby ich interpretacji lub zmiany.

Przykłady

Przykład 1. Wyświetlanie danych wyjściowych jednej strony naraz

W tym przykładzie system przetwarza jedną stronę naraz.

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 pobiera procesy systemowe i wysyła obiekty w dół potoku. Out-Host używa parametru stronicowania , aby wyświetlić jedną stronę danych jednocześnie.

Przykład 2. Używanie zmiennej jako danych wejściowych

W tym przykładzie użyto obiektów przechowywanych w zmiennej jako danych wejściowych dla Out-Hostelementu .

$io = Get-History
Out-Host -InputObject $io

Get-History pobiera historię sesji programu PowerShell i przechowuje obiekty w zmiennej $io . Out-Host używa parametru InputObject , aby określić zmienną $io i wyświetlić historię.

Parametry

-InputObject

Określa obiekty zapisywane w konsoli programu . Wprowadź zmienną zawierającą obiekty lub wpisz polecenie lub wyrażenie, które pobiera obiekty.

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

-Paging

Wskazuje, że Out-Host wyświetla jedną stronę danych wyjściowych w danym momencie i czeka na dane wejściowe użytkownika przed wyświetleniem pozostałych stron. Domyślnie wszystkie dane wyjściowe są wyświetlane na jednej stronie. Rozmiar strony jest określany przez cechy hosta.

Naciśnij pasek spacji , aby wyświetlić następną stronę danych wyjściowych lub klawisz Enter , aby wyświetlić następny wiersz danych wyjściowych. Naciśnij klawisz Q , aby zamknąć.

Stronicowanie jest podobne do większego polecenia.

Uwaga

Parametr stronicowania nie jest obsługiwany przez hosta ISE programu PowerShell.

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

Dane wejściowe

PSObject

Możesz przekazać dowolny obiekt do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych. Wysyła obiekty do hosta na potrzeby wyświetlania.

Uwagi

Program PowerShell zawiera następujące aliasy dla Out-Hostprogramu :

  • Wszystkie platformy:
    • oh

Parametr stronicowania nie jest obsługiwany przez wszystkie hosty programu PowerShell. Jeśli na przykład używasz parametru stronicowania w środowisku PowerShell ISE, zostanie wyświetlony następujący błąd: out-lineoutput : The method or operation is not implemented.

Polecenia cmdlet zawierające czasownik Out , Out-nie formatują obiektów. Renderują obiekty i wysyłają je do określonego miejsca docelowego wyświetlania. Jeśli wysyłasz niesformatowany obiekt do Out- polecenia cmdlet, polecenie cmdlet wysyła je do polecenia cmdlet formatowania przed jego renderowaniem.

Polecenia Out- cmdlet nie mają parametrów dla nazw ani ścieżek plików. Aby wysłać dane do Out- polecenia cmdlet, użyj potoku, aby wysłać dane wyjściowe polecenia programu PowerShell do polecenia cmdlet. Możesz też przechowywać dane w zmiennej i użyć parametru InputObject , aby przekazać dane do polecenia cmdlet.

Out-Host wysyła dane, ale nie generuje żadnych obiektów wyjściowych. W przypadku potoku Get-Member danych wyjściowych Out-Host polecenia cmdlet raporty, Get-Member że nie określono żadnych obiektów.