Partager via

Get-AzureADMSGroup

  • Référence
Module:
AzureADPreview

Obtient des informations sur les groupes dans Azure AD.

Syntaxe

Get-AzureADMSGroup
   [-All <Boolean>]
   [-Top <Int32>]
   [-Select <String>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADMSGroup
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADMSGroup
   -Id <String>
   [-All <Boolean>]
   [-Select <String>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzureADMSGroup obtient des informations sur les groupes dans Azure Active Directory (Azure AD). Pour obtenir un groupe, spécifiez le paramètre Id. Spécifiez le paramètre SearchString ou Filter pour rechercher des groupes particuliers. Si vous ne spécifiez aucun paramètre, cette applet de commande obtient tous les groupes.

Exemples

Exemple 1 : Obtenir tous les groupes

PS C:\> Get-AzureADMSGroup

Id                            : d539a25e-2db2-482a-9dcb-2a0b27fe4f27 
Description                   : 
OnPremisesSyncEnabled         : 
DisplayName                   : 
ADSyncOperators 
OnPremisesLastSyncDateTime    : 
Mail                          : 
MailEnabled                   : False
MailNickname                  : ADSyncOperators 
OnPremisesSecurityIdentifier  : S-1-5-21-2695029449-1154706203-1063139792-1243 
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {} 
MembershipRule                : 
MembershipRuleProcessingState :


Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b 
Description                   : 
OnPremisesSyncEnabled         : 
DisplayName                   : Project Icarus 
OnPremisesLastSyncDateTime    : 
Mail                          : 
MailEnabled                   : False 
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6 
OnPremisesSecurityIdentifier  : 
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {DynamicMembership} 
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece")) 
MembershipRuleProcessingState : On

Cette commande obtient tous les groupes dans Azure AD.

Exemple 2 : Obtenir un groupe spécifique à l’aide d’un ID

PS C:\> Get-AzureADMSGroup -Id "d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b"

Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b 
Description                   : 
OnPremisesSyncEnabled         : 
DisplayName                   : Project Icarus 
OnPremisesLastSyncDateTime    : 
Mail                          : 
MailEnabled                   : False 
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6 
OnPremisesSecurityIdentifier  : 
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {DynamicMembership} 
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece")) 
MembershipRuleProcessingState : On

Cette commande obtient des informations pour le groupe qui a l’ID spécifié.

Exemple 3 : Obtenir les valeurs de propriété AssignedLabels et DisplayName pour tous les groupes

PS C:\> Get-AzureADMSGroup -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 2

Cette commande obtient les valeurs de propriété AssignedLabels et DisplayName pour tous les groupes.

La propriété de groupe AssignedLabels ne peut être récupérée que par le paramètre Select.

Exemple 4 : Obtenir les valeurs de propriété AssignedLabels et DisplayName pour un groupe

PS C:\> Get-AzureADMSGroup -Id "11111111-1111-1111-1111-111111111111" -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

Cette commande obtient les valeurs de propriété AssignedLabels et DisplayName pour un groupe spécifique.

La propriété de groupe AssignedLabels ne peut être récupérée que par le paramètre Select.

Paramètres

-All

Si la valeur est true, retournez tous les groupes. Si la valeur est false, retourne le nombre d’objets spécifié par le paramètre Top

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

-Filter

Spécifie une chaîne de filtre oData v3.0 pour correspondre à un ensemble de groupes.

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

-Id

Spécifie l’ID du groupe que cette applet de commande obtient.

Type:String
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 de recherche. Cette applet de commande obtient des groupes qui ont des attributs DisplayName ou Description qui correspondent à la chaîne de recherche.

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

-Select

Spécifie une liste de propriétés de groupe à récupérer.

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

-Top

Spécifie le nombre maximal d’enregistrements que ce cmldet obtient. La valeur par défaut est 100.

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

Entrées

String

System.Nullable'1[[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Sorties

Object

Notes

Cette applet de commande est actuellement en préversion publique. Lorsqu’une applet de commande est en préversion publique, nous pouvons apporter des modifications à l’applet de commande qui peuvent avoir des effets inattendus. Nous vous recommandons de ne pas utiliser cette applet de commande dans un environnement de production.