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

Met de New-LocalUser cmdlet maakt u een lokaal gebruikersaccount. Met deze cmdlet maakt u een lokaal gebruikersaccount of een lokaal gebruikersaccount dat is verbonden met een Microsoft-account.

Notitie

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

Voorbeelden

Voorbeeld 1: Een gebruikersaccount maken

PS C:\> 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 geen accountexpires - of wachtwoordparameters op. Daarom verloopt het account niet of heeft het standaard een wachtwoord.

Voorbeeld 2: Een gebruikersaccount met een wachtwoord maken

PS C:\> $Password = Read-Host -AsSecureString
PS C:\> New-LocalUser "User03" -Password $Password -FullName "Third User" -Description "Description of this account."
Name    Enabled  Description
----    -------  -----------
User03  True     Description of this account.

Met de eerste opdracht wordt u om een wachtwoord gevraagd met behulp van de Read-Host cmdlet. Met de opdracht wordt het wachtwoord opgeslagen als een beveiligde tekenreeks in de $Password variabele.

Met de tweede opdracht maakt u een lokaal gebruikersaccount met behulp van het wachtwoord dat 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. Gebruik de Get-Date cmdlet om een DateTime-object op te halen. Als u deze parameter niet opgeeft, verloopt het account niet.

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

-AccountNeverExpires

Geeft aan dat het account niet verloopt.

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

-Beschrijving

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

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

-Name

Hiermee geeft u de gebruikersnaam voor het gebruikersaccount op.

Als u een lokaal gebruikersaccount voor het lokale systeem maakt, kan de gebruikersnaam 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
Accept pipeline input:	True
Accept wildcard characters:	False

-NoPassword

Geeft aan dat het gebruikersaccount geen wachtwoord heeft.

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

-Password

Hiermee geeft u een wachtwoord voor het gebruikersaccount op. U kunt een Get-CredentialSecureString-object voor het wachtwoord gebruiken Read-Host -AsSecureStringof ConvertTo-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
Accept pipeline input:	True
Accept wildcard characters:	False

-PasswordNeverExpires

Geeft aan of het wachtwoord verloopt.

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

-Uitgeschakeld

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

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

Invoerwaarden

System.String, System.DateTime, System.Boolean, System.Security.SecureString

U kunt een tekenreeks, een DateTime-object , een Booleaanse waarde of een beveiligde tekenreeks doorversluisen naar deze cmdlet.

Uitvoerwaarden

System.Management.Automation.SecurityAccountsManager.LocalUser

Met deze cmdlet wordt een LocalUser-object geretourneerd. Dit object bevat informatie over het gebruikersaccount.

Notities

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: