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 :
LocalActive DirectoryAzureADMicrosoftAccount
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.