New-EntraBetaUser

Syntaxe

Default (Par défaut)

New-EntraBetaUser

    -DisplayName <String>
    -AccountEnabled <Boolean>
    -PasswordProfile <PasswordProfile>
    [-PostalCode <String>]
    [-MailNickName <String>]
    [-ShowInAddressList <Boolean>]
    [-Department <String>]
    [-BusinessPhones <String>]
    [-PreferredLanguage <String>]
    [-Mobile <String>]
    [-JobTitle <String>]
    [-ConsentProvidedForMinor <String>]
    [-PasswordPolicies <String>]
    [-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
    [-OtherMails <System.Collections.Generic.List`1[System.String]>]
    [-UserState <String>]
    [-ImmutableId <String>]
    [-City <String>]
    [-AgeGroup <String>]
    [-UsageLocation <String>]
    [-UserStateChangedOn <String>]
    [-Country <String>]
    [-UserPrincipalName <String>]
    [-GivenName <String>]
    [-UserType <String>]
    [-StreetAddress <String>]
    [-State <String>]
    [-CompanyName <String>]
    [-FaxNumber <String>]
    [-Surname <String>]
    [-CreationType <String>]
    [<CommonParameters>]

Description

Exemples

Exemple 1 : Créer un utilisateur à l’aide du paramètre MailNickName

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$params = @{
    DisplayName = 'New User'
    PasswordProfile = $passwordProfile
    UserPrincipalName = 'NewUser@contoso.com'
    AccountEnabled = $true
    MailNickName = 'Newuser'
}

New-EntraBetaUser @params

DisplayName Id                                   Mail UserPrincipalName
----------- --                                   ---- -----------------
New User 00aa00aa-bb11-cc22-dd33-44ee44ee44ee      NewUser@contoso.com

Exemple 2 : Créer un utilisateur à l’aide du paramètre AgeGroup

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$params = @{
    DisplayName = 'New User'
    PasswordProfile = $passwordProfile
    UserPrincipalName = 'NewUser@contoso.com'
    AccountEnabled = $true
    MailNickName = 'Newuser'
    AgeGroup = 'adult'
}

New-EntraBetaUser @params

DisplayName Id                                   Mail UserPrincipalName
----------- --                                   ---- -----------------
New User 00aa00aa-bb11-cc22-dd33-44ee44ee44ee      NewUser@contoso.com

Exemple 3 : Créer un utilisateur à l’aide du paramètre City

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$params = @{
    DisplayName = 'New User'
    PasswordProfile = $passwordProfile
    UserPrincipalName = 'NewUser@contoso.com'
    AccountEnabled = $true
    MailNickName = 'Newuser'
    City = 'New York'
}

New-EntraBetaUser @params

DisplayName Id                                   Mail UserPrincipalName
----------- --                                   ---- -----------------
New User 00aa00aa-bb11-cc22-dd33-44ee44ee44ee      NewUser@contoso.com

Exemple 4 : Créer un utilisateur à l’aide du paramètre Department

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$params = @{
    DisplayName = 'New User'
    PasswordProfile = $passwordProfile
    UserPrincipalName = 'NewUser@contoso.com'
    AccountEnabled = $true
    MailNickName = 'Newuser'
    Department = 'IT'
}

New-EntraBetaUser @params

DisplayName Id                                   Mail UserPrincipalName
----------- --                                   ---- -----------------
New User 00aa00aa-bb11-cc22-dd33-44ee44ee44ee      NewUser@contoso.com

Exemple 5 : Créer un utilisateur à l’aide du paramètre Mobile

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$params = @{
    DisplayName = 'New User'
    PasswordProfile = $passwordProfile
    UserPrincipalName = 'NewUser@contoso.com'
    AccountEnabled = $true
    MailNickName = 'Newuser'
    Mobile = '02883655253'
}

New-EntraBetaUser @params

DisplayName Id                                   Mail UserPrincipalName
----------- --                                   ---- -----------------
New User 00aa00aa-bb11-cc22-dd33-44ee44ee44ee      NewUser@contoso.com

Paramètres

-AccountEnabled

Indique si le compte de l’utilisateur est activé.

Propriétés du paramètre

Jeux de paramètres

-AgeGroup

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

Propriétés du paramètre

Jeux de paramètres

-BusinessPhones

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

Propriétés du paramètre

Jeux de paramètres

-City

Spécifie la ville de l’utilisateur.

Propriétés du paramètre

Jeux de paramètres

-CompanyName

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

Propriétés du paramètre

Jeux de paramètres

-ConsentProvidedForMinor

Définit si le consentement a été obtenu pour les mineurs.

Propriétés du paramètre

Jeux de paramètres

-Country

Spécifie le pays de l’utilisateur.

Propriétés du paramètre

Jeux de paramètres

-CreationType

Indique si le compte d’utilisateur est un compte local pour un locataire Microsoft Entra ID B2C. Les valeurs possibles sont « LocalAccount » et Null.

• Lorsque l’utilisateur crée un compte local, la propriété est requise et vous devez la définir sur « LocalAccount ».
• Lorsque l’utilisateur crée un compte professionnel ou scolaire, ne spécifiez pas la propriété ou définissez-la sur Null.

Propriétés du paramètre

Jeux de paramètres

-Department

Spécifie le service de l’utilisateur.

Propriétés du paramètre

Jeux de paramètres

-DisplayName

Spécifie le nom complet de l’utilisateur.

Propriétés du paramètre

Jeux de paramètres

-FaxNumber

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

Propriétés du paramètre

Jeux de paramètres

-GivenName

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

Propriétés du paramètre

Jeux de paramètres

-ImmutableId

Cette propriété lie un compte d'utilisateur local à son objet Microsoft Entra ID et est requise lors de la création d'un utilisateur dans Microsoft Graph si l'UPN (userPrincipalName) de l'utilisateur se trouve dans un domaine fédéré.

Important : les caractères $ et _ ne peuvent pas être utilisés lors de la spécification de cette propriété.

Propriétés du paramètre

Jeux de paramètres

-JobTitle

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

Propriétés du paramètre

Jeux de paramètres

-MailNickName

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

Propriétés du paramètre

Jeux de paramètres

-Mobile

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

Propriétés du paramètre

Jeux de paramètres

-OtherMails

Liste d’autres adresses e-mail pour l’utilisateur ; par exemple : « »,bob@contoso.com «Robert@fabrikam.com ».

Propriétés du paramètre

Jeux de paramètres

-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. Vous pouvez également spécifier la valeur « DisablePasswordExpiration ». Les deux peuvent être spécifiés ensemble ; par exemple : « DisablePasswordExpiration, DisableStrongPassword ».

Propriétés du paramètre

Jeux de paramètres

-PasswordProfile

Spécifie le profil de mot de passe de l’utilisateur.

Le type de paramètre de ce paramètre est « PasswordProfile ».

Pour passer un paramètre de ce type, vous devez d’abord créer une variable dans PowerShell avec ce type :

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

Vous pouvez ensuite 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-EntraBetaUser -PasswordProfile $passwordProfile ...

D’autres attributs qui peuvent être définis dans passwordProfile sont

• $passwordProfile.EnforceChangePasswordPolicy : valeur booléenne indiquant que la stratégie de changement de mot de passe est enabled ou disabled pour cet utilisateur $passwordProfile.

• ForceChangePasswordNextLogin : valeur booléenne indiquant que l’utilisateur doit modifier le mot de passe lors de la prochaine connexion.

Propriétés du paramètre

Jeux de paramètres

-PostalCode

Spécifie le code postal de l’utilisateur.

Propriétés du paramètre

Jeux de paramètres

-PreferredLanguage

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

Propriétés du paramètre

Jeux de paramètres

-ShowInAddressList

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

Propriétés du paramètre

Jeux de paramètres

-SignInNames

Spécifie la collection de noms de connexion pour un compte local dans un locataire Microsoft Entra ID B2C.

Chaque nom de connexion doit être unique dans l’entreprise/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.

Propriétés du paramètre

Jeux de paramètres

-State

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

Propriétés du paramètre

Jeux de paramètres

-StreetAddress

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

Propriétés du paramètre

Jeux de paramètres

-Surname

Spécifie le nom de l’utilisateur.

Propriétés du paramètre

Jeux de paramètres

-UsageLocation

Code pays à deux lettres (norme ISO 3166).

Requis pour les utilisateurs auxquels des licences sont attribuées en raison d’une exigence légale pour vérifier la disponibilité des services dans les pays.

Voici quelques exemples : « US », « JP » et « GB ».

Propriétés du paramètre

Jeux de paramètres

-UserPrincipalName

Nom d’utilisateur principal (UPN) de l’utilisateur.

L’UPN est un nom de connexion de style Internet pour l’utilisateur basé sur la norme Internet RFC 822.

Par convention, cet UPN doit être mappé au nom de messagerie 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 requise lorsqu’un compte professionnel ou scolaire est créé ; il est facultatif pour les comptes locaux.

Propriétés du paramètre

Jeux de paramètres

-UserState

Pour un utilisateur externe invité au locataire à l’aide de l’API d’invitation, cette propriété représente l’état d’invitation de l’utilisateur invité.

Propriétés du paramètre

Jeux de paramètres

-UserStateChangedOn

Affiche l’horodatage pour la dernière modification apportée à la propriété userState.

Propriétés du paramètre

Jeux de paramètres

-UserType

Valeur de chaîne qui peut être utilisée pour classer les types d’utilisateur dans votre répertoire, tels que « Membre » et « Invité ».

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Liens associés

• Get-EntraBetaUser
• Remove-EntraBetaUser
• Set-EntraBetaUser