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

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

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

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

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

この例では、 コマンドレットのエイリアスである をOut-GridView使用ogvしています。 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

の PassThru パラメーターOut-GridViewを使用すると、パイプラインに複数の項目を送信できます。 PassThru パラメーターを使用すると、OutputMode パラメーターの値を Multiple に設定した場合と同じ効果が得られます。

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

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

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

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

パラメーター

-InputObject

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

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

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

-OutputMode

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

このパラメーターの値が、パイプラインに送信できるアイテムの数を決定します。

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

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

Type:	OutputModeOption
Accepted values:	None, Single, Multiple
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

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

対話型のウィンドウからパイプラインを介して項目を送るには、項目をクリックして選択し、[OK] をクリックします。 Shift キーや Ctrl キーを使用した複数選択がサポートされています。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Title

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

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

-Wait

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

この機能を使用すると、Windows ショートカットで コマンドレットを使用 Out-GridView できます。 が Wait パラメーターを指定せずにショートカットで使用されている場合Out-GridView、Out-GridViewウィンドウは PowerShell が閉じる前に一時的にしか表示されません。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

PSObject

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

出力

None

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

PSObject

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

メモ

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

• Windows の場合:
  • ogv

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

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

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

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

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

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

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

列を非表示または表示するには、次の手順に従います。

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

列を並べ替えるには、次の手順に従います。

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

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

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

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

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

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

行をコピーする方法

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

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

テーブルにSearchする方法 (クイック フィルター)

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

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

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

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

• 列にSearchします。 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