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:
LocalActive DirectoryAzureADMicrosoftAccount
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.