New-LocalUser

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

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

Met de cmdlet New-LocalUser wordt een lokaal gebruikersaccount gemaakt. Met deze cmdlet maakt u een lokaal gebruikersaccount.

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

Name    Enabled  Description
----    -------  -----------
User02  True     Description of this account.

Met deze opdracht maakt u een lokaal gebruikersaccount en geeft u de parameters AccountExpires of Password niet op. Het account verloopt niet of heeft een wachtwoord.

$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.

De eerste opdracht gebruikt de Read-Host cmdlet om u om een wachtwoord te vragen. Met de opdracht wordt het wachtwoord opgeslagen als een veilige tekenreeks in de $Password variabele.

Met de tweede opdracht maakt u een lokaal gebruikersaccount en stelt u het wachtwoord van het nieuwe account in op de beveiligde tekenreeks die is opgeslagen in $Password. Met de opdracht geeft u een gebruikersnaam, volledige naam en beschrijving voor het gebruikersaccount op.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een tekenreeks doorsluizen naar deze cmdlet.

U kunt een DateTime--object doorsluisen naar deze cmdlet.

U kunt een Booleaanse waarde doorsluisen naar deze cmdlet.

U kunt een beveiligde tekenreeks doorsluisen naar deze cmdlet.

Deze cmdlet retourneert een LocalUser-object dat het gemaakte gebruikersaccount vertegenwoordigt.

Windows PowerShell bevat de volgende aliassen voor New-LocalUser:

• nlu

Een gebruikersnaam kan niet identiek zijn aan een andere gebruikersnaam of groepsnaam op de computer. Een gebruikersnaam mag niet alleen bestaan uit perioden . of spaties. Een gebruikersnaam kan maximaal 20 hoofdletters of kleine letters bevatten. Een gebruikersnaam mag niet de volgende tekens bevatten:

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

Een wachtwoord mag maximaal 127 tekens bevatten.

De eigenschap PrincipalSource is een eigenschap in LocalUser, LocalGroupen LocalPrincipal-objecten die de bron van het object beschrijven. De mogelijke bronnen zijn als volgt:

• Local
• Active Directory
• AzureAD
• MicrosoftAccount