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 では機能しません。

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

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

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

Note

このコマンドレットは、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

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

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

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

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

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

例 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 パラメーターを使用すると、パイプラインに複数の項目を送信できます。 PassThru パラメーターは、OutputMode パラメーターの Multiple 値を使用することと同じです。

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

この例では、Out-GridViewの Wait パラメーターを使用して、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 コマンドレットを使用できます。 Wait パラメーターを指定せずにショートカットでOut-GridViewを使用すると、Out-GridView ウィンドウは PowerShell が閉じる直前にのみ表示されます。

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

入力

PSObject

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

出力

None

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

PSObject

PassThru パラメーターを使用すると、選択した行を表すオブジェクトが返されます。

メモ

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

• Windows:
  • ogv

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

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

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

リモート コマンドから逆シリアル化された出力をグリッド ビュー ウィンドウで適切に書式設定することはできません。

のキーボード ショートカット Out-GridView

次のキーを使用します。	このアクションを実行するには:
タブ	カーソルを Filter ボックスから 追加条件 メニューに移動し、テーブルに戻ります。
UpArrow	1 行上に移動します。 データの最初の行から列ヘッダーに移動します。
DownArrow	1 行下へ移動します。
LeftArrow	列ヘッダー行で、左に 1 列移動します。
RightArrow	列ヘッダー行で、1 列右に移動します。
ContextMenuKey	列ヘッダー行に、[列の選択] オプションが表示されます。
Enter または Spacebar	列ヘッダー行で、列データを並べ替えます (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" を検索するには、[ Filter ボックスに次のように入力します。

  displayname:net

  DisplayName および Name 列で "Net" の行を検索するには、[Filter ボックスに次のように入力します。

  displayname:net name:net

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

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

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

各条件は、次の形式で指定します。

<column> <operator> <value>

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

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

抽出条件を追加する方法

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

条件を編集する方法

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

抽出条件を削除する方法

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

関連リンク

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