Group-Object
Raggruppa gli oggetti che contengono lo stesso valore per le proprietà specificate.
Sintassi
HashTable
Group-Object
[[-Property] <Object[]>]
[-NoElement]
[-AsHashTable]
[-AsString]
[-InputObject <PSObject>]
[-Culture <String>]
[-CaseSensitive]
[<CommonParameters>]
Descrizione
Il cmdlet Group-Object visualizza gli oggetti in gruppi in base al valore di una proprietà specificata.
Group-Object restituisce una tabella con una riga per ogni valore della proprietà e una colonna che visualizza il numero di elementi con tale valore.
Se si specificano più proprietà, Group-Object prima raggrupparle in base ai valori della prima proprietà e quindi, all'interno di ogni gruppo di proprietà, raggruppa in base al valore della proprietà successiva.
A partire da PowerShell 7, Group-Object può combinare i parametri CaseSensitive e AsHashtable per creare una tabella hash con distinzione tra maiuscole e minuscole. Le chiavi della tabella hash usano confronti con distinzione tra maiuscole e minuscole e generano un oggetto System.Collections.Hashtable .
Esempio
Esempio 1: Raggruppare i file per estensione
Questo esempio ottiene in modo ricorsivo i file in $PSHOME e li raggruppa in base all'estensione del nome file. L'output viene inviato al cmdlet Sort-Object, che li ordina in base ai file di conteggio trovati per l'estensione specificata. Il nome vuoto rappresenta le directory.
In questo esempio viene utilizzato il parametro NoElement per omettere i membri del gruppo.
$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
...
Esempio 2: Raggruppare numeri interi per probabilità e pari
In questo esempio viene illustrato come usare i blocchi di script come valore del parametro proprietà. Questo comando visualizza i numeri interi da 1 a 20, raggruppati per probabilità e anche.
1..20 | Group-Object -Property {$_ % 2}
Count Name Group
----- ---- -----
10 0 {2, 4, 6, 8...}
10 1 {1, 3, 5, 7...}
Esempio 3: Raggruppare tabelle hash in base al valore della chiave
A partire da PowerShell 6, Group-Object supporta l'ordinamento dell'input della tabella hash in base ai valori chiave.
Nell'esempio seguente viene raggruppata una matrice di tabelle hash in base al valore della chiave di weight ogni tabella hash.
In questo esempio viene utilizzato il parametro NoElement per omettere i membri del gruppo.
@(
@{ name = 'a' ; weight = 7 }
@{ name = 'b' ; weight = 1 }
@{ name = 'c' ; weight = 3 }
@{ name = 'd' ; weight = 7 }
) | Group-Object -Property weight -NoElement
Count Name
----- ----
1 1
1 3
2 7
Esempio 4: Raggruppare gli eventi del registro eventi per EntryType
In questo esempio vengono visualizzate le 1.000 voci più recenti nel registro eventi di sistema, raggruppate per EntryType.
Nell'output la colonna Count rappresenta il numero di voci in ogni gruppo. La colonna Nome rappresenta i valori EventType che definiscono un gruppo. La colonna group rappresenta gli oggetti in ogni gruppo.
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...}
Esempio 5: Raggruppare i processi per classe di priorità
In questo esempio viene illustrato l'effetto del parametro NoElement. Questi comandi raggruppano i processi nel computer in base alla classe priority.
Il primo comando usa il cmdlet Get-Process per ottenere i processi nel computer e invia gli oggetti nella pipeline.
Group-Objectraggruppa gli oggetti in base al valore della proprietà PriorityClass del processo.
Il secondo esempio usa il parametro NoElement per rimuovere i membri del gruppo dall'output. Il risultato è una tabella con solo il valore della proprietà Count e Name.
I risultati sono visualizzati nell'output di esempio seguente.
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
Esempio 6: Raggruppare i processi in base al nome
L'esempio seguente usa Group-Object per raggruppare più istanze di processi in esecuzione nel computer locale.
Where-Object visualizza i processi con più di un'istanza.
Get-Process | Group-Object -Property Name -NoElement | Where-Object {$_.Count -gt 1}
Count Name
----- ----
2 csrss
5 svchost
2 winlogon
2 wmiprvse
Esempio 7: Raggruppare oggetti in una tabella hash
In questo esempio vengono usati i parametri AsHashTable e AsString per restituire i gruppi in una tabella hash, come raccolta di coppie chiave-valore.
Nella tabella hash risultante, ogni valore della proprietà è una chiave e gli elementi del gruppo sono i valori. Poiché ogni chiave è una proprietà dell'oggetto tabella hash, è possibile usare la notazione punto per visualizzare i valori.
Il primo comando ottiene i cmdlet Get e Set nella sessione, li raggruppa per verbo, restituisce i gruppi come tabella hash e salva la tabella hash nella variabile $A.
Il secondo comando visualizza la tabella hash in $A. Esistono due coppie chiave-valore, una per i cmdlet Get e una per i cmdlet Set.
Il terzo comando usa la notazione punto, $A.Get per visualizzare i valori della chiave get in $A. I valori sono 'oggetto CmdletInfo. Il parametro AsString non converte gli oggetti nei gruppi in stringhe.
$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
...
Esempio 8: Creare una tabella hash con distinzione tra maiuscole e minuscole
In questo esempio vengono combinati i parametri CaseSensitive e AsHashTable per creare una tabella hash con distinzione tra maiuscole e minuscole. I file nell'esempio hanno estensioni di .txt e .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}
La $hash variabile archivia l'oggetto System.Collections.Hashtable .
Get-ChildItem ottiene i nomi di file dalla C:\Files directory e invia gli oggetti System.IO.FileInfo nella pipeline.
Group-Objectraggruppa gli oggetti usando l'estensione del valore della proprietà. I parametri CaseSensitive e AsHashTable creano la tabella hash e le chiavi vengono raggruppate usando le chiavi .txt con distinzione tra maiuscole e minuscole e .TXT.
Parametri
-AsHashTable
Indica che questo cmdlet restituisce il gruppo come tabella hash. Le chiavi della tabella hash sono i valori delle proprietà in base ai quali gli oggetti sono raggruppati. I valori della tabella hash sono gli oggetti con tale valore della proprietà.
Da solo, il parametro AsHashTable restituisce ogni tabella hash in cui ogni chiave è un'istanza dell'oggetto raggruppato. Se usato con il parametro AsString, le chiavi nella tabella hash sono stringhe.
A partire da PowerShell 7, per creare tabelle hash con distinzione tra maiuscole e minuscole, includere CaseSensitive e AsHashtable nel comando.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | AHT |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AsString
Indica che questo cmdlet converte le chiavi della tabella hash in stringhe. Per impostazione predefinita, le chiavi della tabella hash sono istanze dell'oggetto raggruppato. Questo parametro è valido solo se usato con il parametro AsHashTable.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-CaseSensitive
Indica che questo cmdlet fa distinzione tra maiuscole e minuscole per il raggruppamento. Senza questo parametro, i valori delle proprietà degli oggetti in un gruppo potrebbero avere casi diversi.
A partire da PowerShell 7, per creare tabelle hash con distinzione tra maiuscole e minuscole, includere CaseSensitive e AsHashtable nel comando.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Culture
Specifica le impostazioni cultura da utilizzare durante il confronto delle stringhe.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-InputObject
Specifica gli oggetti da raggruppare. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti .
Quando si utilizza il parametro InputObject per inviare una raccolta di oggetti a Group-Object, Group-Object riceve un oggetto che rappresenta l'insieme. Di conseguenza, crea un singolo gruppo con tale oggetto come membro.
Per raggruppare gli oggetti in un insieme, inviare tramite pipe gli oggetti a Group-Object.
Proprietà dei parametri
| Tipo: | PSObject |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-NoElement
Indica che questo cmdlet omette i membri di un gruppo dai risultati.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Property
Specifica le proprietà per il raggruppamento. Gli oggetti vengono disposti in gruppi denominati in base al valore delle proprietà specificate. Quando non viene specificata alcuna proprietà, gli oggetti vengono raggruppati in base al valore o alla rappresentazione ToString() del relativo valore. L'output viene ordinato in ordine crescente in base ai nomi dei gruppi.
Il valore del parametro Property
- Espressione -
<string>o<script block>
Per altre informazioni, vedere about_Calculated_Properties.
Proprietà dei parametri
| Tipo: | Object[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
PSObject
È possibile passare qualsiasi oggetto come input a questo cmdlet.
Output
GroupInfo
Per impostazione predefinita, questo cmdlet restituisce un oggetto GroupInfo.
Hashtable
Quando si usa il parametro AsHashTable, questo cmdlet restituisce un oggetto hashtable.
Note
PowerShell include gli alias seguenti per Group-Object:
- Tutte le piattaforme:
group
È possibile usare il parametro GroupBy dei cmdlet di formattazione, ad esempio Format-Table e Format-List, per raggruppare gli oggetti. A differenza di Group-Object, che crea una singola tabella con una riga per ogni valore della proprietà, i parametri GroupBy creano una tabella per ogni valore della proprietà con una riga per ogni elemento con il valore della proprietà .
Group-Object non richiede che gli oggetti raggruppati siano dello stesso tipo Microsoft .NET.
Quando si raggruppano oggetti di tipi .NET diversi, Group-Object usa le regole seguenti:
Stessi nomi e tipi di proprietà.
Se gli oggetti hanno una proprietà con il nome specificato e i valori della proprietà hanno lo stesso tipo .NET, i valori delle proprietà vengono raggruppati in base alle stesse regole che verrebbero usate per gli oggetti dello stesso tipo.
Stessi nomi di proprietà, tipi diversi.
Se gli oggetti hanno una proprietà con il nome specificato, ma i valori della proprietà hanno un tipo .NET diverso in oggetti diversi,
Group-Objectusa il tipo .NET della prima occorrenza della proprietà come tipo .NET per tale gruppo di proprietà. Quando un oggetto ha una proprietà con un tipo diverso, il valore della proprietà viene convertito nel tipo per tale gruppo. Se la conversione del tipo non riesce, l'oggetto non è incluso nel gruppo.Proprietà mancanti.
Gli oggetti che non dispongono di una proprietà specificata non possono essere raggruppati. Gli oggetti non raggruppati vengono visualizzati nell'output finale oggetto GroupInfo in un gruppo denominato
AutomationNull.Value.
L'output viene ordinato in ordine crescente in base ai nomi dei gruppi. Gli elementi appartenenti a ogni gruppo non sono ordinati. Sono elencati nell'ordine in cui sono stati ricevuti.
