Group-Object
Gruppiert Objekte, die den gleichen Wert für die angegebenen Eigenschaften enthalten.
Syntax
Group-Object
[-NoElement]
[-AsHashTable]
[-AsString]
[-InputObject <PSObject>]
[[-Property] <Object[]>]
[-Culture <String>]
[-CaseSensitive]
[<CommonParameters>]
Beschreibung
Das Group-Object
Cmdlet zeigt Objekte in Gruppen basierend auf dem Wert einer angegebenen Eigenschaft an.
Group-Object
gibt eine Tabelle mit einer Zeile für jeden Eigenschaftswert und eine Spalte zurück, die die Anzahl der Elemente mit diesem Wert anzeigt.
Wenn Sie mehrere Eigenschaften angeben, Group-Object
gruppiert sie zuerst nach den Werten der ersten Eigenschaft und dann innerhalb jeder Eigenschaftsgruppe nach dem Wert der nächsten Eigenschaft.
Ab PowerShell 7 können die Parameter CaseSensitive und AsHashtable kombiniert werden, um eine Hashtabelle zu erstellen, Group-Object
bei der die Groß-/Kleinschreibung beachtet wird. Die Hashtabellenschlüssel verwenden Vergleiche zwischen Groß- und Kleinschreibung und geben ein System.Collections.Hashtable-Objekt aus.
Beispiele
Beispiel 1: Gruppierung von Dateien nach Erweiterung
In diesem Beispiel werden die Dateien $PSHOME
unter rekursiv abgerufen und nach Dateinamenerweiterung gruppiert. Die Ausgabe wird an das Sort-Object
Cmdlet gesendet, das sie nach den Anzahldateien sortiert, die für die angegebene Erweiterung gefunden wurden. Der leere Name stellt Verzeichnisse dar.
In diesem Beispiel wird der NoElement-Parameter verwendet, um die Mitglieder der Gruppe wegzulassen.
$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
...
Beispiel 2: Gruppieren ganzer Zahlen nach Quoten und Geraden
In diesem Beispiel wird gezeigt, wie Skriptblöcke als Wert des Property-Parameters verwendet werden. Dieser Befehl zeigt die ganzen Zahlen von 1 bis 20 an, gruppiert nach Quoten und geraden.
1..20 | Group-Object -Property {$_ % 2}
Count Name Group
----- ---- -----
10 0 {2, 4, 6, 8...}
10 1 {1, 3, 5, 7...}
Beispiel 3: Gruppieren von Ereignisprotokollereignissen nach EntryType
In diesem Beispiel werden die 1.000 neuesten Einträge im Systemereignisprotokoll angezeigt, gruppiert nach EntryType.
In der Ausgabe stellt die Spalte Count die Anzahl der Einträge in jeder Gruppe dar. Die Spalte Name stellt die EventType-Werte dar, die eine Gruppe definieren. Die Spalte Group stellt die Objekte in jeder Gruppe dar.
Get-WinEvent -LogName System -MaxEvents 1000 | Group-Object -Property LevelDisplayName
Count Name Group
----- ---- -----
153 Error {System.Diagnostics.Eventing.Reader.EventLogRecord, System.Diagnostics...}
722 Information {System.Diagnostics.Eventing.Reader.EventLogRecord, System.Diagnostics...}
125 Warning {System.Diagnostics.Eventing.Reader.EventLogRecord, System.Diagnostics...}
Beispiel 4: Gruppierung von Prozessen nach Prioritätsklasse
In diesem Beispiel wird die Wirkung des NoElement-Parameters veranschaulicht. Diese Befehle gruppieren die Prozesse auf dem Computer nach Prioritätsklasse.
Der erste Befehl verwendet das Get-Process
Cmdlet, um die Prozesse auf dem Computer abzurufen und die Objekte in die Pipeline zu senden. Group-Object
gruppiert die Objekte nach dem Wert der PriorityClass-Eigenschaft des Prozesses.
Im zweiten Beispiel wird der NoElement-Parameter verwendet, um die Mitglieder der Gruppe aus der Ausgabe zu entfernen. Das Ergebnis ist eine Tabelle mit nur dem Wert der Count - und Name-Eigenschaft .
Die Ergebnisse werden in der folgenden Beispielausgabe gezeigt.
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
Beispiel 5: Gruppierung von Prozessen nach Name
Im folgenden Beispiel werden Group-Object
mehrere Instanzen von Prozessen gruppiert, die auf dem lokalen Computer ausgeführt werden. Where-Object
zeigt Prozesse mit mehr als einem instance an.
Get-Process | Group-Object -Property Name -NoElement | Where-Object {$_.Count -gt 1}
Count Name
----- ----
2 csrss
5 svchost
2 winlogon
2 wmiprvse
Beispiel 6: Gruppieren von Objekten in einer Hashtabelle
In diesem Beispiel werden die Parameter AsHashTable und AsString verwendet, um die Gruppen in einer Hashtabelle als Sammlung von Schlüssel-Wert-Paaren zurückzugeben.
In der resultierenden Hashtabelle ist jeder Eigenschaftswert ein Schlüssel und die Gruppenelemente sind die Werte. Da jeder Schlüssel eine Eigenschaft des Hashtabellenobjekts ist, können Sie die Werte mithilfe der punktierten Schreibweise anzeigen.
Der erste Befehl ruft die Get
Cmdlets und Set
in der Sitzung ab, gruppiert sie nach Verb, gibt die Gruppen als Hashtabelle zurück und speichert die Hashtabelle in der $A
Variablen.
Der zweite Befehl zeigt die Hashtabelle in $A
an. Es gibt zwei Schlüssel-Wert-Paare, eines für die Get
Cmdlets und eines für die Set
Cmdlets.
Der dritte Befehl verwendet die Punktnotation, $A.Get
um die Werte der Get-Taste in $A
anzuzeigen. Die Werte sind CmdletInfo-Objekt . Der AsString-Parameter konvertiert die Objekte in den Gruppen nicht in Zeichenfolgen.
$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 7.0.0.0 Microsoft.PowerShell.Security
Cmdlet Get-Alias 7.0.0.0 Microsoft.PowerShell.Utility
Cmdlet Get-AppLockerFileInformation 2.0.0.0 AppLocker
Cmdlet Get-AppLockerPolicy 2.0.0.0 AppLocker
...
Beispiel 7: Create einer Hashtabelle, bei der die Groß-/Kleinschreibung beachtet wird
In diesem Beispiel werden die Parameter CaseSensitive und AsHashTable kombiniert, um eine Hashtabelle mit Beachtung der Groß-/Kleinschreibung zu erstellen. Die Dateien im Beispiel verfügen über Erweiterungen von .txt
und .TXT
.
$hash = Get-ChildItem -Path C:\Files | Group-Object -Property Extension -CaseSensitive -AsHashTable
$hash
Name Value
---- -----
.TXT {C:\Files\File7.TXT, C:\Files\File8.TXT, C:\Files\File9.TXT}
.txt {C:\Files\file1.txt, C:\Files\file2.txt, C:\Files\file3.txt}
Die $hash
Variable speichert das System.Collections.Hashtable-Objekt . Get-ChildItem
ruft die Dateinamen aus dem C:\Files
Verzeichnis ab und sendet die System.IO.FileInfo-Objekte in der Pipeline. Group-Object
gruppiert die Objekte mithilfe des EigenschaftswertsExtension. Die Parameter CaseSensitive und AsHashTable erstellen die Hashtabelle, und die Schlüssel werden mithilfe der Schlüssel .txt
gruppiert, bei denen die Groß-/Kleinschreibung beachtet wird..TXT
Parameter
-AsHashTable
Gibt an, dass dieses Cmdlet die Gruppe als Hashtabelle zurückgibt. Die Schlüssel der Hashtabelle sind die Eigenschaftswerte, nach denen die Objekte gruppiert werden. Die Werte der Hashtabelle sind die Objekte, die diesen Eigenschaftswert aufweisen.
Der AsHashTable-Parameter selbst gibt jede Hashtabelle zurück, in der jeder Schlüssel ein instance des gruppierten Objekts ist. Bei Verwendung mit dem AsString-Parameter sind die Schlüssel in der Hashtabelle Zeichenfolgen.
Wenn Sie ab PowerShell 7 Hashtabellen erstellen möchten, die die Groß-/Kleinschreibung berücksichtigen, fügen Sie CaseSensitive und AsHashtable in Ihren Befehl ein.
Type: | SwitchParameter |
Aliases: | AHT |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsString
Gibt an, dass dieses Cmdlet die Hashtabellenschlüssel in Zeichenfolgen konvertiert. Standardmäßig sind die Schlüssel in der Hashtabelle Instanzen des gruppierten Objekts. Dieser Parameter ist nur gültig, wenn er mit dem Parameter AsHashTable verwendet wird.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CaseSensitive
Gibt an, dass dieses Cmdlet die Groß-/Kleinschreibung bei der Gruppierung beachtet. Ohne diesen Parameter können die Eigenschaftswerte von Objekten in einer Gruppe groß- oder kleingeschrieben sein.
Wenn Sie ab PowerShell 7 Hashtabellen erstellen möchten, die die Groß-/Kleinschreibung berücksichtigen, fügen Sie CaseSensitive und AsHashtable in Ihren Befehl ein.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Culture
Gibt die Kultur an, die beim Vergleichen von Zeichenfolgen verwendet werden soll.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Gibt die zu gruppierenden Objekte an. Geben Sie eine Variable ein, die die Objekte enthält, oder geben Sie einen Befehl oder einen Ausdruck ein, mit dem die Objekte abgerufen werden.
Wenn Sie den InputObject-Parameter verwenden, um eine Auflistung von -Objekten an zu Group-Object
übermitteln, Group-Object
empfängt ein -Objekt, das die Auflistung darstellt. Daher erstellt es eine einzelne Gruppe mit diesem Objekt als Member.
Um die -Objekte in einer Auflistung zu gruppieren, leiten Sie die -Objekte an weiter.Group-Object
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoElement
Gibt an, dass dieses Cmdlet die Mitglieder einer Gruppe aus den Ergebnissen auslässt.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Property
Gibt die Eigenschaften für die Gruppierung an. Die Objekte werden basierend auf dem Wert der angegebenen Eigenschaft in Gruppen angeordnet.
Der Wert des Property-Parameters kann eine neue berechnete Eigenschaft sein. Die berechnete Eigenschaft kann ein Skriptblock oder eine Hashtabelle sein. Gültige Schlüssel-Wert-Paare sind:
- Ausdruck –
<string>
oder<script block>
Weitere Informationen finden Sie unter about_Calculated_Properties.
Type: | Object[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Sie können jedes Objekt an übergeben Group-Object
.
Ausgaben
Microsoft.PowerShell.Commands.GroupInfo or System.Collections.Hashtable
Wenn Sie den AsHashTable-Parameter verwenden, Group-Object
wird ein Hashtable-Objekt zurückgegeben.
Andernfalls wird ein GroupInfo-Objekt zurückgegeben.
Hinweise
Sie können den GroupBy-Parameter der Formatierungs-Cmdlets wie Format-Table
und Format-List
verwenden, um Objekte zu gruppieren. Im Gegensatz zu Group-Object
, das eine einzelne Tabelle mit einer Zeile für jeden Eigenschaftswert erstellt, erstellen die GroupBy-Parameter eine Tabelle für jeden Eigenschaftswert mit einer Zeile für jedes Element, das über den Eigenschaftswert verfügt.
Group-Object
erfordert nicht, dass die objekte, die gruppiert werden, vom gleichen Microsoft .NET Core-Typ sind. Beim Gruppieren von Objekten unterschiedlicher .NET Core-Typen Group-Object
werden die folgenden Regeln verwendet:
Dieselben Eigenschaftsnamen und -typen.
Wenn die Objekte über eine Eigenschaft mit dem angegebenen Namen verfügen und die Eigenschaftswerte denselben .NET Core-Typ aufweisen, werden die Eigenschaftswerte mithilfe der gleichen Regeln gruppiert, die für Objekte desselben Typs verwendet werden.
Gleiche Eigenschaftennamen, unterschiedliche Typen.
Wenn die Objekte über eine Eigenschaft mit dem angegebenen Namen verfügen, die Eigenschaftenwerte jedoch einen anderen .NET Core-Typ in verschiedenen Objekten aufweisen,
Group-Object
verwendet der .NET Core-Typ des ersten Vorkommens der Eigenschaft als .NET Core-Typ für diese Eigenschaftengruppe. Wenn ein Objekt eine Eigenschaft mit einem anderen Typ aufweist, wird der Eigenschaftswert in den Typ für diese Gruppe konvertiert. Wenn bei der Typkonvertierung ein Fehler auftritt, ist das Objekt nicht in der Gruppe enthalten.Fehlende Eigenschaften.
Objekte ohne angegebene Eigenschaft können nicht gruppiert werden. Objekte, die nicht gruppiert sind, werden in der endgültigen Ausgabe des GroupInfo-Objekts in einer Gruppe namens
AutomationNull.Value
angezeigt.