Dela via


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.