Condividi tramite

Group-Object

Modulo:
Microsoft.PowerShell.Utility Module

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

In questo esempio vengono recuperati in modo ricorsivo i file e $PSHOME 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 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.Diagnostics...}
  722 Information   {System.Diagnostics.Eventing.Reader.EventLogRecord, System.Diagnostics...}
  125 Warning       {System.Diagnostics.Eventing.Reader.EventLogRecord, System.Diagnostics...}

Esempio 4: 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.

Nel secondo esempio viene utilizzato il parametro NoElement per eliminare 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 5: 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 6: 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 7: 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 sono disposti in gruppi in base al valore della proprietà specificata.

Il valore del parametro Property può essere una nuova proprietà calcolata. La proprietà calcolata può essere un blocco di script o una tabella hash. Le coppie chiave-valore valide sono:

  • 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 reindirizzare qualsiasi oggetto a Group-Object.

Output

Microsoft.PowerShell.Commands.GroupInfo or System.Collections.Hashtable

Quando si utilizza il parametro AsHashTable , Group-Object restituisce un oggetto Hashtable . In caso contrario, restituisce un oggetto GroupInfo .

Note

È 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 di Microsoft .NET Core. Quando si raggruppano oggetti di diversi tipi di .NET Core, Group-Object vengono usate le regole seguenti:

  • Stessi nomi e tipi di proprietà.

    Se gli oggetti hanno una proprietà con il nome specificato e i valori delle proprietà hanno lo stesso tipo .NET Core, i valori delle proprietà vengono raggruppati usando le 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 delle proprietà hanno un tipo .NET Core diverso in oggetti diversi, Group-Object usa il tipo .NET Core della prima occorrenza della proprietà come tipo .NET Core 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.