Partager via

New-AzureADUser

  • Référence
Module:
AzureADPreview

Crée un utilisateur 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 (AD).

Exemples

Exemple 1 : Créer un utilisateur

-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

{{ Fill AgeGroup Description }}

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

{{ Fill CompanyName Description }}

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

{{ Fill ConsentProvidedForMinor Description }}

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. Lorsque vous créez un compte local, la propriété est obligatoire et vous devez la définir sur « LocalAccount ». Lorsque vous créez un compte professionnel ou scolaire, ne spécifiez pas la propriété et ne la définissez pas 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 complet 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

@{Text=}

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

{{Fill FacsimileTelephoneNumber Description}}

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 graphe 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 poste 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

Une 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 avec une seule valeur possible, « 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 ce paramètre est « PasswordProfile ». Pour passer un paramètre de ce type, vous devez d’abord créer un vairable dans PowerShell avec ce type :

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

Vous pouvez définir la valeur du mot de passe dans cette variable :

$PasswordProfile.Password = « <Password> »

Enfin, vous pouvez passer cette variable à l’applet de commande :

New-AzureADUser -PasswordProfile $PasswordProfile ...

Les autres attributs qui peuvent être définis dans PasswordProfile sont

$PasswordProfile.EnforceChangePasswordPolicy : booléen indiquant que la stratégie de modification de mot de passe est enabable ou désactivée pour cet utilisateur $PasswordProfile.ForceChangePasswordNextLogin : booléen indiquant que l’utilisateur doit modifier le mot de passe lors de la connexion suivante

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 par défaut 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. Vous devez spécifier la propriété lorsque vous créez un utilisateur de compte local, 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 famille 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

Un code de pays ou de région à deux lettres (norme ISO 3166). Obligatoire pour les utilisateurs qui se verront attribuer des licences en raison de l’obligation légale de vérifier la disponibilité des services dans les pays et les régions. Exemples : « US », « JP » et « 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

Nom d’utilisateur 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 standard 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

{{ Fill UserState Description }}

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

{{ Fill UserStateChangedOn Description }}

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