Partager via


New-LocalUser

Crée un compte d’utilisateur local.

Syntaxe

Password (Par défaut)

New-LocalUser
    [-Name] <String>
    -Password <SecureString>
    [-AccountExpires <DateTime>]
    [-AccountNeverExpires]
    [-Description <String>]
    [-Disabled]
    [-FullName <String>]
    [-PasswordNeverExpires]
    [-UserMayNotChangePassword]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NoPassword

New-LocalUser
    [-Name] <String>
    [-AccountExpires <DateTime>]
    [-AccountNeverExpires]
    [-Description <String>]
    [-Disabled]
    [-FullName <String>]
    [-NoPassword]
    [-UserMayNotChangePassword]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande New-LocalUser crée un compte d’utilisateur local. Cette applet de commande crée un compte d’utilisateur local.

Remarque

Le module Microsoft.PowerShell.LocalAccounts n’est pas disponible dans PowerShell 32 bits sur un système 64 bits.

Exemples

Exemple 1 : Créer un compte d’utilisateur

New-LocalUser -Name 'User02' -Description 'Description of this account.' -NoPassword
Name    Enabled  Description
----    -------  -----------
User02  True     Description of this account.

Cette commande crée un compte d’utilisateur local et ne spécifie pas les paramètres accountExpires ou mot de passe. Le compte n’expire pas ou n’a pas de mot de passe.

Exemple 2 : Créer un compte d’utilisateur disposant d’un mot de passe

$Password = Read-Host -AsSecureString
$params = @{
    Name        = 'User03'
    Password    = $Password
    FullName    = 'Third User'
    Description = 'Description of this account.'
}
New-LocalUser @params
Name    Enabled  Description
----    -------  -----------
User03  True     Description of this account.

La première commande utilise l’applet de commande Read-Host pour vous inviter à entrer un mot de passe. La commande stocke le mot de passe sous forme de chaîne sécurisée dans la variable $Password.

La deuxième commande crée un compte d’utilisateur local et définit le mot de passe du nouveau compte sur la chaîne sécurisée stockée dans $Password. La commande spécifie un nom d’utilisateur, un nom complet et une description pour le compte d’utilisateur.

Paramètres

-AccountExpires

Spécifie quand le compte d’utilisateur expire. Vous pouvez utiliser l’applet de commande Get-Date pour obtenir un objet DateTime. Si vous ne spécifiez pas ce paramètre, le compte n’expire pas.

Propriétés du paramètre

Type:DateTime
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-AccountNeverExpires

Indique que le compte n’expire pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Description

Spécifie un commentaire pour le compte d’utilisateur. La longueur maximale est de 48 caractères.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Disabled

Indique que cette applet de commande crée le compte d’utilisateur comme désactivé.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-FullName

Spécifie le nom complet du compte d’utilisateur. Le nom complet diffère du nom d’utilisateur du compte d’utilisateur.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Name

Spécifie le nom d’utilisateur du compte d’utilisateur.

Un nom d’utilisateur peut contenir jusqu’à 20 caractères majuscules ou minuscules. Un nom d’utilisateur ne peut pas contenir les caractères suivants :

", /, , \, ][, :, ;|>?+<=,*,@

Un nom d’utilisateur ne peut pas se composer uniquement de points . ou d’espaces.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-NoPassword

Indique que le compte d’utilisateur n’a pas de mot de passe.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

NoPassword
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Password

Spécifie un mot de passe pour le compte d’utilisateur. Vous pouvez utiliser Read-Host -AsSecureString, Get-Credentialou ConvertTo-SecureString pour créer un objet SecureString pour le mot de passe.

Si vous omettez le de mot de passe et paramètres de NoPassword, New-LocalUser vous invite à entrer le mot de passe du nouvel utilisateur.

Propriétés du paramètre

Type:SecureString
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Password
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-PasswordNeverExpires

Indique si le mot de passe du nouvel utilisateur expire.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Password
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-UserMayNotChangePassword

Indique que l’utilisateur ne peut pas modifier le mot de passe sur le compte d’utilisateur.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Vous pouvez diriger une chaîne vers cette applet de commande.

DateTime

Vous pouvez diriger un objet DateTime vers cette applet de commande.

Boolean

Vous pouvez diriger une valeur booléenne vers cette applet de commande.

SecureString

Vous pouvez diriger une chaîne sécurisée vers cette applet de commande.

Sorties

System.Management.Automation.SecurityAccountsManager.LocalUser

Cette applet de commande retourne un objet LocalUser représentant le compte d’utilisateur créé.

Notes

Windows PowerShell inclut les alias suivants pour New-LocalUser:

  • nlu

Un nom d’utilisateur ne peut pas être identique à n’importe quel autre nom d’utilisateur ou nom de groupe sur l’ordinateur. Un nom d’utilisateur ne peut pas se composer uniquement de points . ou d’espaces. Un nom d’utilisateur peut contenir jusqu’à 20 caractères majuscules ou minuscules. Un nom d’utilisateur ne peut pas contenir les caractères suivants :

", /, , \, ][, :, ;|>?+<=,*,@

Un mot de passe peut contenir jusqu’à 127 caractères.

La propriété PrincipalSource est une propriété des objets LocalUser, LocalGroupet LocalPrincipal qui décrit la source de l'objet. Les sources possibles sont les suivantes :

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

Remarque

PrincipalSource est pris en charge uniquement par Windows 10, Windows Server 2016 et versions ultérieures du système d’exploitation Windows. Pour les versions antérieures, la propriété est vide.