Group-Object

Group-Object [-AsHashTable] [-AsString] [[-Property] <Object[]>] [-CaseSensitive] [-Culture <string>] [-InputObject <psobject>] [-NoElement] [<CommonParameters>]

C:\PS>get-childitem *.doc | group-object -property length

説明
-----------
このコマンドは、現在の場所にあるファイルの中で .doc 拡張子を持つファイルを取得し、そのサイズに基づいてグループ化します。

C:\PS>get-childitem | sort-object -property extension | group-object -property extension

説明
-----------
このコマンドは、現在の場所にあるファイルを取得し、ファイル名拡張子ごとに並べ替えてグループ化します。ファイルは、グループ化される前に並べ替えられます。

C:\PS>1..35 | group-object -property {$_ % 2},{$_ % 3}

説明
-----------
この例は、スクリプト ブロックを Property パラメーターの値として使用する方法を示しています。

このコマンドは、1 ～ 35 の整数を 2 または 3 で除算した場合の剰余に基づいてグループ化して表示します。

C:\PS>$events = get-eventlog -logname system -newest 1000 

C:\PS> $events | group-object -property eventID 

Count Name                      Group
----- ----                      -----
   44 Information               {System.Diagnostics.EventLogEntry,
    5 Error                     {System.Diagnostics.EventLogEntry,
    1 Warning                   {System.Diagnostics.EventLogEntry}

説明
-----------
これらのコマンドは、システム イベント ログの最新の 1,000 エントリを EventID に基づいてグループ化して表示します。

最初のコマンドは、Get-EventLog コマンドレットを使用してイベントを取得し、代入演算子 (=) を使用して $events 変数に保存します。

2 番目のコマンドは、パイプライン演算子 (|) を使用して、$events 変数に保存されているイベントを Group-Object コマンドレットに送ります。また、Property パラメーターを使用して、EventID プロパティの値に基づいてイベントをグループ化するように指定します。

出力の Count 列は各グループのエントリの数、Name 列はグループを定義する EventID 値、および Group 列は各グループ内のオブジェクトを表します。

C:\PS>get-process | group-object -property priorityclass

Count Name                Group
----- ----                -----
   55 Normal              {System.Diagnostics.Process (AdtAgent), System.Diagnostics.Process (alg), System.Dia...
    1                     {System.Diagnostics.Process (Idle)}
    3 High                {System.Diagnostics.Process (Newproc), System.Diagnostics.Process (winlogon), System.D... 
    2 BelowNormal         {System.Diagnostics.Process (winperf),  


C:\PS>get-process | group-object -property company -noelement
Count Name
----- ----
   55 Normal
    1
    3 High
    2 BelowNormal

説明
-----------
この例で、NoElement パラメーターの結果を説明します。これらのコマンドは、コンピューター上のプロセスを優先度クラスごとにグループ化します。

最初のコマンドは、Get-Process コマンドレットを使用してコンピューター上のプロセスを取得します。また、パイプライン演算子 (|) を使用して結果を Group-Object に送ります。このコマンドレットは、プロセスの PriorityClass プロパティの値に基づいてオブジェクトをグループ化します。

2 番目のコマンドは最初のコマンドと同じですが、NoElement パラメーターを使用して出力からグループのメンバーを取り除く点が異なります。結果は数とプロパティ値の名前のみを含む表です。

次のサンプル出力に結果を示します。

C:\PS>get-eventlog -logname system -newest 1000 | group-object -property {$_.TimeWritten - $_.TimeGenerated}

説明
-----------
このコマンドは、スクリプト ブロックとして Property パラメーターの値を指定する方法を示しています。

このコマンドは、システム イベント ログの最新の 1,000 エントリを、生成されてからログに書き込まれるまでの時間に基づいてグループ化し、表示します。

このコマンドは、Get-EventLog コマンドレットを使用して、イベント ログ エントリを取得します。また、パイプライン演算子 (|) を使用して、エントリを Group-Object コマンドレットに送信します。Property パラメーターの値は、スクリプト ブロック (かっこ内の式) として指定されています。スクリプト ブロックの評価結果は、ログ エントリが生成されてからログに書き込まれるまでの時間になります。その値を使用して、最新のイベント 1000 個がグループ化されます。

C:\PS>get-childitem | group-object extension -noelement 

Count Name
----- ----
   21
   82 .txt
    9 .cmd
    5 .log
   12 .xml
    5 .htm
   36 .ps1
    1 .psc1
    3 .exe
    6 .csv
    1 .psd1
    2 .bat

説明
-----------
このコマンドは、現在のディレクトリにある項目をファイル名拡張子に基づいてグループ化します。NoElement パラメーターを使用してグループのメンバーを除外します。

次のサンプル出力に結果を示します。

C:\PS>"a", "b", "c", "c", "d" | get-unique

a
b
c
d

C:\PS> "a", "b", "c", "c", "d" | group-object -noelement | where {$_.Count -gt 1}
Count Name
----- ----
    2 c

C:\PS> get-process | group-object -property Name -noelement | where {$_.count -gt 1}
Count Name
----- ----
    2 csrss
    5 svchost
    2 winlogon
    2 wmiprvse

説明
-----------
この例は、コレクション内の一意のプロパティまたは一意でないプロパティ (繰り返しプロパティ) の値を調べる方法を示しています。

最初のコマンドは、Get-Unique コマンドレットに対して配列をパイプ処理して、配列の一意の要素を取得します。

2 番目のコマンドは配列の一意でない要素を取得します。また、Group-Object コマンドレットに対して配列をパイプ処理します。このコマンドレットは、値に基づいてオブジェクトをグループ化します。作成されたグループは、Where-Object コマンドレットに対してパイプ処理されます。このコマンドレットは、複数のメンバーを持つグループでオブジェクトを選択します。

3 番目のコマンドはこの方法を実際に使用した例を示しています。同じメソッドを使用して、プロセス名が同じコンピューター上でプロセスを調べます。

次のサンプル出力に結果を示します。

C:\PS>$a = get-command get-*, set-* -type cmdlet | group-object -property verb -ashashtable -asstring

C:\PS> $a 

Name    Value
----    -----
Get     {Get-PSCallStack, Get-PSBreakpoint, Get-PSDrive, Get-PSSession...}
Set     {Set-Service, Set-StrictMode, Set-PSDebug, Set-PSSessionConfiguration...}

C:\PS> $a.get

CommandType     Name                 Definition
-----------     ----                 ----------
Cmdlet          Get-PSCallStack      Get-PSCallStack [-Verbose] [-Debug] [-ErrorAction <ActionPrefer...
Cmdlet          Get-PSBreakpoint     Get-PSBreakpoint [[-Id] <Int32[]>] [-Verbose] [-Debug] [-ErrorA...
Cmdlet          Get-PSDrive          Get-PSDrive [[-Name] <String[]>] [-Scope <String>] [-PSProvider...
...

説明
-----------
この例では、AsHashTable パラメーターと AsString パラメーターを使用して、グループをハッシュ テーブルで、つまりキーと値のペアのコレクションとして返します。

結果のハッシュ テーブルでは、各プロパティ値がキーで、グループ要素が値です。各キーがハッシュ テーブル オブジェクトのプロパティであるため、ドット表記を使用して値を表示できます。

最初のコマンドは、セッション内の Get コマンドレットと Set コマンドレットを取得し、動詞に基づいてグループ化し、グループをハッシュ テーブルとして返し、$a 変数に保存します。

2 番目のコマンドは、$a 変数に保存されたハッシュ テーブルを表示します。Get コマンドレットと Set コマンドレットの 2 つのキーと値のペアが存在します。

3 番目のコマンドは、ドット表記を使用して、$a に保存された Get キーの値を表示します。値は CmdletInfo オブジェクトです。AsString パラメーターはグループ内のオブジェクトを文字列に変換しません。