Group-Object
Grupper objekt som innehåller samma värde för angivna egenskaper.
Syntax
Group-Object
[-NoElement]
[-AsHashTable]
[-AsString]
[-InputObject <PSObject>]
[[-Property] <Object[]>]
[-Culture <String>]
[-CaseSensitive]
[<CommonParameters>]
Description
Cmdleten Group-Object
visar objekt i grupper baserat på värdet för en angiven egenskap.
Group-Object
returnerar en tabell med en rad för varje egenskapsvärde och en kolumn som visar antalet objekt med det värdet.
Om du anger mer än en egenskap Group-Object
grupperar du dem först efter värdena för den första egenskapen och grupperar sedan efter värdet för nästa egenskap i varje egenskapsgrupp.
Exempel
Exempel 1: Gruppera filer efter tillägg
Det här exemplet hämtar rekursivt filerna under $PSHOME
och grupperar dem efter filnamnstillägg. Utdata skickas till cmdleten Sort-Object
, som sorterar dem efter antalet filer som hittas för det angivna tillägget. Det tomma namnet representerar kataloger.
I det här exemplet används parametern NoElement för att utelämna medlemmarna i gruppen.
$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
...
Exempel 2: Gruppera heltal efter odds och jämna
Det här exemplet visar hur du använder skriptblock som värde för parametern Egenskap . Det här kommandot visar heltalen från 1 till 20, grupperade efter odds och till och med.
1..20 | Group-Object -Property {$_ % 2}
Count Name Group
----- ---- -----
10 0 {2, 4, 6, 8...}
10 1 {1, 3, 5, 7...}
Exempel 3: Gruppera händelselogghändelser efter EntryType
I det här exemplet visas de 1 000 senaste posterna i systemhändelseloggen, grupperade efter EntryType.
I utdata representerar kolumnen Antal antalet poster i varje grupp. Kolumnen Namn representerar de EventType-värden som definierar en grupp. Kolumnen Grupp representerar objekten i varje grupp.
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...}
Exempel 4: Gruppera processer efter prioritetsklass
Det här exemplet visar effekten av parametern NoElement . Dessa kommandon grupperar processerna på datorn efter prioritetsklass.
Det första kommandot använder cmdleten Get-Process
för att hämta processerna på datorn och skickar objekten nedåt i pipelinen. Group-Object
grupperar objekten efter värdet för egenskapen PriorityClass för processen.
I det andra exemplet används parametern NoElement för att eliminera medlemmarna i gruppen från utdata. Resultatet är en tabell med endast egenskapsvärdet Antal och Namn .
Resultaten visas i följande exempelutdata.
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
Exempel 5: Gruppera processer efter namn
I följande exempel används Group-Object
för att gruppera flera instanser av processer som körs på den lokala datorn. Where-Object
visar processer med fler än en instans.
Get-Process | Group-Object -Property Name -NoElement | Where-Object {$_.Count -gt 1}
Count Name
----- ----
2 csrss
5 svchost
2 winlogon
2 wmiprvse
Exempel 6: Gruppera objekt i en hash-tabell
I det här exemplet används parametrarna AsHashTable och AsString för att returnera grupperna i en hash-tabell som en samling nyckel/värde-par.
I den resulterande hash-tabellen är varje egenskapsvärde en nyckel och gruppelementen är värdena. Eftersom varje nyckel är en egenskap för hash-tabellobjektet kan du använda punktnotation för att visa värdena.
Det första kommandot hämtar Get
cmdletarna och Set
i sessionen, grupperar dem efter verb, returnerar grupperna som en hash-tabell och sparar hash-tabellen i variabeln $A
.
Det andra kommandot visar hash-tabellen i $A
. Det finns två nyckel/värde-par, ett för Get
cmdletarna och ett för Set
cmdletarna.
Det tredje kommandot använder punktnotation $A.Get
för att visa värdena för hämta-nyckeln i $A
. Värdena är CmdletInfo-objekt . Parametern AsString konverterar inte objekten i grupperna till strängar.
$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 6.1.0.0 Microsoft.PowerShell.Security
Cmdlet Get-Alias 6.1.0.0 Microsoft.PowerShell.Utility
Cmdlet Get-AuthenticodeSignature 6.1.0.0 Microsoft.PowerShell.Security
Cmdlet Get-ChildItem 6.1.0.0 Microsoft.PowerShell.Management
...
Parametrar
-AsHashTable
Anger att denna cmdlet returnerar gruppen som en hash-tabell. Nycklarna i hash-tabellen är de egenskapsvärden som objekten grupperas efter. Värdena i hash-tabellen är de objekt som har det egenskapsvärdet.
I sig själv returnerar parametern AsHashTable varje hash-tabell där varje nyckel är en instans av det grupperade objektet. När de används med parametern AsString är nycklarna i hash-tabellen strängar.
Type: | SwitchParameter |
Aliases: | AHT |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsString
Anger att denna cmdlet konverterar hashtabellnycklarna till strängar. Som standard är hashtabellnycklarna instanser av det grupperade objektet. Den här parametern är endast giltig när den används med parametern AsHashTable .
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CaseSensitive
Anger att denna cmdlet gör gruppering skiftlägeskänslig. Utan den här parametern kan egenskapsvärdena för objekt i en grupp ha olika fall.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Culture
Anger vilken kultur som ska användas när strängar jämförs.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Anger vilka objekt som ska grupperas. Ange en variabel som innehåller objekten eller skriv ett kommando eller uttryck som hämtar objekten.
När du använder parametern InputObject för att skicka en samling objekt till Group-Object
tar Group-Object
emot ett objekt som representerar samlingen. Därför skapas en enda grupp med objektet som medlem.
Om du vill gruppera objekten i en samling, skicka objekten till Group-Object
.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoElement
Anger att denna cmdlet utelämnar medlemmarna i en grupp från resultaten.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Property
Anger egenskaperna för gruppering. Objekten ordnas i grupper baserat på värdet för den angivna egenskapen.
Värdet för parametern Egenskap kan vara en ny beräknad egenskap. Den beräknade egenskapen kan vara ett skriptblock eller en hash-tabell. Giltiga nyckel/värde-par är:
- Uttryck –
<string>
eller<script block>
Mer information finns i about_Calculated_Properties.
Type: | Object[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
Du kan skicka valfritt objekt till Group-Object
.
Utdata
Microsoft.PowerShell.Commands.GroupInfo or System.Collections.Hashtable
När du använder parametern Group-Object
AsHashTable returnerar ett Hashtable-objekt.
Annars returneras ett GroupInfo-objekt .
Kommentarer
Du kan använda groupby-parametern för formaterings-cmdletar, till exempel Format-Table
och Format-List
, för att gruppera objekt. Till skillnad från Group-Object
, som skapar en enskild tabell med en rad för varje egenskapsvärde, skapar GroupBy-parametrarna en tabell för varje egenskapsvärde med en rad för varje objekt som har egenskapsvärdet.
Group-Object
kräver inte att objekten som grupperas är av samma Microsoft .NET Core-typ. När du grupperar objekt av olika .NET Core-typer Group-Object
använder följande regler:
Samma egenskapsnamn och typer.
Om objekten har en egenskap med det angivna namnet och egenskapsvärdena har samma .NET Core-typ grupperas egenskapsvärdena med samma regler som används för objekt av samma typ.
Samma egenskapsnamn, olika typer.
Om objekten har en egenskap med det angivna namnet, men egenskapsvärdena har en annan .NET Core-typ i olika objekt,
Group-Object
använder .NET Core-typen för den första förekomsten av egenskapen som .NET Core-typ för den egenskapsgruppen. När ett objekt har en egenskap med en annan typ konverteras egenskapsvärdet till typen för den gruppen. Om typkonverteringen misslyckas inkluderas inte objektet i gruppen.Egenskaper saknas.
Objekt som inte har en angiven egenskap kan inte grupperas. Objekt som inte är grupperade visas i de slutliga GroupInfo-objektutdata i en grupp med namnet
AutomationNull.Value
.