New-AzureADUser

Crée un utilisateur Azure AD.

Syntax

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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AgeGroup

Cela spécifie le groupe d’âge de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-City

Spécifie la ville de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CompanyName

Cela spécifie le nom de l’entreprise de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConsentProvidedForMinor

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Country

Spécifie le pays ou la région de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Department

Spécifie le service de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Spécifie le nom d’affichage de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExtensionProperty

Type:Dictionary<TKey,TValue>[System.String,System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FacsimileTelephoneNumber

Cela spécifie le numéro de téléphone de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GivenName

Spécifie le nom donné de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsCompromised

Indique si cet utilisateur est compromis.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobTitle

Spécifie le titre du travail de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MailNickName

Spécifie le surnom de messagerie de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Mobile

Spécifie le numéro de téléphone mobile de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PhysicalDeliveryOfficeName

Spécifie le nom du bureau de remise physique de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PostalCode

Spécifie le code postal de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreferredLanguage

Spécifie la langue préférée de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShowInAddressList

Si la valeur est True, affichez cet utilisateur dans la liste d’adresses.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-State

Spécifie l’état de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StreetAddress

Spécifie l’adresse postale de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Surname

Spécifie le nom de l’utilisateur.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TelephoneNumber

Spécifie un numéro de téléphone.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UsageLocation

Code de pays ou de région à deux lettres (norme ISO 3166).

Il est requis pour les utilisateurs qui se verront attribuer des licences en raison d’exigences légales pour case activée pour la disponibilité des services dans les pays et les régions. Exemples : US, JPet GB.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserState

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserStateChangedOn

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Notes

Consultez le guide de migration pour New-AzureADUser vers Microsoft Graph PowerShell.