次の方法で共有

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>]

説明

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: Out-GridView への Windows ショートカットを作成する

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にオブジェクト 送信します。

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

-OutputMode

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

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

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

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

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

-PassThru

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

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

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

型:SwitchParameter
配置:Named
規定値:None
必須: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 ウィンドウは、Windows PowerShell が閉じる直前にのみ表示されます。

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

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

入力

PSObject

このコマンドレットには任意のオブジェクトを送信できます。

出力

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 行下に移動します。

    LEFT ARROW 列ヘッダー行で、左に 1 列移動します。

    →列見出し行で、右 1 列に移動します。

    コンテキストメニューキー 列ヘッダー行に、[列の選択]オプションが表示されます。

    ENTER または SPACEBAR 列ヘッダー行で、列データを並べ替えます (A ~ Z、Z- A の切り替え)。

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

    次のトピックでは、 Out-GridView に表示されるウィンドウの機能の使用方法について説明します。

    列の非表示、表示、並べ替え方法

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

任意の列ヘッダーを右クリックし、[列の選択] をクリックします。

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

列を並べ替えるには:

  • 目的の場所に列をドラッグ アンド ドロップします。

  • 又は-

任意の列ヘッダーを右クリックし、[列の選択] をクリックします。

2. 「列を選択」ダイアログボックスで、「上へ移動」ボタンと「下へ移動」ボタンを使用して、列を並べ替えます。 リストの上部にある列は、グリッド ビュー ウィンドウのリストの下部にある列の左側に表示されます。

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

  • データを並べ替えるには、列ヘッダーをクリックします。

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

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

  • 行を選択するには、行をクリックするか、上下の矢印を使用して行に移動します。

  • すべての行 (ヘッダー行を除く) を選択するには、Ctrl キーを押しながら A キーを押します。

  • 連続する行を選択するには、Shift キーを押しながら行をクリックするか、方向キーを使用します。

  • 連続しない行を選択するには、Ctrl キーを押し、クリックして選択範囲に行を追加します。

列を選択することも、列ヘッダー行全体を選択することもできません。

行をコピーする方法

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

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

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

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

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

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

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

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

<列>:<テキスト> [<列>:<テキスト>] ...

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

displayname:net (英語)

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

displayname:net name:ネット

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

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

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

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

<列><演算子><値>

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

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

抽出条件を追加する方法

1. 「条件を追加」メニューボタンを表示するには、ウィンドウの右上隅にある「展開」矢印をクリックします。

2. 「条件を追加」メニューボタンをクリックします。

3. クリックして列 (プロパティ) を選択します。 1 つまたは複数のプロパティを選択できます。

4. プロパティの選択が完了したら、[追加] ボタンをクリックします。

5. 追加を取り消すには、[キャンセル] をクリックします。

6. 条件を追加するには、[条件の追加] ボタンをもう一度クリックします。

条件を編集する方法

  • 演算子を変更するには、青色の演算子の値をクリックし、ドロップダウンリストから別の演算子をクリックして選択します。

  • 値を入力または変更するには、値ボックスに値を入力します。 無効な値を入力すると、循環 X アイコンが表示されます。 削除するには、値を変更します。

  • OR ステートメントを作成するには、同じプロパティを持つ条件を追加します。

抽出条件を削除する方法

  • 選択した条件を削除するには、各条件の横にある赤い X をクリックします。

  • すべての条件を削除するには、[すべてクリア] ボタンをクリックします。