Out-Null
Löscht die Ausgabe, statt sie an die Konsole zu senden.
Syntax
Out-Null [-InputObject <psobject>] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Out-Null" wird die Ausgabe an NULL gesendet und somit gelöscht.
Parameter
-InputObject <psobject>
Gibt das Objekt an, das an NULL gesendet (gelöscht) wird. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder einen Ausdruck ein, mit dem die Objekte abgerufen werden.
Erforderlich? |
false |
Position? |
named |
Standardwert |
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
Eingaben |
System.Management.Automation.PSObject Sie können jedes Objekt über die Pipeline an Out-Null übergeben. |
Ausgaben |
Keiner Out-Null generiert keine Ausgabe. |
Hinweise
Die Cmdlets, die das Verb "Out" enthalten (Ausgabe-Cmdlets), verfügen über keine Parameter für Namen oder Dateipfade. Verwenden Sie zum Übergeben von Daten an ein Ausgabe-Cmdlet den Pipelineoperator (|), um die Ausgabe eines Windows PowerShell-Befehls an das Cmdlet zu senden. Sie können auch Daten in einer Variablen speichern und die Daten mit dem InputObject-Parameter an das Cmdlet übergeben. Weitere Informationen finden Sie in den Beispielen.
Out-Null gibt keine Ausgabeobjekte zurück. Wenn Sie die Ausgabe von Out-Null über die Pipeline an Get-Member übergeben, meldet Get-Member, dass keine Objekte angegeben wurden.
Beispiel 1
C:\PS>get-childitem | out-null
Beschreibung
-----------
Mit diesem Befehl werden die Elemente im lokalen Verzeichnis abgerufen und anschließend verworfen, statt sie über die Pipeline zu übergeben oder in der Befehlszeile anzuzeigen. Dies bietet sich zum Verwerfen von Ausgaben an, die nicht benötigt werden.