Partager via


New-AzADGroup

Ajoute une nouvelle entité aux groupes

Syntaxe

Default (Par défaut)

New-AzADGroup
    -DisplayName <String>
    -MailNickname <String>
    [-AcceptedSender <IMicrosoftGraphDirectoryObject[]>]
    [-AdditionalProperties <Hashtable>]
    [-AppRoleAssignment <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>]
    [-Classification <String>]
    [-CreatedOnBehalfOf <IMicrosoftGraphDirectoryObject>]
    [-DeletedDateTime <DateTime>]
    [-Description <String>]
    [-GroupType <String[]>]
    [-HasMembersWithLicenseError]
    [-IsArchived]
    [-IsAssignableToRole]
    [-MailEnabled]
    [-MembershipRule <String>]
    [-MembershipRuleProcessingState <String>]
    [-PermissionGrant <IMicrosoftGraphResourceSpecificPermissionGrant[]>]
    [-PreferredDataLocation <String>]
    [-PreferredLanguage <String>]
    [-SecurityEnabled]
    [-SecurityIdentifier <String>]
    [-Theme <String>]
    [-TransitiveMember <IMicrosoftGraphDirectoryObject[]>]
    [-TransitiveMemberOf <IMicrosoftGraphDirectoryObject[]>]
    [-Visibility <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Ajoute une nouvelle entité aux groupes

Exemples

Exemple 1 : Créer un groupe

New-AzADGroup -DisplayName $gname -MailNickname $nickname

Créer un groupe

Paramètres

-AcceptedSender

Liste des utilisateurs ou groupes autorisés à créer des événements de publication ou de calendrier dans ce groupe. Si cette liste n’est pas vide, seuls les utilisateurs ou groupes répertoriés ici sont autorisés à publier. Pour construire, consultez la section NOTES pour les propriétés ACCEPTEDSENDER et créer une table de hachage.

Propriétés du paramètre

Type:

IMicrosoftGraphDirectoryObject[]

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

-AdditionalProperties

Paramètres supplémentaires

Propriétés du paramètre

Type:Hashtable
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

-AppRoleAssignment

Représente les rôles d’application qu’un groupe a accordés à une application. Prend en charge $expand. Pour construire, consultez la section NOTES pour les propriétés APPROLEASSIGNMENT et créez une table de hachage.

Propriétés du paramètre

Type:

IMicrosoftGraphAppRoleAssignmentAutoGenerated[]

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

-Classification

Décrit une classification pour le groupe (par exemple, impact faible, moyen ou élevé sur l’activité). Les valeurs valides pour cette propriété sont définies en créant une valeur de paramètre ClassificationList, en fonction de la définition du modèle. Retourné par défaut. Prend en charge $filter (eq, ne, NOT, ge, le, startsWith).

Propriétés du paramètre

Type: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

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

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

-CreatedOnBehalfOf

Représente un objet Azure Active Directory. Le type directoryObject est le type de base pour de nombreux autres types d’entités d’annuaire. Pour construire, consultez la section NOTES pour les propriétés CREATEDONBEHALFOF et créez une table de hachage.

Propriétés du paramètre

Type:IMicrosoftGraphDirectoryObject
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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:PSObject
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

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

-DeletedDateTime

.

Propriétés du paramètre

Type:DateTime
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

-Description

Description facultative du groupe. Renvoyée par défaut. Prend en charge $filter (eq, ne, NOT, ge, le, startsWith) et $search.

Propriétés du paramètre

Type: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

Nom complet du groupe. Cette propriété est requise lorsqu’un groupe est créé et ne peut pas être effacé pendant les mises à jour. Renvoyée par défaut. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith), $search et $orderBy.

Propriétés du paramètre

Type: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

-GroupType

Spécifie le type et l’appartenance du groupe. Si la collection contient Unified, le groupe est un groupe Microsoft 365 ; sinon, il s’agit d’un groupe de sécurité ou d’un groupe de distribution. Pour plus d’informations, consultez la vue d’ensemble des groupes. Si la collection inclut DynamicMembership, le groupe a une appartenance dynamique ; sinon, l’appartenance est statique. Renvoyée par défaut. Prend en charge $filter (eq, NOT).

Propriétés du paramètre

Type:

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

-HasMembersWithLicenseError

Indique s’il existe des membres de ce groupe avec erreurs de licence à partir de cette attribution des licences basée sur le groupe. Cette propriété n’est jamais renvoyée sur une opération GET. Vous pouvez l’utiliser comme un argument $filter pour obtenir des groupes comportant des membres avec des erreurs de licence (autrement dit, le filtre pour cette propriété est true). Prend en charge $filter (eq).

Propriétés du paramètre

Type:SwitchParameter
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

-IsArchived

.

Propriétés du paramètre

Type:SwitchParameter
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 ce groupe peut être affecté à un rôle Azure Active Directory. Cette propriété ne peut être définie que lors de la création du groupe et est immuable. Si la valeur est true, la propriété securityEnabled doit également être définie sur true et le groupe ne peut pas être un groupe dynamique (autrement dit, groupTypes ne peut pas contenir DynamicMembership). Seuls les appelants dans les rôles d’administrateur général et d’administrateur de rôle privilégié peuvent définir cette propriété. L’appelant doit également recevoir l’autorisation Directory.AccessAsUser.All pour définir cette propriété. Pour plus d’informations, consultez Utilisation d’un groupe pour gérer les attributions de rôles Azure ADReturned par défaut. Prend en charge $filter (eq, ne, NOT).

Propriétés du paramètre

Type:SwitchParameter
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

Indique si le groupe est à extension messagerie. Renvoyée par défaut. Prend en charge $filter (eq, ne, NOT).

Propriétés du paramètre

Type:SwitchParameter
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

-MailNickname

L’alias de messagerie du groupe, unique dans l’organisation. Cette propriété doit être spécifiée lors de la création d’un groupe. Ces caractères ne peuvent pas être utilisés dans mailNickName : @()/[]' ;:.<>,SPACE. Renvoyée par défaut. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Type: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

-MembershipRule

Règle qui détermine les membres de ce groupe si le groupe est un groupe dynamique (groupTypes contient DynamicMembership). Pour plus d’informations sur la syntaxe de la règle d’appartenance, consultez la syntaxe règles d’appartenance. Renvoyée par défaut. Prend en charge $filter (eq, ne, NOT, ge, le, startsWith).

Propriétés du paramètre

Type: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

-MembershipRuleProcessingState

Indique si le traitement d’appartenance dynamique est en cours ou suspendu. Les valeurs possibles sont activées ou suspendues. Renvoyée par défaut. Prend en charge $filter (eq, ne, NOT, in).

Propriétés du paramètre

Type: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

-PermissionGrant

Autorisations accordées pour un groupe à une application spécifique. Prend en charge $expand. Pour construire, consultez la section NOTES pour les propriétés PERMISSIONGRANT et créer une table de hachage.

Propriétés du paramètre

Type:

IMicrosoftGraphResourceSpecificPermissionGrant[]

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

-PreferredDataLocation

Emplacement de données préféré du groupe. Pour plus d’informations, consultez OneDrive Online Multi-Geo. Renvoyée par défaut.

Propriétés du paramètre

Type: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

-PreferredLanguage

Langue par défaut du groupe Microsoft 365. Doit suivre le code ISO 639-1 ; par exemple 'en-US'. Renvoyée par défaut. Prend en charge $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriétés du paramètre

Type: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

-SecurityEnabled

Indique si le groupe est un groupe de sécurité. Renvoyée par défaut. Prend en charge $filter (eq, ne, NOT, in).

Propriétés du paramètre

Type:SwitchParameter
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

-SecurityIdentifier

Identificateur de sécurité du groupe, utilisé dans les scénarios Windows. Renvoyée par défaut.

Propriétés du paramètre

Type: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

-Theme

Spécifie le thème de couleur d’un groupe Microsoft 365. Les valeurs possibles sont Teal, Violet, Vert, Bleu, Rose, Orange ou Rouge. Renvoyée par défaut.

Propriétés du paramètre

Type: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

-TransitiveMember

. Pour construire, consultez la section NOTES pour les propriétés TRANSITIVEMEMBER et créez une table de hachage.

Propriétés du paramètre

Type:

IMicrosoftGraphDirectoryObject[]

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

-TransitiveMemberOf

. Pour construire, consultez la section NOTES pour les propriétés TRANSITIVEMEMBEROF et créez une table de hachage.

Propriétés du paramètre

Type:

IMicrosoftGraphDirectoryObject[]

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

-Visibility

Spécifie la stratégie d’adhésion au groupe et la visibilité du contenu des groupes. Les valeurs possibles sont : Private, Public ou Hiddenmembership. Hiddenmembership ne peut être défini que pour les groupes Microsoft 365, lorsque les groupes sont créés. Vous ne pouvez pas mettre à jour cette valeur par la suite. Vous pouvez mettre à jour les autres valeurs de visibilité après la création des groupes. Si la valeur de visibilité n’est pas spécifiée lors de la création du groupe sur Microsoft Graph, un groupe de sécurité est créé en tant que privé par défaut et le groupe Microsoft 365 est public. Pour en savoir plus, consultez les options de visibilité de groupe. Renvoyée par défaut.

Propriétés du paramètre

Type: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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

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.

Sorties

IMicrosoftGraphGroup