刪除輸出而不傳送到主控台。

語法

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

描述

Out-Null Cmdlet 會將輸出傳送到 NULL，實際上等於刪除它。

參數

-InputObject <psobject>

指定要傳送至 Null 進行刪除的物件。請輸入包含物件的變數，或輸入可取得物件的命令或運算式。

必要?

false

位置?

named

預設值

接受管線輸入?

true (ByValue)

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.Management.Automation.PSObject

您可經由管道將任何物件輸出至 Out-Null。

輸出

無

Out-Null 不會產生任何輸出。

附註

包含 Out 動詞的 Cmdlet (Out Cmdlet) 沒有代表名稱或檔案路徑的參數。若要傳送資料給 Out Cmdlet，請使用管線運算子 (|) 將 Windows PowerShell 命令的輸出傳送給 Cmdlet。您也可以將資料儲存至變數，再使用 InputObject 參數將資料傳遞給 cmdlet。如需詳細資訊，請參閱範例。

Out-Null 不會傳回任何輸出物件。如果您經由管道將 Out-Null 的輸出輸出至 Get-Member，Get-Member 就會報告尚未指定物件的狀況。

範例 1

C:\PS>get-childitem | out-null

描述
-----------
這個命令會取得本機目錄中的項目，但是接著就予以捨棄，而不會透過管線進行傳遞，或將其顯示在命令列。這在捨棄不需要的輸出時很有用。

請參閱



目錄