Get-MsolGroup

  • Référence
Module:
MSOnline

Obtient des groupes à partir d’Azure Active Directory.

Syntax

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>]

Description

L’applet de commande Get-MsolGroup obtient des groupes à partir d’Azure Active Directory. Cette applet de commande peut être utilisée pour renvoyer un seul groupe, si vous spécifiez le paramètre ObjectId ou pour rechercher dans tous les groupes.

Exemples

Exemple 1 : Obtenir un groupe à l’aide d’un ID

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

Cette commande retourne l’objet de groupe qui a l’ID spécifié.

Exemple 2 : Obtenir tous les groupes

PS C:\> Get-MsolGroup

Cette commande retourne l’ensemble des groupes pour le locataire, jusqu’aux 250 résultats par défaut.

Exemple 3 : Obtenir un groupe à l’aide d’un nom d’utilisateur principal

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

Cette commande renvoie les groupes d'agents dont un utilisateur est membre. Cela s'applique uniquement aux sociétés qui disposent de privilèges de partenaires.

Paramètres

-All

Indique que cette applet de commande retourne tous les résultats qu’elle trouve. Ne spécifiez pas ce paramètre et le paramètre MaxResults .

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

-GroupType

Spécifie le type de groupes à obtenir. Les valeurs valides sont Security, MailEnabledSecurity et DistributionList.

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

-HasErrorsOnly

Indique que cette applet de commande retourne uniquement des groupes qui ont des erreurs de validation.

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

-HasLicenseErrorsOnly

Spécifie si cette applet de commande retourne uniquement des groupes de sécurité qui ont des erreurs de licence.

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

-IsAgentRole

Spécifie que cette applet de commande retourne uniquement les groupes d’agents. Cette valeur s’applique uniquement aux utilisateurs partenaires.

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

-MaxResults

Spécifie le nombre maximal de résultats retournés par cette applet de commande. La valeur par défaut est 250.

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

-ObjectId

Spécifie l’ID d’objet unique du groupe à obtenir.

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

-SearchString

Spécifie une chaîne. Cette applet de commande retourne des groupes de sécurité qui ont un nom complet qui commence par cette chaîne.

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

-TenantId

Spécifie l’ID unique du locataire sur lequel effectuer l’opération. La valeur par défaut est le locataire de l’utilisateur actuel. Ce paramètre s’applique uniquement aux utilisateurs partenaires.

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

-UserObjectId

Spécifie l’ID unique d’un utilisateur. Cette applet de commande retourne des groupes de sécurité auxquels appartient cet utilisateur. Ce paramètre doit être utilisé avec le paramètre IsAgentRole .

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

-UserPrincipalName

Spécifie le nom d’utilisateur principal d’un utilisateur. Cette applet de commande retourne des groupes de sécurité auxquels appartient cet utilisateur. Ce paramètre doit être utilisé avec le paramètre IsAgentRole .

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

Sorties

Microsoft.Online.Administration.Group

Cette applet de commande retourne une liste de groupes, qui incluent les informations suivantes :

  • CommonName. nom commun du groupe.

  • Description. description du groupe.

  • Displayname. nom complet du groupe.

  • Emailaddress. adresses de messagerie du groupe. Cet élément n'est pas renvoyé pour les groupes de sécurité.

  • Erreurs. liste des erreurs concernant le groupe.

  • GroupType. type du groupe. Les types peuvent être SecurityGroup, DistributionList ou MailEnabledSecurityGroup.

  • IsSystem. Indique si ce groupe est un groupe système (créé par Azure Active Directory). Ces groupes ne peuvent pas être mis à jour ou supprimés.

  • LastDirSyncTime. date et heure de la dernière synchronisation du groupe.

  • ManagedBy. propriétaire du groupe.

  • Objectid. ID d'objet unique du groupe.

  • Adresses proxy. Adresses proxy associées à ce groupe (pour les groupes activés par courrier uniquement).

  • ValidationStatus. indique si des erreurs sont liées au groupe.