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 trzeba 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 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 jednocześnie 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 Spacja, 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ć pracę.

Stronicowanie jest podobne do więcej 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

Do tego polecenia cmdlet można przekazać dowolny obiekt.

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 programu Out-Host:

  • Wszystkie platformy:
    • oh

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 wyślesz niesformatowany obiekt do Out- polecenia cmdlet, polecenie cmdlet wyśle go 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 polecenia Out-HostGet-Member cmdlet raporty, Get-Member że nie określono żadnych obiektów.