New-LocalUser 
	Skapar ett lokalt användarkonto.
Syntax
Password (Standard)
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
Cmdleten New-LocalUser skapar ett lokalt användarkonto. Den här cmdleten skapar ett lokalt användarkonto.
Anmärkning
Modulen Microsoft.PowerShell.LocalAccounts är inte tillgänglig i 32-bitars PowerShell i ett 64-bitarssystem.
Exempel
Exempel 1: Skapa ett användarkonto
New-LocalUser -Name 'User02' -Description 'Description of this account.' -NoPassword
Name    Enabled  Description
----    -------  -----------
User02  True     Description of this account.
Det här kommandot skapar ett lokalt användarkonto och anger inte parametrarna AccountExpires eller Password. Kontot upphör inte att gälla eller har ett lösenord.
Exempel 2: Skapa ett användarkonto som har ett lösenord
$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.
Det första kommandot använder cmdleten Read-Host för att be dig om ett lösenord. Kommandot lagrar lösenordet som en säker sträng i variabeln $Password.
Det andra kommandot skapar ett lokalt användarkonto och anger det nya kontots lösenord till den säkra sträng som lagras i $Password. Kommandot anger ett användarnamn, fullständigt namn och en beskrivning för användarkontot.
Parametrar
-AccountExpires 
		Anger när användarkontot upphör att gälla. Du kan använda cmdleten Get-Date för att hämta ett DateTime--objekt. Om du inte anger den här parametern upphör kontot inte att gälla.
Parameteregenskaper
| Typ: | DateTime | 
| Standardvärde: | None | 
| Stöder jokertecken: | False | 
| DontShow: | False | 
Parameteruppsättningar
(All)
| Position: | Named | 
| Obligatorisk: | False | 
| Värde från pipeline: | False | 
| Värde från pipeline efter egenskapsnamn: | True | 
| Värde från återstående argument: | False | 
-AccountNeverExpires  
		Anger att kontot inte upphör att gälla.
Parameteregenskaper
| Typ: | SwitchParameter | 
| Standardvärde: | None | 
| Stöder jokertecken: | False | 
| DontShow: | False | 
Parameteruppsättningar
(All)
| Position: | Named | 
| Obligatorisk: | False | 
| Värde från pipeline: | False | 
| Värde från pipeline efter egenskapsnamn: | True | 
| Värde från återstående argument: | False | 
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
| Typ: | SwitchParameter | 
| Standardvärde: | False | 
| Stöder jokertecken: | False | 
| DontShow: | False | 
| Alias: | jfr | 
Parameteruppsättningar
(All)
| Position: | Named | 
| Obligatorisk: | False | 
| Värde från pipeline: | False | 
| Värde från pipeline efter egenskapsnamn: | False | 
| Värde från återstående argument: | False | 
-Description
Anger en kommentar för användarkontot. Den maximala längden är 48 tecken.
Parameteregenskaper
| Typ: | String | 
| Standardvärde: | None | 
| Stöder jokertecken: | False | 
| DontShow: | False | 
Parameteruppsättningar
(All)
| Position: | Named | 
| Obligatorisk: | False | 
| Värde från pipeline: | False | 
| Värde från pipeline efter egenskapsnamn: | True | 
| Värde från återstående argument: | False | 
-Disabled
Anger att den här cmdleten skapar användarkontot som inaktiverat.
Parameteregenskaper
| Typ: | SwitchParameter | 
| Standardvärde: | None | 
| Stöder jokertecken: | False | 
| DontShow: | False | 
Parameteruppsättningar
(All)
| Position: | Named | 
| Obligatorisk: | False | 
| Värde från pipeline: | False | 
| Värde från pipeline efter egenskapsnamn: | True | 
| Värde från återstående argument: | False | 
-FullName 
		Anger det fullständiga namnet på användarkontot. Det fullständiga namnet skiljer sig från användarkontots användarnamn.
Parameteregenskaper
| Typ: | String | 
| Standardvärde: | None | 
| Stöder jokertecken: | False | 
| DontShow: | False | 
Parameteruppsättningar
(All)
| Position: | Named | 
| Obligatorisk: | False | 
| Värde från pipeline: | False | 
| Värde från pipeline efter egenskapsnamn: | True | 
| Värde från återstående argument: | False | 
-Name
Anger användarnamnet för användarkontot.
Ett användarnamn kan innehålla upp till 20 versaler eller gemener. Ett användarnamn får inte innehålla följande tecken:
              ", /, \, [, ], :, ;, |, =, , ,, +, *, ?, <, , >@
Ett användarnamn får inte bara bestå av perioder . eller blanksteg.
Parameteregenskaper
| Typ: | String | 
| Standardvärde: | None | 
| Stöder jokertecken: | False | 
| DontShow: | False | 
Parameteruppsättningar
(All)
| Position: | 0 | 
| Obligatorisk: | True | 
| Värde från pipeline: | True | 
| Värde från pipeline efter egenskapsnamn: | True | 
| Värde från återstående argument: | False | 
-NoPassword 
		Anger att användarkontot inte har något lösenord.
Parameteregenskaper
| Typ: | SwitchParameter | 
| Standardvärde: | None | 
| Stöder jokertecken: | False | 
| DontShow: | False | 
Parameteruppsättningar
					NoPassword 
					
				 
				| Position: | Named | 
| Obligatorisk: | True | 
| Värde från pipeline: | False | 
| Värde från pipeline efter egenskapsnamn: | True | 
| Värde från återstående argument: | False | 
-Password
Anger ett lösenord för användarkontot. Du kan använda Read-Host -AsSecureString, Get-Credentialeller ConvertTo-SecureString för att skapa ett SecureString--objekt för lösenordet.
Om du utelämnar parametrarna Password och NoPassword uppmanar New-LocalUser dig att ange den nya användarens lösenord.
Parameteregenskaper
| Typ: | SecureString | 
| Standardvärde: | None | 
| Stöder jokertecken: | False | 
| DontShow: | False | 
Parameteruppsättningar
Password
| Position: | Named | 
| Obligatorisk: | True | 
| Värde från pipeline: | False | 
| Värde från pipeline efter egenskapsnamn: | True | 
| Värde från återstående argument: | False | 
-PasswordNeverExpires  
		Anger om den nya användarens lösenord upphör att gälla.
Parameteregenskaper
| Typ: | SwitchParameter | 
| Standardvärde: | None | 
| Stöder jokertecken: | False | 
| DontShow: | False | 
Parameteruppsättningar
Password
| Position: | Named | 
| Obligatorisk: | False | 
| Värde från pipeline: | False | 
| Värde från pipeline efter egenskapsnamn: | True | 
| Värde från återstående argument: | False | 
-UserMayNotChangePassword    
		Anger att användaren inte kan ändra lösenordet för användarkontot.
Parameteregenskaper
| Typ: | SwitchParameter | 
| Standardvärde: | None | 
| Stöder jokertecken: | False | 
| DontShow: | False | 
Parameteruppsättningar
(All)
| Position: | Named | 
| Obligatorisk: | False | 
| Värde från pipeline: | False | 
| Värde från pipeline efter egenskapsnamn: | True | 
| Värde från återstående argument: | False | 
-WhatIf 
		Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.
Parameteregenskaper
| Typ: | SwitchParameter | 
| Standardvärde: | False | 
| Stöder jokertecken: | False | 
| DontShow: | False | 
| Alias: | Wi | 
Parameteruppsättningar
(All)
| Position: | Named | 
| Obligatorisk: | False | 
| Värde från pipeline: | False | 
| Värde från pipeline efter egenskapsnamn: | False | 
| Värde från återstående argument: | False | 
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
String
Du kan skicka en sträng till den här cmdleten.
DateTime
Du kan skicka ett DateTime- objekt till den här cmdleten.
Boolean
Du kan skicka ett booleskt värde till den här cmdleten.
SecureString
Du kan skicka en säker sträng till den här cmdleten.
Utdata
System.Management.Automation.SecurityAccountsManager.LocalUser
Den här cmdleten returnerar ett LocalUser- objekt som representerar det skapade användarkontot.
Kommentarer
Windows PowerShell innehåller följande alias för New-LocalUser:
- nlu
Ett användarnamn får inte vara identiskt med något annat användarnamn eller gruppnamn på datorn. Ett användarnamn får inte bara bestå av perioder . eller blanksteg. Ett användarnamn kan innehålla upp till 20 versaler eller gemener. Ett användarnamn får inte innehålla följande tecken:
              ", /, \, [, ], :, ;, |, =, , ,, +, *, ?, <, , >@
Ett lösenord kan innehålla upp till 127 tecken.
Egenskapen PrincipalSource är en egenskap på LocalUser, LocalGroupoch LocalPrincipal objekt som beskriver objektets källa. Möjliga källor är följande:
- Local
- Active Directory
- AzureAD
- MicrosoftAccount
Anmärkning
PrincipalSource stöds endast av Windows 10, Windows Server 2016 och senare versioner av Windows-operativsystemet. För tidigare versioner är egenskapen tom.