Group-Object
包含相同指定属性的值的组对象。
语法
Group-Object
[-NoElement]
[-AsHashTable]
[-AsString]
[-InputObject <PSObject>]
[[-Property] <Object[]>]
[-Culture <String>]
[-CaseSensitive]
[<CommonParameters>]说明
Group-Object cmdlet 可根据指定属性的值按组显示对象。
Group-Object 将返回一个表，其中每个属性值对应一行，同时一个列显示具有该值的项数。
如果指定多个属性，则 Group-Object 先按第一个属性的值对其进行分组，然后在每个属性组中，按下一属性的值进行分组。
示例
示例 1：按扩展名对文件进行分组
此示例以递归方式获取 $PSHOME 下的文件，并按文件扩展名对其进行分组。 输出将发送到 Sort-Object cmdlet，该 cmdlet 按为给定扩展名找到的计数文件对其进行排序。 空 Name 表示目录。
此示例使用 NoElement 参数省略组的成员。
$files = Get-ChildItem -Path $PSHOME -Recurse
$files |
Group-Object -Property extension -NoElement |
Sort-Object -Property Count -Descending
Count Name
----- ----
365 .xml
231 .cdxml
197
169 .ps1xml
142 .txt
114 .psd1
63 .psm1
49 .xsd
36 .dll
15 .mfl
15 .mof
...示例 2：按奇数和偶数对整数进行分组
此示例显示了如何将脚本块用作 Property 参数的值。 此命令显示从 1 到 20 的整数，按奇数和偶数进行分组。
1..20 | Group-Object -Property {$_ % 2}
Count Name Group
----- ---- -----
10 0 {2, 4, 6, 8...}
10 1 {1, 3, 5, 7...}示例 3：按 EntryType 对事件日志事件进行分组
本示例显示系统事件日志中的 1,000 个最新条目，按 EntryType 进行分组。
在输出中，Count 列表示每个组中的条目数。 Name 列表示定义组的 EventType 值。 Group 列表示每个组中的对象。
Get-WinEvent -LogName System -MaxEvents 1000 | Group-Object -Property LevelDisplayName
Count Name Group
----- ---- -----
153 Error {System.Diagnostics.Eventing.Reader.EventLogRecord, System.Diag...}
722 Information {System.Diagnostics.Eventing.Reader.EventLogRecord, System.Diag...}
125 Warning {System.Diagnostics.Eventing.Reader.EventLogRecord, System.Diag...}示例 4：按优先级类对进程进行分组
此示例演示了 NoElement 参数的效果。 这些命令按优先级对计算机上的进程进行分组。
第一个命令使用 Get-Process cmdlet 获取计算机上的进程，并沿着管道发送对象。 Group-Object 按进程的 PriorityClass 属性的值对对象进行分组。
第二个示例使用 NoElement 参数从输出中删除组的成员。 结果是仅具有 Count 和 Name 属性值的表。
结果显示在下面的示例输出中。
Get-Process | Group-Object -Property PriorityClass
Count Name Group
----- ---- -----
55 Normal {System.Diagnostics.Process (AdtAgent), System.Diagnosti...
1 {System.Diagnostics.Process (Idle)}
3 High {System.Diagnostics.Process (Newproc), System.Diagnostic...
2 BelowNormal {System.Diagnostics.Process (winperf),
Get-Process | Group-Object -Property PriorityClass -NoElement
Count Name
----- ----
55 Normal
1
3 High
2 BelowNormal示例 5：按名称对进程进行分组
以下示例使用 Group-Object 对本地计算机上运行的多个进程实例进行分组。 Where-Object 显示包含多个实例的进程。
Get-Process | Group-Object -Property Name -NoElement | Where-Object {$_.Count -gt 1}
Count Name
----- ----
2 csrss
5 svchost
2 winlogon
2 wmiprvse示例 6：对哈希表中的对象进行分组
此示例使用 AsHashTable 和 AsString 参数将哈希表中的组作为键值对的集合返回。
在生成的哈希表中，每个属性值都是一个键，组元素是值。 因为每个键都是哈希表对象的一个属性，所以你可以使用点表示法来显示这些值。
第一个命令将获取会话中的 Get 和 Set cmdlet、按谓词对其进行分组、以哈希表形式返回这些组，并将该哈希表保存在 $A 变量中。
第二个命令将显示 $A 中的哈希表。 有两个键值对，一个对应 Get cmdlet，一个对应 Set cmdlet。
第三个命令使用点表示法 $A.Get 来显示 $A 中的 Get 键的值。 这些值是 CmdletInfo 对象。 AsString 参数不会将组中的对象转换为字符串。
$A = Get-Command Get-*, Set-* -CommandType cmdlet |
Group-Object -Property Verb -AsHashTable -AsString
$A
Name Value
---- -----
Get {Get-Acl, Get-Alias, Get-AppLockerFileInformation, Get-AppLockerPolicy...}
Set {Set-Acl, Set-Alias, Set-AppBackgroundTaskResourcePolicy, Set-AppLockerPolicy...}
$A.Get
CommandType Name Version Source
----------- ---- ------- ------
Cmdlet Get-Acl 3.0.0.0 Microsoft.PowerShell.Security
Cmdlet Get-Alias 3.1.0.0 Microsoft.PowerShell.Utility
Cmdlet Get-AppLockerFileInformation 2.0.0.0 AppLocker
Cmdlet Get-AppLockerPolicy 2.0.0.0 AppLocker
...示例 10：使用计算属性按键值对哈希表进行分组
此示例演示如何按键的值对 hashtable 对象进行分组。 可以为 Property 参数指定一个或多个脚本块。 这些脚本块中的表达式用于对输入（例如命名属性的值）进行分组。
@(
@{ name = 'a' ; weight = 7 }
@{ name = 'b' ; weight = 1 }
@{ name = 'c' ; weight = 3 }
@{ name = 'd' ; weight = 7 }
) | Group-Object -Property { $_.weight } -NoElement
Count Name
----- ----
2 7
1 1
1 3参数
-AsHashTable
指示此 cmdlet 将组作为哈希表返回。 哈希表的键是作为对象分组依据的属性值。 哈希表的值是具有该属性值的对象。
AsHashTable 参数返回每个哈希表，其中每个键都是分组对象的实例。 与 AsString 参数一起使用时，哈希表中的键是字符串。
| 类型: | SwitchParameter |
| 别名: | AHT |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AsString
指示此 cmdlet 将哈希表键转换为字符串。 默认情况下，哈希表键是分组对象的实例。 此参数仅在与 AsHashTable 参数一起使用时才有效。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CaseSensitive
指示此 cmdlet 使分组区分大小写。 在没有此参数的情况下，组中对象的属性值可能有不同的大小写。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Culture
指定要在比较字符串时使用的区域性。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-InputObject
指定要分组的对象。 输入一个包含对象的变量，或键入可获取对象的命令或表达式。
使用 InputObject 参数将对象集合提交到 Group-Object 时，Group-Object 会收到一个表示集合的对象。 因此，它将创建一个组并将该对象用作其成员。
若要对集合中的对象进行分组，请通过管道将对象传递给 Group-Object。
| 类型: | PSObject |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-NoElement
指示此 cmdlet 从结果中省略组的成员。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Property
指定用于分组的属性。 这些对象将根据指定属性的值排列成命名组。 如果未指定任何属性，则对象按其值或其值的 ToString() 表示形式进行分组。 输出按创建组对象的顺序显示。
Property 参数的值可以是新的计算属性。 计算属性可以是脚本块或哈希表。 有效的键值对包括：
- Expression -
<string>或<script block>
有关详细信息，请参阅 about_Calculated_Properties。
| 类型: | Object[] |
| Position: | 0 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
你可以通过管道将任何对象传递给此 cmdlet。
输出
默认情况下，此 cmdlet 会返回一个 GroupInfo 对象。
使用 AsHashTable 参数时，此 cmdlet 将返回 Hashtable 对象。
备注
Windows PowerShell 包含 Group-Object 的以下别名：
group
可以使用格式设置 cmdlet（如 Format-Table 和 Format-List）的 GroupBy 参数对对象进行分组。 与 Group-Object（用于创建单个表，其中每个属性值对应一行）不同，GroupBy 参数为每个属性值创建一个表，其中具有该属性值的每个项对应一行。
Group-Object 不要求要分组的对象类型属于同一 Microsoft .NET 类型。
对不同 .NET 类型的对象进行分组时，Group-Object 将使用以下规则：
相同的属性名称和类型。
如果对象具有带指定名称的属性，并且属性值具有相同的 .NET 类型，则通过相同类型的对象适用的规则对属性值进行分组。
相同的属性名称，不同类型。
如果对象具有带指定名称的属性，但属性值在不同的对象中具有不同的 .NET 类型，则
Group-Object会将该属性第一次出现时的 .NET 类型用作该属性组的 .NET 类型。 当对象具有不同类型的属性时，会将属性值转换为该组的类型。 如果类型转换失败，该对象不会包含在组中。缺少属性。
不能对没有指定属性的对象进行分组。 未分组的对象将显示在名为
AutomationNull.Value的组中的最终 GroupInfo 对象输出中。
输出组按创建组的顺序显示。 属于每个组的项不进行排序。 它们按接收顺序列出。
