共用方式為

Out-Null

  • 參考
模組:
Microsoft.PowerShell.Core

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

語法

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 則報告尚未指定任何物件。