Get-UnifiedGroup

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Online, Exchange Online Protection

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Get-UnifiedGroup per visualizzare Gruppi di Microsoft 365 nell'organizzazione basata sul cloud. Per visualizzare membri, proprietari e sottoscrittori 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

Get-UnifiedGroup
   [[-Identity] <UnifiedGroupIdParameter>]
   [-Filter <String>]
   [-IncludeAllProperties]
   [-IncludeSoftDeletedGroups]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]
Get-UnifiedGroup
   [-Anr <String>]
   [-Filter <String>]
   [-IncludeAllProperties]
   [-IncludeSoftDeletedGroups]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]

Descrizione

Gruppi di Microsoft 365 sono oggetti gruppo disponibili nei servizi Microsoft 365.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano 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

In questo esempio viene restituito un elenco di riepilogo di tutti i Gruppi di Microsoft 365.

Esempio 2

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

In questo esempio vengono restituite le informazioni seguenti su tutte le Gruppi di Microsoft 365:

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

Esempio 3

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

In questo esempio vengono restituite informazioni dettagliate sul gruppo Microsoft 365 denominato Marketing Department.

Esempio 4

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

Questo esempio restituisce Gruppi di Microsoft 365 che non hanno un proprietario.

Esempio 5

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

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

Parametri

-Anr

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Filter

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

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

È 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 Informazioni aggiuntive sulla sintassi OPATH.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

Il parametro Identity consente di specificare il Microsoft gruppo 365 che si desidera visualizzare. È possibile usare qualsiasi valore che identifichi in modo univoco il gruppo 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 Microsoft 365, ma i risultati non sono garantiti come univoci. Se è necessario restituire un risultato univoco e univoco, usare un identificatore univoco per il gruppo Microsoft 365.

Type:UnifiedGroupIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IncludeAllProperties

L'opzione IncludeAllProperties specifica 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 essere vuoti.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IncludeSoftDeletedGroups

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ResultSize

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.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-SortBy

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à per cui si esegue l'ordinamento, è possibile accodare il comando con | Format-Table -Auto Property1,Property2,...PropertyX. per creare una nuova visualizzazione che contiene 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
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection