Out-GridView
別のウィンドウの対話型のテーブルに出力を送信します。
構文
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>] 説明
Out-GridView コマンドレットは、コマンドの出力をグリッド ビューのウィンドウに送信し、対話型のテーブルに表示します。
このコマンドレットにはユーザー インターフェイスが必要なので、Windows Server の Server Core インストールでは機能しません。
テーブルの次の機能を使用して、データを確認することができます。
- 列の非表示、表示、並べ替え: 列の非表示、表示、並べ替えを行う場合は、列ヘッダーを右クリックし、[列の選択] をクリックします。
- 並べ替え。 データを並べ替えるには、列ヘッダーをクリックします。 昇順と降順を切り替えるには、再びクリックします。
- クイック フィルター。 ウィンドウの上部にある [フィルター] ボックスを使用して、テーブル内のテキストを検索します。 特定の列内のテキスト、リテラル値、複数の単語を検索することができます。
- 抽出条件フィルター。 [条件の追加] ドロップダウン メニューを使用して、データをフィルター処理するルールを作成します。 これは、イベント ログなどの非常に規模の大きいデータ セットに便利です。
- コピーと貼り付け。 Out-GridView からデータの行をコピーするには、Ctrl キーを押しながら C キーを押します (コピー)。 任意のテキストやスプレッドシート プログラムにデータを貼り付けることができます。
これらの機能を使用する手順については、「 Get-Help Out-GridView -Full ノート」セクションの「グリッド ビュー ウィンドウ機能を使用する方法」を参照してください。
例
例 1: グリッド ビューへの出力プロセス
PS C:\> Get-Process | Out-GridViewこのコマンドは、ローカル コンピューターで実行されているプロセスを取得して、グリッド ビュー ウィンドウに送信します。
例 2: 変数を使用してグリッド ビューにプロセスを出力する
PS C:\> $P = Get-Process
PS C:\> $P | Out-GridViewこのコマンドも、ローカル コンピューターで実行されているプロセスを取得して、グリッド ビュー ウィンドウに送信します。
最初のコマンドでは、Get-Process コマンドレットを使用してコンピューター上のプロセスを取得し、プロセス オブジェクトを $P 変数に保存します。
2 番目のコマンドでは、パイプライン演算子を使用して、$P変数を Out-GridView に送信します。
例 3: グリッド ビューに書式設定されたテーブルを表示する
PS C:\> Get-Process | Select-Object -Property Name, WorkingSet, PeakWorkingSet | Sort-Object -Property WorkingSet -Descending | Out-GridViewこのコマンドは、書式設定されたテーブルをグリッド ビュー ウィンドウに表示します。
Get-Process コマンドレットを使用して、コンピューター上のプロセスを取得します。
次に、パイプライン演算子 (|) を使用して、プロセス オブジェクトを Select-Object コマンドレットに送信します。 このコマンドは、Select-Object の Property パラメーターを使用して、テーブルに表示される Name、WorkingSet、PeakWorkingSet プロパティを選択します。
別のパイプライン演算子は、フィルター処理されたオブジェクトを Sort-Object コマンドレットに送信し、 WorkingSet プロパティの値で降順に並べ替えます。
コマンドの最後の部分でパイプライン演算子 (|) を使用して、書式設定されたテーブルを Out-GridView に送信します。
これで、グリッド ビューの機能を、検索、並べ替え、データのフィルター処理に使用できるようになりました。
例 4: 出力を変数に保存し、グリッド ビューを出力する
PS C:\> ($A = Get-ChildItem -Path $pshome -Recurse) | Out-GridViewこのコマンドは、変数に出力を保存して、Out-GridView に送信します。
コマンドは、Get-ChildItem コマンドレットを使用して、Windows PowerShellインストール ディレクトリとそのサブディレクトリ内のファイルを取得します。 インストール ディレクトリへのパスは、$pshome 自動変数に保存されます。
コマンドは代入演算子 (=) を使用して出力を$A変数に保存し、パイプライン演算子 (|) を使用して 出力を Out-GridView に送信します。
コマンド内のかっこは、演算の順序を確立します。 その結果、Get-ChildItem コマンドからの出力は、 Out-GridView に送信される前に、$A 変数に保存されます。
例 5: 指定したコンピューターの出力プロセスをグリッド ビューに出力する
PS C:\> Get-Process -ComputerName "Server01" | ogv -Title "Processes - Server01"このコマンドは、Server01 コンピューターで実行されているプロセスをグリッド ビュー ウィンドウに表示します。
コマンドでは、Out-GridView コマンドレットの組み込みエイリアスである を使用ogvし、Title パラメーターを使用してウィンドウのタイトルを指定します。
例 6: リモート コンピューターからグリッド ビューにデータを出力する
PS C:\> Invoke-Command -ComputerName S1, S2, S3 -ScriptBlock {Get-Culture} | Out-GridViewこの例は、リモート コンピューターから収集されたデータを Out-GridView コマンドレットに送信するための正しい形式を示します。
コマンドは、Invoke-Command コマンドレットを使用して、3 台のリモート コンピューターで Get-Culture コマンドを実行します。 パイプライン演算子を使用して、返されたデータを Out-GridView コマンドレットに送信します。
リモートで実行されるコマンドが含まれるスクリプト ブロックには、Out-GridView コマンドが含まれません。 含まれている場合、各リモート コンピュータでグリッド ビュー ウィンドウを開こうとすると、コマンドはエラーになります。
例 7: 複数の項目を Out-GridView に渡す
PS C:\> Get-Process | Out-GridView -PassThru | Export-Csv -Path .\ProcessLog.csvこのコマンドにより、Out-GridView ウィンドウから複数のプロセスを選択できます。 選択したプロセスは、Export-Csv コマンドに渡され、ProcessLog.csv ファイルに書き込まれます。
このコマンドは、Out-GridView の PassThru パラメーターを使用して、複数の項目をパイプラインに送信することができます。 PassThru パラメーターを使用すると、OutputMode パラメーターの値を Multiple に設定した場合と同じ効果が得られます。
例 8: Windows ショートカットを Out-GridView にCreateする
PS C:\> Powershell.exe -Command "Get-Service | Out-GridView -Wait"このコマンドは、Out-GridView の Wait パラメーターを使用して Out-GridView ウィンドウに Windows のショートカットを作成する方法を示します。 Wait パラメーターを使用しない場合、Out-GridView ウィンドウが開くとすぐに Windows PowerShell は終了します。そのため、Out-GridView ウィンドウはほぼ瞬時に閉じられます。
パラメーター
-InputObject
コマンドレットが Out-GridView の入力を受け入れるように指定します。
InputObject パラメーターを使用してオブジェクトのコレクションを Out-GridView に送信すると、Out-GridView はコレクションを 1 つのコレクション オブジェクトとして扱い、コレクションを表す 1 行を表示します。 コレクション内の各オブジェクトを表示するには、パイプライン演算子 (|) を使用してオブジェクトを Out-GridView に送信します。
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OutputMode
対話型ウィンドウがパイプラインを他のコマンドへの入力として送信する項目を指定します。 既定では、このコマンドレットによる出力はありません。 対話型のウィンドウからパイプラインを介して項目を送るには、項目をクリックして選択し、[OK] をクリックします。
このパラメーターの値が、パイプラインに送信できるアイテムの数を決定します。
- [なし] : 項目がありません。 これが既定値です。
- 単一: 項目数は 0 または 1 です。 次のコマンドが受け取ることができる入力オブジェクトが 1 つのみの場合、この値を使用します。
- 複数。 項目数は、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 キーを使用した複数選択がサポートされています。
このパラメーターは Windows PowerShell 3.0 で導入されました。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 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
コマンドレットがコマンド プロンプトを抑制し、Out-GridView ウィンドウが閉じられるまでWindows PowerShellが閉じないようにすることを示します。 既定では、 Out-GridView ウィンドウが開くとコマンド プロンプトが返されます。
この機能により、Windows ショートカットで Out-GridView コマンドレットを使用できます。 Out-GridView が Waitパラメーターなしでショートカットで使用されると、Windows PowerShell を閉じる前に、Out-GridView ウィンドウが一瞬表示されます。
このパラメーターは Windows PowerShell 3.0 で導入されました。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
任意のオブジェクトをこのコマンドレットに送信できます。
出力
None
Out-GridView はオブジェクトを返しません。
メモ
Windows PowerShell 2.0 では、Out-GridView コマンドレットは既定でクライアント バージョンの Windows にインストールされますが、Windows のサーバー バージョンではオプションの機能です。 Windows PowerShell 3.0 では、既定ですべてのシステムにインストールされます。 ただし、Windows PowerShell ISE 機能をオフまたは削除すると、Out-GridView コマンドレットもオフまたは削除されます。
リモート コマンドを使用して、別のコンピューター上でグリッド ビュー ウィンドウを開くことはできません。
Out-GridView に送信するコマンド出力は、Format-Table または Format-Wide コマンドレットを使用するなどして書式設定できません。 プロパティを選択するには、Select-Object コマンドレットを使用します。
リモート コマンドから逆シリアル化された出力をグリッド ビュー ウィンドウで適切に書式設定することはできません。
Out-GridView のキーボード ショートカット
次のショートカット キーを使用して、多くのタスクをすばやく実行できます。
次のキーを使用します。このアクションを実行するには:
TAB カーソルを [フィルター] ボックスから [抽出条件の追加] メニューに移動し、テーブルに戻ります。
↑1 行上に移動します。 列ヘッダーまで移動します。
↓1 行下に移動します。
←列ヘッダー行で、左に 1 列移動します。
→列ヘッダー行で、右に 1 列移動します。
コンテキスト メニュー キー 列ヘッダー行に[列の選択] オプションが表示されます。
Enter キーまたはスペース キー 列ヘッダー行で、列データを並べ替えます (A ～ Z、Z ～ A を切り替え) 。
グリッド ビュー ウィンドウの機能を使用する方法
次のトピックでは、 Out-GridView に表示されるウィンドウの機能を使用する方法について説明します。
列の非表示、表示、並べ替えの方法
列を非表示または表示するには、次の手順に従います。
任意の列ヘッダーを右クリックし、[列の選択] をクリックします。
2. [列の選択] ダイアログ ボックスで、方向キーを使用して、[選択した列] の間の列を [使用可能な列] ボックスに移動します。 [選択した列] ボックスの列のみがグリッド ビュー ウィンドウに表示されます。
列を並べ替えるには、次の手順に従います。
目的の場所に列をドラッグ アンド ドロップします。
または
任意の列ヘッダーを右クリックし、[列の選択] をクリックします。
2. [列の選択] ダイアログ ボックスで、[上へ移動] ボタンと [下へ移動] ボタンを使用して列の順序を変更します。 一覧の上部にある列は、グリッド ビュー ウィンドウで、一覧の下部の列の左側に表示されます。
テーブルのデータを並べ替える方法
データを並べ替えるには、列ヘッダーをクリックします。
並べ替え順序を変更するには、列ヘッダーをもう一度クリックします。 同じヘッダーをクリックするたびに、並べ替え順序が昇順と降順で切り替えられます。 現在の順序は、列ヘッダーにある三角形で示されます。
テーブルのデータを選択する方法
行を選択するには、行をクリックするか、上矢印または下矢印を使用して行に移動します。
(ヘッダー行を除く) すべての行を選択するには、Ctrl キーを押しながら A キーを押します。
連続する行を選択するには、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><演算子><の値>
さまざまなプロパティの条件を AND で接続します。 同じプロパティの条件は OR で接続します。 論理コネクタを変更することはできません。
条件は表示のみに影響します。 項目はテーブルから削除されません。
条件を追加する方法
1. [条件の追加] メニュー ボタンを表示するには、ウィンドウの右上隅にある [展開] 矢印をクリックします。
2. [条件の追加] メニュー ボタンをクリックします。
3. クリックして列 (プロパティ) を選択します。 1 つまたは複数のプロパティを選択することができます。
4. プロパティの選択が完了したら、[追加] ボタンをクリックします。
5. 追加を取り消すには、[キャンセル] をクリックします。
6. 条件を追加するには、もう一度 [条件の追加] ボタンをクリックします。
条件の編集方法
演算子を変更するには、青色の演算子値をクリックし、ドロップダウン リストから別の演算子をクリックして選択します。
値を入力または変更するには、値ボックスに値を入力します。 無効な値を入力した場合、円に X が付けられたアイコンが表示されます。 削除するには、値を変更します。
OR ステートメントを作成するには、同じプロパティを持つ条件を追加します。
条件を削除する方法
選択した条件を削除するには、各条件の横にある赤い X をクリックします。
すべての条件を削除するには、[すべてクリア] ボタンをクリックします。