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 do wyświetlenia. Host wyświetla dane wyjściowe w wierszu polecenia. Ponieważ Out-Host jest to ustawienie domyślne, nie trzeba go określać, chyba że chcesz użyć jego parametrów.

Out-Host jest automatycznie dołączany do każdego wykonywanego polecenia. Przekazuje on 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 zinterpretowania 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 do wyświetlania jednej strony danych naraz.

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 elementu Out-Host.

$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 naraz 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 zależy od cech 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 zakończyć.

Stronicowanie jest podobne do większego polecenia.

Uwaga

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

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

Dane wejściowe

PSObject

Możesz wysyłać obiekty w dół potoku do elementu Out-Host.

Dane wyjściowe

None

Out-Host nie generuje żadnych danych wyjściowych. Wysyła obiekty do hosta na potrzeby wyświetlania.

Uwagi

Parametr stronicowania nie jest obsługiwany przez wszystkie hosty programu PowerShell. Jeśli na przykład używasz parametru stronicowania w programie 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 danych wyjściowych Out-HostGet-Member polecenia cmdlet raporty, Get-Member że nie określono żadnych obiektów.