Out-GridView

モジュール:

Microsoft.PowerShell.Utility

別のウィンドウで対話型テーブルに出力を送信します。

構文

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-PassThru]
   [<CommonParameters>]

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-Wait]
   [<CommonParameters>]

Out-GridView
   [-InputObject <PSObject>]
   [-Title <String>]
   [-OutputMode <OutputModeOption>]
   [<CommonParameters>]

説明

このコマンドレットは、Windows プラットフォームでのみ使用できます。

Out-GridView コマンドレットは、コマンドからの出力をグリッド ビュー ウィンドウに送信し、出力が対話型テーブルに表示されます。

このコマンドレットにはユーザー インターフェイスが必要であるため、Windows Server Core または Windows Nano Server では機能しません。

テーブルの次の機能を使用して、データを調べることができます。

• 列の非表示、表示、並べ替え
• 行の並べ替え
• クイック フィルター
• 条件フィルターを追加する
• コピーして貼り付ける

完全な手順については、この記事の「ノート」セクションを参照してください。

手記

このコマンドレットは、PowerShell 7 で再導入されました。 このコマンドレットは、Windows デスクトップをサポートする Windows システムでのみ使用できます。 このコマンドレットのクロスプラットフォーム バージョンについては、PowerShell ギャラリーの ConsoleGuiTools モジュールを参照してください。

例

例 1: プロセスをグリッド ビューに出力する

この例では、ローカル コンピューターで実行されているプロセスを取得し、グリッド ビュー ウィンドウに送信します。

Get-Process | Out-GridView

例 2: 変数を使用してグリッド ビューにプロセスを出力する

この例では、ローカル コンピューターで実行されているプロセスも取得し、グリッド ビュー ウィンドウに送信します。

$P = Get-Process
$P | Out-GridView

Get-Process コマンドレットの出力は、$P 変数に保存されます。 次に、$P が Out-GridViewにパイプ処理されます。

例 3: グリッド ビューで選択したプロパティを表示する

次の使用例は、実行中のプロセスの選択したプロパティをグリッド ビューに表示します。

Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet |
  Sort-Object -Property WorkingSet -Descending | Out-GridView

の出力は にパイプ処理され、名の、WorkingSet、PeakWorkingSet プロパティ 選択されます。 別のパイプライン演算子は、フィルター処理されたオブジェクトを Sort-Object コマンドレットに送信して、WorkingSet プロパティの値で降順に並べ替えます。 次に、並べ替えられた結果が Out-GridViewにパイプ処理されます。 グリッド ビューの機能を使用して、データを検索、並べ替え、フィルター処理できるようになりました。

例 4: 出力を変数に保存し、グリッド ビューを出力する

次の使用例は、コマンドレットの出力を変数に保存し、Out-GridViewに送信します。

($A = Get-ChildItem -Path $PSHOME -Recurse) | Out-GridView

Get-ChildItem は、$PSHOME 自動変数を使用して、PowerShell インストール ディレクトリとそのサブディレクトリ内のすべてのファイルを取得します。 コマンドのかっこによって、操作の順序が確立されます。 その結果、Get-ChildItem コマンドからの出力は、$Aに送信される前に Out-GridView 変数に保存されます。

例 5: 指定したコンピューターの出力プロセスをグリッド ビューに出力する

次の使用例は、Server01 コンピューターで実行されているプロセスをグリッド ビュー ウィンドウに表示します。

Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"

この例では、ogv(Out-GridView コマンドレットのエイリアス) を使用します。 Title パラメーターは、ウィンドウのタイトルを指定します。

例 6: リモート コンピューターからグリッド ビューにデータを出力する

この例では、リモート コンピューターから収集されたデータを Out-GridViewに送信する方法を示します。

Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridView

Invoke-Command は、3 台のリモート コンピューターで Get-Culture 実行されます。 結果のデータは、Out-GridViewにパイプ処理されます。 リモート コンピューターで実行されるスクリプト ブロックに Out-GridView コマンドが含まれていないことに注意してください。 その場合、コマンドは、各リモート コンピューターでグリッド ビュー ウィンドウを開こうとしたときに失敗します。

例 7: 'Out-GridView' を介して複数の項目を渡す

この例では、Out-GridView ウィンドウから複数のプロセスを選択できます。 選択したプロセスは、Export-Csv コマンドに渡され、ProcessLog.csv ファイルに書き込まれます。

Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csv

の Out-GridView パラメーターを使用すると、パイプラインに複数の項目を送信できます。 PassThru パラメーターは、OutputMode パラメーターの Multiple 値を使用することと同じです。

例 8: 'Out-GridView' への Windows ショートカットを作成する

この例では、 の Out-GridView パラメーターを使用して、Out-GridView ウィンドウへの Windows ショートカットを作成する方法を示します。

pwsh -Command "Get-Service | Out-GridView -Wait"

このコマンド ラインは、Windows ショートカットで使用できます。 Wait パラメーターがないと、Out-GridView ウィンドウが開くとすぐに PowerShell が終了し、Out-GridView ウィンドウがほぼ直ちに閉じられます。

パラメーター

-InputObject

コマンドレットが Out-GridViewの入力として受け入れるオブジェクトを指定します。

InputObject パラメーターを使用してオブジェクトのコレクションを Out-GridViewに送信すると、Out-GridView はコレクションを 1 つのコレクション オブジェクトとして扱い、コレクションを表す 1 行が表示されます。 コレクション内の各オブジェクトを表示するには、パイプライン演算子 (|) を使用してオブジェクトを Out-GridViewに送信します。

型:	PSObject
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-OutputMode

対話型ウィンドウがパイプラインを他のコマンドへの入力として送信する項目を指定します。 既定では、このコマンドレットは出力を生成しません。 対話型ウィンドウからパイプラインの下に項目を送信するには、項目をクリックして選択し、[OK] をクリックします。

このパラメーターの値によって、パイプラインを送信できる項目の数が決まります。

• None. 項目なし。 これが既定値です。
• Single. 0 個の項目または 1 つの項目。 次のコマンドで入力オブジェクトを 1 つだけ取得できる場合は、この値を使用します。
• Multiple. 0、1、または多くの項目。 次のコマンドで複数の入力オブジェクトを取得できる場合は、この値を使用します。 この値は、Passthru パラメーターと同じです。

このパラメーターは、Windows PowerShell 3.0 で導入されました。

型:	OutputModeOption
指定可能な値:	None, Single, Multiple
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

コマンドレットが対話型ウィンドウからパイプラインの下にある項目を他のコマンドへの入力として送信することを示します。 既定では、このコマンドレットは出力を生成しません。 このパラメーターは、OutputMode パラメーターの Multiple 値を使用することと同じです。

対話型ウィンドウからパイプラインの下に項目を送信するには、項目をクリックして選択し、[OK] をクリックします。 Shift キーを押しながらクリックし、Ctrl キーを押しながらクリックできます。

型:	SwitchParameter
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Title

Out-GridView ウィンドウのタイトル バーに表示されるテキストを指定します。 既定では、タイトル バーには、Out-GridViewを呼び出すコマンドが表示されます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Wait

コマンドレットがコマンド プロンプトを抑制し、Out-GridView ウィンドウが閉じられるまで Windows PowerShell を閉じないようにすることを示します。 既定では、Out-GridView ウィンドウが開いたときにコマンド プロンプトが返されます。

この機能を使用すると、Windows ショートカットで Out-GridView コマンドレットを使用できます。 Out-GridView パラメーターを指定せずにショートカットで を使用すると、Out-GridView ウィンドウは PowerShell が閉じる直前にのみ表示されます。

型:	SwitchParameter
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

PSObject

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

出力

None

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

PSObject

PassThru パラメーターを使用すると、このコマンドレットは選択した行を表すオブジェクトを返します。

メモ

PowerShell には、 Out-GridViewの次のエイリアスが含まれています。

• ウィンドウズ：
  • ogv

このコマンドレットは、Windows プラットフォームでのみ使用できます。 このコマンドレットは、Windows プラットフォームでのみ使用できます。

リモート コマンドを使用して、別のコンピューターでグリッド ビュー ウィンドウを開くことはできません。

Out-GridView に送信するコマンド出力は、Format コマンドレットや Format-Table コマンドレットなどの Format-Wide コマンドレットを使用して書式設定することはできません。 プロパティを選択するには、Select-Object コマンドレットを使用します。

リモート コマンドから逆シリアル化された出力が、グリッド ビュー ウィンドウで正しく書式設定されない場合があります。

のキーボード ショートカットを する

次のキーを使用します。	このアクションを実行するには:
タブ	カーソルを フィルター ボックスから [条件の追加] メニューに移動し、テーブルに戻します。
UpArrow を する	1 行上に移動します。 データの最初の行から列ヘッダーに移動します。
DownArrow を する	1 行下へ移動します。
LeftArrow を する	列ヘッダー行で、左に 1 列移動します。
RightArrow の	列ヘッダー行で、1 列右に移動します。
ContextMenuKey	列ヘッダー行に、[列の選択] オプションが表示されます。
または Space キーを を入力	列ヘッダー行で、列データを並べ替えます (A から Z、Z-A の切り替え)。

グリッド ビュー ウィンドウ機能を使用する方法

列を非表示または表示するには:

1. 任意の列ヘッダーを右クリックし、[列の選択]クリックします。
2. [列の選択] ダイアログ ボックスで、方向キーを使用して、[選択した列] の間の列を [使用可能な列] ボックスに移動します。 グリッド ビュー ウィンドウには、[列の選択] ボックスの列のみが表示されます。

列を並べ替えるには:

目的の場所に列をドラッグ アンド ドロップできます。 または、次の手順を使用します。

1. 任意の列ヘッダーを右クリックし、[列の選択]クリックします。
2. [列の選択] ダイアログ ボックスで、[上へ移動] ボタンと [下へ移動] ボタン 使用して列の順序を変更します。 リストの上部にある列は、グリッド ビュー ウィンドウのリストの下部にある列の左側に表示されます。

テーブル データ を並べ替える方法の

• データを並べ替えるには、列ヘッダーをクリックします。
• 並べ替え順序を変更するには、列ヘッダーをもう一度クリックします。 同じヘッダーをクリックするたびに、並べ替え順序が昇順から降順に切り替わります。 現在の順序は、列ヘッダーの三角形で示されます。

テーブル データの を選択する方法

• 行を選択するには、行を選択するか、上下の矢印を使用して行に移動します。
• すべての行 (ヘッダー行を除く) を選択するには、Ctrl キー 押+A。
• 連続する行を選択するには、Shift キーを押しながら行をクリックするか、方向キーを使用します。
• 連続しない行を選択するには、Ctrl キーを押し、クリックして選択範囲に行を追加します。
• 列を選択することも、列ヘッダー行全体を選択することもできません。

行 をコピーする方法

• テーブルから 1 つ以上の行をコピーするには、行を選択し、Ctrl キーを押しながら C キーを押します。

  任意のテキストまたはスプレッドシート プログラムにデータを貼り付けることができます。 列または行の一部をコピーすることはできません。また、列ヘッダー行をコピーすることもできません。

テーブルで検索する方法 (クイック フィルター)

[フィルター] ボックスを使用して、テーブル内のデータを検索します。 ボックスに入力すると、入力したテキストを含む項目のみがテーブルに表示されます。

• テキストを検索します。 テーブル内のテキストを検索するには、[フィルター] ボックスに検索するテキストを入力します。

• 複数の単語を検索します。 テーブル内の複数の単語を検索するには、スペースで区切られた単語を入力します。 Out-GridView は、すべての単語 (論理 AND) を含む行を表示します。

• リテラル フレーズを検索します。 スペースまたは特殊文字を含む語句を検索するには、語句を引用符で囲みます。 Out-GridView は、フレーズに完全に一致する行を表示します。

• 列を検索します。 1 つ以上の列のテキストを検索するには、次の形式を使用します。

  <column>:<text> [<column>:<text>] ...

  たとえば、DisplayName 列で "Net" を検索するには、[フィルター] ボックスに次のように入力します。

  displayname:net

  DisplayName と Name 列で "Net" の行を検索するには、[フィルター] ボックスに次のように入力します。

  displayname:net name:net

• 検索をオフにします。 テーブル全体をもう一度表示するには、[フィルター] ボックスの右上隅にある赤い [X] ボタンをクリックするか、[フィルター] ボックスからテキストを削除します。

抽出条件を使用してテーブル をフィルター処理する

ルールまたは条件を使用して、テーブルに表示される項目を決定できます。 項目は、設定したすべての条件を満たす場合にのみ表示されます。 使用可能な条件は、グリッド ビュー ウィンドウに表示されるオブジェクトのプロパティと、それらのプロパティの .NET Framework 型によって決まります。

各条件の形式は次のとおりです。

<column> <operator> <value>

さまざまなプロパティの条件は、ANDによって接続されます。 同じプロパティの条件は、ORによって接続されます。 論理コネクタは変更できません。

条件は表示にのみ影響します。 テーブルから項目は削除されません。

抽出条件を追加する方法

1. [条件 追加] メニュー ボタン 表示するには、ウィンドウの右上隅にある [展開] 矢印をクリックします。
2. [条件の追加] メニュー ボタン クリックします。
3. クリックして列 (プロパティ) を選択します。 1 つまたは複数のプロパティを選択できます。
4. プロパティの選択が完了したら、[ の追加] ボタンをクリックします。
5. 追加を取り消すには、[キャンセル]クリックします。
6. 条件をさらに追加するには、もう一度 [条件の追加 ] ボタンをクリックします。

条件 を編集する方法

• 演算子を変更するには、青色の演算子値をクリックし、ドロップダウン リストから別の演算子を選択します。
• 値を入力または変更するには、値ボックスに値を入力します。 無効な値を入力すると、循環 X アイコンが表示されます。 削除するには、値を変更します。
• OR ステートメントを作成するには、同じプロパティを持つ条件を追加します。

抽出条件 を削除する方法の

• 選択した条件を削除するには、各条件の横にある赤い X をクリックします。
• すべての条件を削除するには、[すべてクリア] ボタン クリック。

関連リンク

• Out-File
• Out-Printer
• Out-String