Get-MsolGroup

Ottiene gruppi da Azure Active Directory.

Sintassi

Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-MsolGroup ottiene gruppi da Azure Active Directory. Questo cmdlet può essere usato per restituire un singolo gruppo, se si specifica il parametro ObjectId o per eseguire la ricerca all'interno di tutti i gruppi.

Esempio

Esempio 1: Ottenere un gruppo usando un ID

PS C:\> Get-MsolGroup -ObjectId af407072-7ae1-4b07-a0ca-6634b7396054

Questo comando restituisce l'oggetto gruppo con l'ID specificato.

Esempio 2: Ottenere tutti i gruppi

PS C:\> Get-MsolGroup

Questo comando restituisce l'intero set di gruppi per il tenant, fino ai 250 risultati predefiniti.

Esempio 3: Ottenere un gruppo usando un nome dell'entità utente

PS C:\> Get-MsolGroup -isAgentRole -UserPrincipalName "pattifuller@contoso.com"

Questo comando restituisce i gruppi di agenti di cui è membro un utente. Si applica solo alle società con privilegi di partner.

Parametri

-All

Indica che questo cmdlet restituisce tutti i risultati trovati. Non specificare questo parametro e il parametro MaxResults .

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-GroupType

Specifica il tipo di gruppi da ottenere. I valori validi sono Security, MailEnabledSecurity e DistributionList.

Type:GroupType
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-HasErrorsOnly

Indica che questo cmdlet restituisce solo i gruppi con errori di convalida.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-HasLicenseErrorsOnly

Specifica se questo cmdlet restituisce solo gruppi di sicurezza con errori di licenza.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IsAgentRole

Specifica che questo cmdlet restituisce solo gruppi di agenti. Questo valore si applica solo agli utenti partner.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaxResults

Specifica il numero massimo di risultati restituiti da questo cmdlet. Il valore predefinito è 250.

Type:Int32
Position:Named
Default value:250
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Specifica l'ID oggetto univoco del gruppo da ottenere.

Type:Guid
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

Specifica una stringa. Questo cmdlet restituisce gruppi di sicurezza con un nome visualizzato che inizia con questa stringa.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

Specifica l'ID univoco del tenant in cui eseguire l'operazione. Il valore predefinito è il tenant dell'utente corrente. Questo parametro si applica solo agli utenti partner.

Type:Guid
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-UserObjectId

Specifica l'ID univoco di un utente. Questo cmdlet restituisce gruppi di sicurezza a cui appartiene l'utente. Questo parametro deve essere usato insieme al parametro IsAgentRole .

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UserPrincipalName

Specifica il nome dell'entità utente di un utente. Questo cmdlet restituisce gruppi di sicurezza a cui appartiene l'utente. Questo parametro deve essere usato insieme al parametro IsAgentRole .

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Output

Microsoft.Online.Administration.Group

Questo cmdlet restituisce un elenco di gruppi, che includono le informazioni seguenti:

  • Commonname. il nome comune del gruppo.

  • Descrizione una descrizione del gruppo.

  • Displayname. il nome visualizzato del gruppo.

  • Emailaddress. gli indirizzi e-mail del gruppo. Non viene restituito per i gruppi di sicurezza.

  • Errori. un elenco di errori per il gruppo.

  • GroupType. il tipo di gruppo. I tipi possono essere SecurityGroup, DistributionList o MailEnabledSecurityGroup.

  • IsSystem. Indica se questo gruppo è un gruppo di sistema (creato da Azure Active Directory). Questi gruppi non possono essere aggiornati o rimossi.

  • LastDirSyncTime. la data e ora dell'ultima sincronizzazione del gruppo.

  • Managedby. il proprietario del gruppo.

  • Objectid. l'ID oggetto univoco del gruppo.

  • Indirizzi proxy. Gli indirizzi proxy associati a questo gruppo (solo per i gruppi abilitati alla posta elettronica).

  • ValidationStatus. l'indicazione dell'eventuale presenza di errori associati al gruppo.