Partager via


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             Member

Cette 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 ;

  1. créez une variable dans PowerShell avec ce type :

$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile

  1. Définissez la valeur du mot de passe dans cette variable :

$PasswordProfile.Password = "\<Password\>"

  1. 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.