Get-UnifiedGroup

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Get-UnifiedGroup per visualizzare Gruppi di Microsoft 365 nell'organizzazione basata su cloud. Per visualizzare i membri, i proprietari e gli abbonati per Gruppi di Microsoft 365, usare il cmdlet Get-UnifiedGroupLinks.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Identity (Impostazione predefinita) 

Get-UnifiedGroup
    [[-Identity] <UnifiedGroupIdParameter>]
    [-Filter <String>]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAllProperties]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
    [-IncludeSoftDeletedGroups]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

AnrSet 

Get-UnifiedGroup
    [-Anr <String>]
    [-Filter <String>]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAllProperties]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
    [-IncludeSoftDeletedGroups]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

Descrizione

I Gruppi di Microsoft 365 sono oggetti gruppo disponibili in tutti i servizi di Microsoft 365.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Get-UnifiedGroup

Questo esempio restituisce un elenco di riepilogo di tutti i Gruppi di Microsoft 365.

Esempio 2

Get-UnifiedGroup | Format-List DisplayName,EmailAddresses,Notes,ManagedBy,AccessType

Questo esempio restituisce le informazioni seguenti su tutti i Gruppi di Microsoft 365:

  • Nome distinto (DN)
  • Indirizzo di posta elettronica
  • Descrizione
  • Proprietari
  • Privacy

Esempio 3

Get-UnifiedGroup -Identity "Marketing Department" | Format-List

Questo esempio restituisce informazioni dettagliate sul gruppo di Microsoft 365 denominato Marketing Department.

Esempio 4

Get-UnifiedGroup | Where-Object {-Not $_.ManagedBy}

Questo esempio restituisce Gruppi di Microsoft 365 senza proprietario.

Esempio 5

Get-UnifiedGroup -Filter {ResourceProvisioningOptions -eq "Team"}

Questo esempio restituisce i Gruppi di Microsoft 365 creati quando viene creato un team Microsoft.

Parametri

-Anr

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AnrSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Filter

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro Filter utilizza la sintassi OPATH per filtrare i risultati in base alle proprietà e ai valori specificati. Il criterio di ricerca utilizza la sintassi "Property -ComparisonOperator 'Value'".

  • Racchiudere l'intero filtro OPATH tra virgolette doppie " ". Se il filtro contiene valori di sistema (ad esempio, $true, $false, o $null), usare invece le virgolette singole ' '. Anche se questo parametro è una stringa (non un blocco di sistema), puoi anche usare le parentesi graffe { }, ma solo se il filtro non contiene variabili.
  • La proprietà è una proprietà filtrabile. Per ulteriori informazioni sulle proprietà filtrabili in Exchange Server ed Exchange Online, vedere Proprietà filtrabili per il parametro Filter.
  • ComparisonOperator è un operatore di confronto OPATH (ad esempio -eq per gli uguali e -like per il confronto di stringhe). Per ulteriori informazioni sugli operatori di confronto, vedere about_Comparison_Operators.
  • Valore è il valore della proprietà da cercare. Racchiudere i valori di testo e le variabili tra virgolette singole ('Value' o '$Variable'). Se un valore di variabile contiene virgolette singole, sarà necessario identificarle (eseguire l'escape) per espandere correttamente la variabile. Ad esempio, al posto di '$User', usare '$($User -Replace "'","''")'. Non racchiudere interi o valori di sistema tra virgolette, ad esempio usare 500, $true, $false, o $null viceversa.

È possibile concatenare più criteri di ricerca usando gli operatori -and logici e -or. Ad esempio, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".

Per informazioni dettagliate sui filtri OPATH in Exchange, vedere Ulteriori informazioni sulla sintassi OPATH.

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

-Identity

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro Identity consente di specificare il gruppo di Microsoft 365 che si desidera visualizzare. È possibile usare qualsiasi valore che identifichi in modo univoco il gruppo di Microsoft 365. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Nome distinto canonico
  • GUID

Nota: è possibile usare il valore DisplayName per identificare il gruppo di Microsoft 365, ma non è garantito che i risultati siano univoci. Se è necessario restituire un risultato singolare e univoco, usare un identificatore univoco per il gruppo di Microsoft 365.

Attenzione: il valore $null o un valore inesistente per il parametro Identity restituisce tutti gli oggetti come se si eseguisse il comando Get- senza il parametro Identity. Verificare che tutti gli elenchi di valori per il parametro Identity siano accurati e non contengano valori $null inesistenti.

Proprietà dei parametri

Tipo:UnifiedGroupIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Identity
Posizione:1
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames specifica se restituire gli indirizzi SMTP e i nomi visualizzati dei destinatari AcceptMessagesOnlyFromSendersOrMembers nella proprietà AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames. Con questa opzione non è necessario specificare alcun valore.

Questa opzione è stata introdotta per ripristinare gli identificatori leggibili nei risultati del cmdlet. Se non si usa questa opzione, i destinatari AcceptMessagesOnlyFromSendersOrMembers vengono visualizzati come GUID e la proprietà AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames è vuota.

Proprietà dei parametri

Tipo:SwitchParameter
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

-IncludeAllProperties

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro IncludeAllProperties consente di specificare se includere i valori di tutte le proprietà nei risultati. Con questa opzione non è necessario specificare alcun valore.

Se non si usa questa opzione, i valori di alcune proprietà (ad esempio, CalendarMemberReadOnly, CalendarUrl, InboxUrl, PeopleUrl e PhotoUrl) potrebbero apparire vuoti.

Proprietà dei parametri

Tipo:SwitchParameter
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

-IncludeBypassModerationFromSendersOrMembersWithDisplayNames

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione IncludeBypassModerationFromSendersOrMembersWithDisplayNames specifica se restituire gli indirizzi SMTP e i nomi visualizzati dei destinatari BypassModerationFromSendersOrMembers nella proprietà BypassModerationFromSendersOrMembersWithDisplayNames. Con questa opzione non è necessario specificare alcun valore.

Questa opzione è stata introdotta per ripristinare gli identificatori leggibili nei risultati del cmdlet. Se non si usa questa opzione, i destinatari BypassModerationFromSendersOrMembers vengono visualizzati come GUID e la proprietà BypassModerationFromSendersOrMembersWithDisplayNames è vuota.

Proprietà dei parametri

Tipo:SwitchParameter
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

-IncludeGrantSendOnBehalfToWithDisplayNames

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione IncludeGrantSendOnBehalfToWithDisplayNames specifica se restituire gli indirizzi SMTP e i nomi visualizzati dei destinatari GrantSendOnBehalfTo nella proprietà GrantSendOnBehalfToWithDisplayNames. Con questa opzione non è necessario specificare alcun valore.

Questa opzione è stata introdotta per ripristinare gli identificatori leggibili nei risultati del cmdlet. Se non si usa questa opzione, i destinatari GrantSendOnBehalfTo vengono visualizzati come GUID e la proprietà GrantSendOnBehalfToWithDisplayNames è vuota.

Proprietà dei parametri

Tipo:SwitchParameter
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

-IncludeModeratedByWithDisplayNames

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione IncludeModeratedByWithDisplayNames specifica se restituire gli indirizzi SMTP e i nomi visualizzati dei destinatari ModeratedBy nella proprietà ModeratedByWithDisplayNames. Con questa opzione non è necessario specificare alcun valore.

Questa opzione è stata introdotta per ripristinare gli identificatori leggibili nei risultati del cmdlet. Se non si usa questa opzione, i destinatari ModeratedBy vengono visualizzati come GUID e la proprietà ModeratedByWithDisplayNames è vuota.

Proprietà dei parametri

Tipo:SwitchParameter
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

-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione IncludeRejectMessagesFromSendersOrMembersWithDisplayNames specifica se restituire gli indirizzi SMTP e i nomi visualizzati dei destinatari RejectMessagesFromSendersOrMembers nella proprietà RejectMessagesFromSendersOrMembersWithDisplayNames. Con questa opzione non è necessario specificare alcun valore.

Questa opzione è stata introdotta per ripristinare gli identificatori leggibili nei risultati del cmdlet. Se non si usa questa opzione, i destinatari ModeratedBy vengono visualizzati come GUID e la proprietà RejectMessagesFromSendersOrMembersWithDisplayNames è vuota.

Proprietà dei parametri

Tipo:SwitchParameter
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

-IncludeSoftDeletedGroups

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione IncludeSoftDeletedGroups specifica se includere i Gruppi di Microsoft 365 eliminati temporaneamente nei risultati. Con questa opzione non è necessario specificare alcun valore.

I Gruppi di Microsoft 365 eliminati temporaneamente sono gruppi eliminati che sono ancora ripristinabili.

Proprietà dei parametri

Tipo:SwitchParameter
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

-ResultSize

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le richieste che soddisfano la query, impostare questo parametro sul valore unlimited. Il valore predefinito è 1000.

Proprietà dei parametri

Tipo:Unlimited
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

-SortBy

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro SortBy consente di specificare la proprietà in base a cui ordinare i risultati. È possibile ordinare in base a una sola proprietà alla volta. I risultati vengono visualizzati in ordine crescente.

Se la visualizzazione predefinita non include la proprietà in base alla quale si sta eseguendo l'ordinamento, è possibile aggiungere al comando | Format-Table -Auto Property1,Property2,...PropertyX. per creare una nuova visualizzazione che contenga tutte le proprietà che si desidera visualizzare. I caratteri jolly (*) nei nomi di proprietà sono supportati.

È possibile eseguire l'ordinamento in base alle seguenti proprietà:

  • Nome
  • DisplayName
  • Alias

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

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.