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 cmdlet Out-Host 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 wartością domyślną, nie musisz jej 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 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.

Typ:PSObject
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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 Enter, aby wyświetlić następny wiersz danych wyjściowych. Naciśnij Q, aby zakończyć pracę.

stronicowanie jest podobne do bardziej polecenia.

Nuta

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 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, które zawierają 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 polecenia cmdlet Out-, polecenie cmdlet wysyła je do polecenia cmdlet formatowania przed jego renderowaniem.

Polecenia cmdlet Out- nie mają parametrów dla nazw ani ścieżek plików. Aby wysłać dane do polecenia cmdlet Out-, 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-Host do polecenia cmdlet Get-MemberGet-Member raportów, że nie określono żadnych obiektów.