New-LocalUser

  • Referentie
Module:
Microsoft.PowerShell.LocalAccounts

Hiermee maakt u een lokaal gebruikersaccount.

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

De New-LocalUser cmdlet maakt een lokaal gebruikersaccount. Met deze cmdlet maakt u een lokaal gebruikersaccount.

Notitie

De module Microsoft.PowerShell.LocalAccounts is niet beschikbaar in 32-bits PowerShell op een 64-bits systeem.

Voorbeelden

Voorbeeld 1: Een gebruikersaccount maken

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.

Voorbeeld 2: Een gebruikersaccount met een wachtwoord maken

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

Parameters

-AccountExpires

Hiermee geeft u op wanneer het gebruikersaccount verloopt. U kunt de Get-Date cmdlet gebruiken om een DateTime-object op te halen. Als u deze parameter niet opgeeft, verloopt het account niet.

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

-AccountNeverExpires

Geeft aan dat het account niet verloopt.

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Description

Hiermee geeft u een opmerking voor het gebruikersaccount. De maximale lengte is 48 tekens.

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

-Disabled

Geeft aan dat met deze cmdlet het gebruikersaccount wordt gemaakt als uitgeschakeld.

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

-FullName

Hiermee geeft u de volledige naam voor het gebruikersaccount. De volledige naam verschilt van de gebruikersnaam van het gebruikersaccount.

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

-Name

Hiermee geeft u de gebruikersnaam voor het gebruikersaccount.

Een gebruikersnaam kan maximaal 20 hoofdletters of kleine letters bevatten. Een gebruikersnaam mag niet de volgende tekens bevatten:

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

Een gebruikersnaam mag niet alleen bestaan uit punten . of spaties.

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

-NoPassword

Geeft aan dat het gebruikersaccount geen wachtwoord heeft.

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

-Password

Hiermee geeft u een wachtwoord voor het gebruikersaccount. U kunt een SecureString-object voor het wachtwoord gebruiken Read-Host -AsSecureStringof Get-CredentialConvertTo-SecureString maken.

Als u de parameters Wachtwoord en NoPassword weglaat, New-LocalUser wordt u gevraagd om het wachtwoord van de nieuwe gebruiker.

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

-PasswordNeverExpires

Geeft aan of het wachtwoord van de nieuwe gebruiker verloopt.

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

-UserMayNotChangePassword

Geeft aan dat de gebruiker het wachtwoord voor het gebruikersaccount niet kan wijzigen.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

String

U kunt een tekenreeks doorsluisen naar deze cmdlet.

DateTime

U kunt een DateTime-object doorsluisen naar deze cmdlet.

Boolean

U kunt een Booleaanse waarde doorsluisen naar deze cmdlet.

SecureString

U kunt een beveiligde tekenreeks doorsluisen naar deze cmdlet.

Uitvoerwaarden

System.Management.Automation.SecurityAccountsManager.LocalUser

Met deze cmdlet wordt een LocalUser-object geretourneerd dat het gemaakte gebruikersaccount vertegenwoordigt.

Notities

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 punten . 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 voor LocalUser-, LocalGroup- en LocalPrincipal-objecten die de bron van het object beschrijven. De mogelijke bronnen zijn als volgt:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

Notitie

PrincipalSource wordt alleen ondersteund door Windows 10, Windows Server 2016 en latere versies van het Windows-besturingssysteem. Voor eerdere versies is de eigenschap leeg.