Out-Host
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 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 naraz. Rozmiar strony zależy od cech hosta.
Po wyświetleniu pierwszej strony polecenie czeka na dane wejściowe użytkownika przed wyświetleniem pozostałych stron. Naciśnij spację , 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ę.
Użycie stronicowania jest podobne do użycia więcej 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
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
Nie wszystkie hosty programu PowerShell obsługują parametr stronicowania . Jeśli na przykład używasz parametru stronicowania w środowisku Windows PowerShell ISE, zostanie wyświetlony następujący błąd:
out-lineoutput : metoda lub operacja nie jest zaimplementowana.
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 Out- cmdlet nie odczytują danych wejściowych z plików. Aby wysłać dane do Out- polecenia cmdlet, użyj potoku, aby wysłać dane 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 tylko do hosta. Element Tt nie generuje obiektów wyjściowych w potoku. W przypadku potoku danych wyjściowych Out-Host do polecenia cmdlet Get-MemberGet-Member raportów, że nie określono żadnych obiektów.
