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 |
Required: | True |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | True |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
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.
Collegamenti correlati
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per