New-AzureADUser
Crée un utilisateur Azure AD.
Syntaxe
New-AzureADUser
[-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
-AccountEnabled <Boolean>
[-AgeGroup <String>]
[-City <String>]
[-CompanyName <String>]
[-ConsentProvidedForMinor <String>]
[-Country <String>]
[-CreationType <String>]
[-Department <String>]
-DisplayName <String>
[-FacsimileTelephoneNumber <String>]
[-GivenName <String>]
[-IsCompromised <Boolean>]
[-ImmutableId <String>]
[-JobTitle <String>]
[-MailNickName <String>]
[-Mobile <String>]
[-OtherMails <System.Collections.Generic.List`1[System.String]>]
[-PasswordPolicies <String>]
-PasswordProfile <PasswordProfile>
[-PhysicalDeliveryOfficeName <String>]
[-PostalCode <String>]
[-PreferredLanguage <String>]
[-ShowInAddressList <Boolean>]
[-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
[-State <String>]
[-StreetAddress <String>]
[-Surname <String>]
[-TelephoneNumber <String>]
[-UsageLocation <String>]
[-UserPrincipalName <String>]
[-UserState <String>]
[-UserStateChangedOn <String>]
[-UserType <String>]
[<CommonParameters>] Description
L’applet de commande New-AzureADUser crée un utilisateur dans Azure Active Directory (Azure AD).
Exemples
Exemple 1 : Créer un utilisateur
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$PasswordProfile.Password = "<Password>"
New-AzureADUser -DisplayName "New User" -PasswordProfile $PasswordProfile -UserPrincipalName "NewUser@contoso.com" -AccountEnabled $true -MailNickName "Newuser"
ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user NewUser@contoso.com MemberCette commande crée un utilisateur.
Paramètres
-AccountEnabled
Indique si le compte de l’utilisateur est activé.
| 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 |
-AgeGroup
Cela spécifie le groupe d’âge de l’utilisateur.
| 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 |
-City
Spécifie la ville de l’utilisateur.
| 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 |
-CompanyName
Cela spécifie le nom de l’entreprise de l’utilisateur.
| 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 |
-ConsentProvidedForMinor
| 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 |
-Country
Spécifie le pays ou la région de l’utilisateur.
| 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 |
-CreationType
Indique si le compte d’utilisateur est un compte local pour un locataire Azure Active Directory B2C.
Les valeurs possibles sont LocalAccount et null.
Lors de la création d’un compte local, la propriété est obligatoire et vous devez la définir sur LocalAccount.
Lors de la création d’un compte professionnel ou scolaire, ne spécifiez pas la propriété ni ne définissez-la sur null.
| 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 |
-Department
Spécifie le service de l’utilisateur.
| 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 le nom d’affichage de l’utilisateur.
| 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 |
-ExtensionProperty
| Type: | Dictionary<TKey,TValue>[System.String,System.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 |
-FacsimileTelephoneNumber
Cela spécifie le numéro de téléphone de l’utilisateur.
| 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 |
-GivenName
Spécifie le nom donné de l’utilisateur.
| 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 |
-ImmutableId
Cette propriété permet d’associer un compte d’utilisateur Active Directory sur site à son objet utilisateur Azure AD. Cette propriété doit être spécifiée lors de la création d’un compte d’utilisateur dans graph si vous utilisez un domaine fédéré pour la propriété userPrincipalName (UPN) de l’utilisateur.
Important : Les $ caractères et _ ne peuvent pas être utilisés lors de la spécification de cette propriété.
| 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 |
-IsCompromised
Indique si cet utilisateur est compromis.
| 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 |
-JobTitle
Spécifie le titre du travail de l’utilisateur.
| 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 |
-MailNickName
Spécifie le surnom de messagerie de l’utilisateur.
| 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 |
-Mobile
Spécifie le numéro de téléphone mobile de l’utilisateur.
| 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 |
-OtherMails
Liste d’adresses e-mail supplémentaires pour l’utilisateur. Par exemple, bob@contoso.com, Robert@fabrikam.com.
| 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 |
-PasswordPolicies
Spécifie les stratégies de mot de passe de l’utilisateur.
Cette valeur est une énumération dont une valeur possible est DisableStrongPassword, qui permet de spécifier des mots de passe plus faibles que la stratégie par défaut.
DisablePasswordExpiration peut également être spécifié.
Les deux peuvent être spécifiés ensemble ; par exemple : « DisablePasswordExpiration, DisableStrongPassword ».
| 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 |
-PasswordProfile
Spécifie le profil de mot de passe de l’utilisateur.
Notez que le type de paramètre pour ce paramètre est PasswordProfile.
Pour passer un paramètre de ce type, vous devez d’abord le faire ;
- créez une variable dans PowerShell avec ce type :
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
- Définissez la valeur du mot de passe dans cette variable :
$PasswordProfile.Password = "\<Password\>"
- Enfin, transmettez cette variable à l’applet de commande :
New-AzureADUser -PasswordProfile $PasswordProfile ...
Les autres attributs qui peuvent être définis dans passwordProfile sont les suivants :
-
$PasswordProfile.EnforceChangePasswordPolicy- booléen indiquant que la stratégie de modification de mot de passe est activée ou désactivée pour cet utilisateur. -
$PasswordProfile.ForceChangePasswordNextLogin- booléen indiquant que l’utilisateur doit modifier le mot de passe lors de la prochaine connexion.
| Type: | PasswordProfile |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PhysicalDeliveryOfficeName
Spécifie le nom du bureau de remise physique de l’utilisateur.
| 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 |
-PostalCode
Spécifie le code postal de l’utilisateur.
| 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 |
-PreferredLanguage
Spécifie la langue préférée de l’utilisateur.
| 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 |
-ShowInAddressList
Si la valeur est True, affichez cet utilisateur dans la liste d’adresses.
| 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 |
-SignInNames
Spécifie la collection de noms de connexion d’un compte local dans un locataire Azure Active Directory B2C.
Chaque nom de connexion doit être unique dans l’entreprise/le locataire. La propriété doit être spécifiée lorsque vous créez un utilisateur de compte local. Ne le spécifiez pas lorsque vous créez un compte professionnel ou scolaire.
| Type: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-State
Spécifie l’état de l’utilisateur.
| 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 |
-StreetAddress
Spécifie l’adresse postale de l’utilisateur.
| 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 |
-Surname
Spécifie le nom de l’utilisateur.
| 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 |
-TelephoneNumber
Spécifie un numéro de téléphone.
| 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 |
-UsageLocation
Code de pays ou de région à deux lettres (norme ISO 3166).
Il est obligatoire pour les utilisateurs qui se verront attribuer des licences en raison des exigences légales pour vérifier la disponibilité des services dans les pays et les régions.
Exemples : US, JPet GB.
| 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 |
-UserPrincipalName
Spécifie le nom principal (UPN) de l’utilisateur.
L’UPN est un nom de connexion au format Internet d’un utilisateur selon la norme Internet RFC 822.
Par convention, il doit correspondre au nom de l’adresse électronique de l’utilisateur.
Le format général est alias@domain.
Pour les comptes professionnels ou scolaires, le domaine doit être présent dans la collection de domaines vérifiés du locataire. Cette propriété est obligatoire lors de la création d’un compte professionnel ou scolaire et facultative pour les comptes locaux.
| 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 |
-UserState
| 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 |
-UserStateChangedOn
| 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 |
-UserType
Valeur de chaîne qui permet de classer des types d’utilisateurs dans votre annuaire, tels que « Member » et « Guest ».
| 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 |
Notes
Consultez le guide de migration pour New-AzureADUser vers Microsoft Graph PowerShell.