Partager via

New-AzureADMSGroup

  • Référence
Module:
AzureAD

Crée un groupe Azure AD.

Syntaxe

New-AzureADMSGroup
   [-Description <String>]
   -DisplayName <String>
   [-IsAssignableToRole <Boolean>]
   -MailEnabled <Boolean>
   -MailNickname <String>
   -SecurityEnabled <Boolean>
   [-GroupTypes <System.Collections.Generic.List`1[System.String]>]
   [-Visibility <String>]
   [<CommonParameters>]

Description

L’applet de commande New-AzureADMSGroup crée un groupe Azure Active Directory (Azure AD).

Exemples

Exemple : Créer un groupe assignable à un rôle

PS C:\> New-AzureADMSGroup -DisplayName "HelpDesk admin group" -Description "Group assignable to role" -MailEnabled $False -MailNickname "helpDeskAdminGroup" -SecurityEnabled $True -IsAssignableToRole $True -Visibility "Private"

Id                            : 1026185e-25df-4522-a380-7ab697a7241c
Description                   : Group assignable to role
OnPremisesSyncEnabled         : 
DisplayName                   : HelpDesk admin group
Mail                          : 
MailEnabled                   : False
IsAssignableToRole            : True 
MailNickname                  : helpDeskAdminGroup
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {}

Paramètres

-Description

Spécifie une description pour le groupe.

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

-DisplayName

Spécifie un nom d’affichage pour le groupe.

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

-GroupTypes

Spécifie que le groupe est un groupe unifié ou dynamique.

Remarques :

  • Actuellement, ce paramètre ne peut pas être utilisé pour créer des groupes dynamiques. Pour créer un groupe dynamique dans PowerShell, vous devez utiliser le module Azure AD Preview.
Type:List<T>[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

-IsAssignableToRole

Indique si le groupe peut être affecté à un rôle. Cette propriété ne peut être définie qu’au moment de la création du groupe et ne peut pas être modifiée sur un groupe existant.

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

-MailEnabled

Indique si ce groupe est activé pour la messagerie.

Actuellement, vous ne pouvez pas créer de groupes à extension messagerie dans Azure AD.

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

-MailNickname

Spécifie un surnom de messagerie pour le groupe. Si MailEnabled est $False vous devez toujours spécifier un surnom de courrier.

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

-SecurityEnabled

Indique si la sécurité du groupe est activée. Pour les groupes de sécurité, cette valeur doit être $True.

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

-Visibility

Spécifie la visibilité du contenu et de la liste des membres du groupe. Ce paramètre peut prendre l’une des valeurs suivantes :

  • « Public » : tout le monde peut afficher le contenu du groupe
  • « Privé » : seuls les membres peuvent afficher le contenu du groupe
  • « HiddenMembership » : seuls les membres peuvent afficher le contenu du groupe et seuls les membres, les propriétaires, l’administrateur général/d’entreprise, l’administrateur utilisateur et les administrateurs du support technique peuvent afficher la liste des membres du groupe.

Si aucune valeur n’est fournie, la valeur par défaut est « Public ».

Remarques :

  • Ce paramètre est valide uniquement pour les groupes dont le groupType est défini sur « Unified ».
  • Si un groupe a cet attribut défini sur « HiddenMembership », il ne peut pas être modifié ultérieurement.
  • Tout le monde peut rejoindre un groupe dont l’attribut est défini sur « Public ». Si l’attribut est défini sur Private ou HiddenMembership, seuls les propriétaires peuvent ajouter de nouveaux membres au groupe et les demandes de rejoindre le groupe nécessitent l’approbation du ou des propriétaires.
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

Entrées

None

Sorties

Object

Notes

Consultez le guide de migration de New-AzureADMSGroup vers Microsoft Graph PowerShell.

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.