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 Core または Windows Nano Server では機能しません。
テーブルの次の機能を使用して、データを確認することができます。
- 列の非表示、表示、並べ替え
- 行の並べ替え
- クイック フィルター
- 条件フィルターを追加する
- コピーと貼り付け
詳細な手順については、この記事の 「メモ 」セクションを参照してください。
例
例 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-GridViewGet-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-GridViewInvoke-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.csvPassThru パラメーターを使用すると、複数のOut-GridView項目をパイプラインに送信できます。 PassThru パラメーターは、OutputMode パラメーターの Multiple 値を使用することと同じです。
例 8: 'Out-GridView' への Windows ショートカットを作成する
この例では、Wait パラメーターOut-GridViewを使用してウィンドウへの Windows ショートカットを作成する方法をOut-GridView示します。
pwsh -Command "Get-Service | Out-GridView -Wait"このコマンド ラインは、Windows ショートカットで使用できます。 Wait パラメーターを指定しない場合、PowerShell はウィンドウがOut-GridView開くとすぐに終了し、ウィンドウはほぼ即座に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] をクリックします。
このパラメーターの値が、パイプラインに送信できるアイテムの数を決定します。
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-GridViewPowerShell が閉じる直前にウィンドウが表示されます。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
任意のオブジェクトをこのコマンドレットにパイプできます。
出力
None
既定では、このコマンドレットは出力を返しません。
PassThru パラメーターを使用すると、このコマンドレットは選択した行を表すオブジェクトを返します。
メモ
Windows PowerShell には、次のエイリアスが Out-GridView含まれています。
ogv
リモート コマンドを使用して、別のコンピューター上でグリッド ビュー ウィンドウを開くことはできません。
送信Out-GridViewするコマンド出力は、コマンドレット (コマンドレットFormat-WideなどFormat-Table) をFormat使用して書式設定することはできません。 プロパティを選択するには、コマンドレットを Select-Object 使用します。
リモート コマンドから逆シリアル化された出力をグリッド ビュー ウィンドウで適切に書式設定することはできません。
のキーボード ショートカットOut-GridView
| 次のキーを使用します。 | このアクションを実行するには: |
|---|---|
| タブ | [フィルター] ボックスから [条件の追加] メニューにカーソルを移動し、テーブルに戻ります。 |
| UpArrow | 1 行上に移動します。 データの最初の行から列ヘッダーに移動します。 |
| DownArrow | 1 行下へ移動します。 |
| LeftArrow | 列ヘッダー行で、左に 1 列移動します。 |
| RightArrow | 列ヘッダー行で、1 列右に移動します。 |
| ContextMenuKey | 列ヘッダー行に、[列の選択] オプションが表示されます。 |
| Enter キーまたは Space キー | 列ヘッダー行で、列データを並べ替えます (A から Z、Z-A の切り替え)。 |
グリッド ビュー ウィンドウの機能を使用する方法
列を非表示または表示するには:
- 任意の列ヘッダーを右クリックし、[列の選択] をクリックします。
- [列の選択] ダイアログ ボックスで、方向キーを使用して、[選択した列] の間の列を [使用可能な列] ボックスに移動します。 [列の選択] ボックスの列のみがグリッド ビュー ウィンドウに表示されます。
列を並べ替えるには:
目的の場所に列をドラッグ アンド ドロップできます。 または、次の手順を使用します。
- 任意の列ヘッダーを右クリックし、[列の選択] をクリックします。
- [列の選択] ダイアログ ボックスで、[上へ移動] ボタンと [下へ移動] ボタンを使用して列の順序を変更します。 一覧の上部にある列は、グリッド ビュー ウィンドウで、一覧の下部の列の左側に表示されます。
テーブル データを並べ替える方法
- データを並べ替えるには、列ヘッダーをクリックします。
- 並べ替え順序を変更するには、列ヘッダーをもう一度クリックします。 同じヘッダーをクリックするたびに、並べ替え順序が昇順と降順で切り替えられます。 現在の順序は、列ヘッダーにある三角形で示されます。
テーブル データを選択する方法
- 行を選択するには、行を選択するか、上下の矢印を使用して行に移動します。
- すべての行 (ヘッダー行を除く) を選択するには、Ctrl A キーを押します。+
- 連続する行を選択するには、Shift キーを押しながら行をクリックするか、方向キーを使用します。
- 連続しない行を選択するには、Ctrl キーを押し、クリックして選択範囲に行を追加します。
- 列を選択することや、列ヘッダー行全体を選択することはできません。
行をコピーする方法
テーブルから 1 つ以上の行をコピーするには、行を選択し、Ctrl キーを押しながら C キーを押します。
任意のテキストやスプレッドシート プログラムにデータを貼り付けることができます。 列や行の一部をコピーすることはできません。また、列ヘッダー行をコピーすることはできません。
テーブルで検索する方法 (クイック フィルター)
[フィルター] ボックスを使用して、テーブル内のデータを検索します。 ボックスに入力すると、指定したテキストを含む項目のみがテーブルに表示されます。
テキストを検索します。 テーブル内のテキストを検索するには、[フィルター] ボックスに検索するテキストを入力します。
複数の単語を検索します。 テーブル内の複数の単語を検索するには、単語をスペースで区切って入力します。
Out-GridViewには、すべての単語を含む行が表示されます (論理 AND)。リテラル フレーズを検索します。 スペースや特殊文字を含む語句を検索するには、語句を引用符で囲みます。
Out-GridViewには、語句と完全に一致する行が表示されます。列を検索します。 1 列以上でテキストを検索するには、次の形式を使用します。
<column>:<text> [<column>:<text>] ...たとえば、DisplayName 列で "Net" を検索するには、[フィルター] ボックスに次のように入力します。
displayname:netDisplayName 列と Name 列で "Net" の行を検索するには、[フィルター] ボックスに次のように入力します。
displayname:net name:net検索をオフにします。 テーブル全体をもう一度表示するには、[フィルター] ボックスの右上隅にある赤い [X] ボタンをクリックするか、[フィルター] ボックスからテキストを削除します。
抽出条件を使用してテーブルをフィルター処理する
ルールまたは条件を使用して、テーブルに表示される項目を決定できます。 項目は、設定したすべての条件を満たす場合にのみ表示されます。 使用可能な基準は、グリッド ビュー ウィンドウに表示されるオブジェクトのプロパティと、これらのプロパティの .NET Framework の型によって決まります。
各条件は、次の形式で指定します。
<column> <operator> <value>
さまざまなプロパティの条件は AND によって接続されます。 同じプロパティの条件は OR によって接続されます。 論理コネクタを変更することはできません。
条件は表示のみに影響します。 項目はテーブルから削除されません。
抽出条件を追加する方法
- [条件の追加] メニュー ボタンを表示するには、ウィンドウの右上隅にある [展開] 矢印をクリックします。
- [条件の追加] メニュー ボタンをクリックします。
- 列 (プロパティ) をクリックして選択します。 1 つまたは複数のプロパティを選択することができます。
- プロパティの選択が完了したら、[追加] ボタンをクリックします。
- 追加を取り消すには、[キャンセル] をクリックします。
- 条件をさらに追加するには、[条件の追加] ボタンをもう一度クリックします。
条件を編集する方法
- 演算子を変更するには、青色の演算子値をクリックし、ドロップダウン リストから別の演算子を選択します。
- 値を入力または変更するには、値ボックスに値を入力します。 無効な値を入力した場合、円に X が付けられたアイコンが表示されます。 削除するには、値を変更します。
- OR ステートメントを作成するには、同じプロパティを持つ条件を追加します。
抽出条件を削除する方法
- 選択した条件を削除するには、各条件の横にある赤い X をクリックします。
- すべての条件を削除するには、[すべてクリア] ボタンをクリックします。
関連リンク
PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示