Partager via

Get-MsolGroup

  • Référence
Module:
MSOnline

Obtient des groupes à partir d’Azure Active Directory.

Syntaxe

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 retourner un groupe unique, si vous spécifiez le paramètre ObjectId , ou pour effectuer une recherche 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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-GroupType

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

Type:GroupType
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-HasErrorsOnly

Indique que cette applet de commande retourne uniquement les groupes qui présentent des erreurs de validation.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-HasLicenseErrorsOnly

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

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:250
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ObjectId

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

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SearchString

Spécifie une chaîne. Cette applet de commande retourne des groupes de sécurité dont le nom d’affichage commence par cette chaîne.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-UserObjectId

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

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserPrincipalName

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

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 à extension messagerie uniquement).

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