New-EntraGroup
Crée un groupe Microsoft Entra ID.
Syntaxe
Default (Par défaut)
New-EntraGroup
-DisplayName <String>
[-GroupTypes <System.Collections.Generic.List`1[System.String]>]
-SecurityEnabled <Boolean>
[-Description <String>]
-MailEnabled <Boolean>
-MailNickname <String>
[-Visibility <String>]
[-IsAssignableToRole <Boolean>]
[<CommonParameters>]
Description
L’applet New-EntraGroup de commande crée un groupe Microsoft Entra ID. Spécifiez les paramètres et DisplayName les MailNicknameMailEnabledSecurityEnabled paramètres de création d’un groupe Microsoft Entra ID.
Pour plus d’informations sur la création de groupes dynamiques, consultez : Utilisation d’attributs pour créer des règles avancées.
Remarques sur les autorisations :
- Pour créer le groupe avec des utilisateurs en tant que propriétaires ou membres, l’application doit disposer au moins de l’autorisation
User.Read.All. - Pour créer le groupe avec d’autres principaux de service en tant que propriétaires ou membres, l’application doit disposer au moins de l’autorisation
Application.Read.All. - Pour créer le groupe avec des utilisateurs ou des principaux de service en tant que propriétaires ou membres, l’application doit disposer au moins de l’autorisation
Directory.Read.All.
Exemples
Exemple 1 : Créer un groupe
Connect-Entra -Scopes 'Group.ReadWrite.All','Group.Create'
$params = @{
DisplayName = 'HelpDesk admin group2'
MailEnabled = $False
MailNickname = 'helpDeskAdminGroup'
SecurityEnabled = $True
}
New-EntraGroup @params
DisplayName Id MailNickname Description GroupTypes
----------- -- ------------ ----------- ----------
HelpDesk admin group2 bbbbbbbb-5555-5555-0000-qqqqqqqqqqqq helpDeskAdminGroup {}
Cet exemple montre comment créer le nouveau groupe.
Exemple 2 : Créer un groupe avec le paramètre Description
Connect-Entra -Scopes 'Group.ReadWrite.All','Group.Create'
$params = @{
DisplayName = 'HelpDesk admin group'
MailEnabled = $false
MailNickname = 'helpDeskAdminGroup'
SecurityEnabled = $true
Description = 'Group assignable to role'
}
New-EntraGroup @params
DisplayName Id MailNickname Description GroupTypes
----------- -- ------------ ----------- ----------
HelpDesk admin group zzzzzzzz-6666-8888-9999-pppppppppppp helpDeskAdminGroup Group assignable to role {}
Cet exemple montre comment créer le nouveau groupe avec le paramètre de description.
Exemple 3 : Créer un groupe avec le paramètre IsAssignableToRole
Connect-Entra -Scopes 'Group.ReadWrite.All','Group.Create'
$params = @{
DisplayName = 'HelpDesk admin group2'
Description = 'Group assignable to role'
MailEnabled = $False
MailNickname = 'helpDeskAdminGroup'
SecurityEnabled = $True
IsAssignableToRole = $True
}
New-EntraGroup @params
DisplayName Id MailNickname Description GroupTypes
----------- -- ------------ ----------- ----------
HelpDesk admin group2 vvvvvvvv-8888-9999-0000-jjjjjjjjjjjj helpDeskAdminGroup Group assignable to role {}
Cet exemple montre comment créer le nouveau groupe avec le paramètre IsAssignableToRole.
Exemple 4 : Créer un groupe avec le paramètre Visibility
Connect-Entra -Scopes 'Group.ReadWrite.All','Group.Create'
$params = @{
DisplayName = 'HelpDesk admin group2'
Description = 'Group assignable to role'
MailEnabled = $False
MailNickname = 'helpDeskAdminGroup'
SecurityEnabled = $True
Visibility = 'Private'
}
New-EntraGroup @params
DisplayName Id MailNickname Description GroupTypes
----------- -- ------------ ----------- ----------
HelpDesk admin group2 gggggggg-0000-4444-3333-llllllllllll helpDeskAdminGroup Group assignable to role {}
Cet exemple montre comment créer le nouveau groupe avec le paramètre Visibility.
Exemple 5 : Créer un groupe avec le paramètre GroupTypes
Connect-Entra -Scopes 'Group.ReadWrite.All','Group.Create'
$params = @{
DisplayName = 'HelpDesk admin group3'
Description = 'group des'
MailEnabled = $False
MailNickname = 'helpDeskAdminGroup1'
SecurityEnabled = $True
GroupTypes = 'Unified'
}
New-EntraGroup @params
DisplayName Id MailNickname Description GroupTypes
----------- -- ------------ ----------- ----------
HelpDesk admin group3 xxxxxxxx-8888-5555-9999-bbbbbbbbbbbb helpDeskAdminGroup1 group des {Unified}
Cet exemple montre comment créer le nouveau groupe avec le paramètre GroupTypes.
Paramètres
-Description
Spécifie une description pour le groupe.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DisplayName
Spécifie un nom complet pour le groupe.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-GroupTypes
Spécifie que le groupe est un groupe unifié ou dynamique.
Notes:
- Ce paramètre ne peut actuellement pas être utilisé pour créer des groupes dynamiques. Pour créer un groupe dynamique dans PowerShell, vous devez utiliser le module Entra.
Propriétés du paramètre
| Type: | System.Collections.Generic.List`1[System.String] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | System.Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MailEnabled
Spécifie si ce groupe est activé pour la messagerie.
Actuellement, vous ne pouvez pas créer de groupes avec messagerie dans Microsoft Entra ID.
Propriétés du paramètre
| Type: | System.Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MailNickname
Spécifie un surnom de messagerie pour le groupe. Si MailEnabled est $False, vous devez toujours spécifier un surnom de courrier.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SecurityEnabled
Spécifie si la sécurité du groupe est activée. Pour les groupes de sécurité, cette valeur doit être $True.
Propriétés du paramètre
| Type: | System.Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Visibility
Ce paramètre détermine 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/l’administrateur d’entreprise, les administrateurs d’utilisateurs 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 ».
Notes:
- Ce paramètre est valide uniquement pour les groupes dont le groupType a la valeur « Unified ».
- Si un groupe a cet attribut défini sur « HiddenMembership », il ne peut pas être modifié ultérieurement.
- Tout le monde peut joindre 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 demander à rejoindre le groupe ont besoin d’approbation des propriétaires.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.