共用方式為


Out-Null

隱藏輸出,而不是將輸出傳送到管線或顯示它。

語法

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

Description

Cmdlet Out-Null 會將其輸出傳送至 NULL,實際上會將其從管線中移除,並防止畫面上顯示輸出。 這隻會影響標準輸出數據流。 其他輸出數據流,例如錯誤數據流不會受到影響。 將會顯示例外狀況。 這可讓您更輕鬆地測試命令是否有任何錯誤。

範例

範例 1:刪除輸出

Get-ChildItem | Out-Null

此命令會取得目前位置/目錄中的專案,但其輸出不會通過管線傳遞,也不會顯示在命令行上。 這適用於隱藏您不需要的輸出。

參數

-InputObject

指定要傳送至 NULL 的物件(已從管線移除)。 輸入包含 物件的變數,或輸入取得物件的命令或表達式。

類型:PSObject
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

輸入

PSObject

您可以使用管線將任何物件傳送至此 Cmdlet。

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

  • 包含 Out 動詞的 Cmdlet ( Out Cmdlet) 沒有名稱或檔案路徑的參數。 若要將數據傳送至 Out Cmdlet,請使用管線運算符 (|) 將 Windows PowerShell 命令的輸出傳送至 Cmdlet。 您也可以將數據儲存在變數中,並使用 InputObject 參數將數據傳遞至 Cmdlet。 如需詳細資訊,請參閱 範例。
  • Out-Null 不會傳回任何輸出物件。 如果您使用管線將 的 Out-Null 輸出傳送至 Get-Member Cmdlet, Get-Member 則報告尚未指定任何物件。