Share via

Get-AzureADMSGroup

  • Référence
Module:
AzureADPreview

Obtient des informations sur les groupes dans Azure AD.

Syntax

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 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é AssignLabels 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 peut être récupérée uniquement par 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 peut être récupérée uniquement par paramètre Select.

Paramètres

-All

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

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

-Filter

Spécifie une chaîne de filtre oData v3.0 pour qu’elle corresponde à un ensemble de groupes.

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

-Id

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Select

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

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

-Top

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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. Bien qu’une applet de commande soit en préversion publique, nous pouvons apporter des modifications à l’applet de commande qui pourrait avoir des effets inattendus. Nous vous recommandons de ne pas utiliser cette applet de commande dans un environnement de production.