Udostępnij za pośrednictwem

Out-Null

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

Ukrywa dane wyjściowe zamiast wysyłać je w dół potoku lub wyświetlać.

Składnia

Out-Null
   [-InputObject <PSObject>]
   [<CommonParameters>]

Opis

Polecenie Out-Null cmdlet wysyła dane wyjściowe do wartości NULL, w efekcie usuwając je z potoku i uniemożliwiając wyświetlanie danych wyjściowych na ekranie. Ma to wpływ tylko na standardowy strumień wyjściowy. Nie ma to wpływu na inne strumienie wyjściowe, takie jak strumień błędu. Zostaną wyświetlone wyjątki. Ułatwia to przetestowanie polecenia pod kątem błędów.

Przykłady

Przykład 1. Usuwanie danych wyjściowych

Get-ChildItem | Out-Null

To polecenie pobiera elementy w bieżącej lokalizacji/katalogu, ale jego dane wyjściowe nie są przekazywane przez potok ani wyświetlane w wierszu polecenia. Jest to przydatne w przypadku ukrywania danych wyjściowych, których nie potrzebujesz.

Parametry

-InputObject

Określa obiekt, który ma być wysyłany do wartości NULL (usunięte z potoku). 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

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.

Uwagi

  • Polecenia cmdlet zawierające czasownik Out (polecenia cmdlet Out) nie mają parametrów dla nazw ani ścieżek plików. Aby wysłać dane do polecenia cmdlet Out , użyj operatora potoku (|), aby wysłać dane wyjściowe polecenia programu Windows PowerShell do polecenia cmdlet. Możesz również przechowywać dane w zmiennej i użyć parametru InputObject , aby przekazać dane do polecenia cmdlet. Aby uzyskać więcej informacji, zobacz przykłady.
  • Out-Null nie zwraca żadnych obiektów wyjściowych. W przypadku potoku danych wyjściowych polecenia Out-Null cmdlet Get-Member raporty, Get-Member że nie określono żadnych obiektów.