Dela via

New-LocalUser

  • Referens
Modul:
Microsoft.PowerShell.LocalAccounts

Skapar ett lokalt användarkonto.

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

Cmdleten New-LocalUser skapar ett lokalt användarkonto. Den här cmdleten skapar ett lokalt användarkonto.

Kommentar

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 uppmana dig att ange 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.

Typ:DateTime
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AccountNeverExpires

Anger att kontot inte upphör att gälla.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Description

Anger en kommentar för användarkontot. Den maximala längden är 48 tecken.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Disabled

Anger att den här cmdleten skapar användarkontot som inaktiverat.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-FullName

Anger det fullständiga namnet på användarkontot. Det fullständiga namnet skiljer sig från användarkontots användarnamn.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NoPassword

Anger att användarkontot inte har något lösenord.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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 New-LocalUser Lösenord och NoPassword uppmanas du att ange den nya användarens lösenord.

Typ:SecureString
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PasswordNeverExpires

Anger om den nya användarens lösenord upphör att gälla.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-UserMayNotChangePassword

Anger att användaren inte kan ändra lösenordet för användarkontot.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

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 för LocalUser-, LocalGroup- och LocalPrincipal-objekt som beskriver objektets källa. Möjliga källor är följande:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

Kommentar

PrincipalSource stöds endast av Windows 10, Windows Server 2016 och senare versioner av Windows-operativsystemet. För tidigare versioner är egenskapen tom.