New-LocalUser

  • Référence
Module:
Microsoft.PowerShell.LocalAccounts

Crée un compte d’utilisateur local.

Syntax

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

Description

L’applet New-LocalUser de commande 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 Password . 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 Read-Host de commande 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 $Password variable.

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 Get-Date de commande pour obtenir un objet DateTime . Si vous ne spécifiez pas ce paramètre, le compte n’expire pas.

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

-AccountNeverExpires

Indique que le compte n’expire pas.

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

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

-Disabled

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

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

-FullName

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

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

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

-NoPassword

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 les paramètres Mot de passe et NoPassword, New-LocalUser vous invite à entrer le mot de passe du nouvel utilisateur.

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

-PasswordNeverExpires

Indique si le mot de passe du nouvel utilisateur expire.

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

-UserMayNotChangePassword

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

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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é sur les objets LocalUser, LocalGroup et LocalPrincipal qui décrivent 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.