Out-Null

  • リファレンス
モジュール:
Microsoft.PowerShell.Core

出力をパイプラインに送信したり表示したりする代わりに、出力を非表示にします。

構文

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

説明

このコマンドレットは Out-Null 出力を NULL に送信し、実際にはパイプラインから出力を削除し、出力が画面に表示されないようにします。 これは標準出力ストリームにのみ影響します。 エラー ストリームなどの他の出力ストリームは影響を受けません。 例外が表示されます。 これにより、エラーのコマンドを簡単にテストできます。

例

例 1: 出力を削除する

Get-ChildItem | Out-Null

このコマンドは、現在の場所/ディレクトリ内の項目を取得しますが、その出力はパイプラインを介して渡されたり、コマンド ラインに表示されたりすることはありません。 これは、不要な出力を非表示にする場合に便利です。

パラメーター

-InputObject

NULL に送信するオブジェクトを指定します (パイプラインから削除されます)。 オブジェクトが格納されている変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

入力

PSObject

任意のオブジェクトをこのコマンドレットにパイプできます。

出力

None

このコマンドレットは、出力を返しません。

メモ

  • Out 動詞 (Out コマンドレット) を含むコマンドレットには、名前またはファイル パスのパラメーターがありません。 Out コマンドレットにデータを送信するには、パイプライン演算子 (|) を使用して、Windows PowerShell コマンドの出力をコマンドレットに送信します。 また、変数にデータを格納し、InputObject パラメーターを使用してコマンドレットにデータを渡すこともできます。 詳細については、 例 を参照してください。
  • Out-Null は出力オブジェクトを返しません。 Get-Member コマンドレットへの出力 Out-Null をパイプ処理すると、 Get-Member オブジェクトが指定されていないことが報告されます。