Dela via

Set-LocalUser

  • Referens
Modul:
Microsoft.PowerShell.LocalAccounts

Ändrar ett lokalt användarkonto.

Syntax

Set-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-FullName <String>]
   [-Name] <String>
   [-Password <SecureString>]
   [-PasswordNeverExpires <Boolean>]
   [-UserMayChangePassword <Boolean>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-FullName <String>]
   [-InputObject] <LocalUser>
   [-Password <SecureString>]
   [-PasswordNeverExpires <Boolean>]
   [-UserMayChangePassword <Boolean>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-LocalUser
   [-AccountExpires <DateTime>]
   [-AccountNeverExpires]
   [-Description <String>]
   [-FullName <String>]
   [-Password <SecureString>]
   [-PasswordNeverExpires <Boolean>]
   [-SID] <SecurityIdentifier>
   [-UserMayChangePassword <Boolean>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten Set-LocalUser ändrar ett lokalt användarkonto. Den här cmdleten kan återställa lösenordet för ett lokalt användarkonto.

Not

Modulen Microsoft.PowerShell.LocalAccounts är inte tillgänglig i 32-bitars PowerShell i ett 64-bitarssystem.

Exempel

Exempel 1: Ändra en beskrivning av ett användarkonto

Set-LocalUser -Name "Admin07" -Description "Description of this account."

Det här kommandot ändrar beskrivningen av ett användarkonto med namnet Admin07.

Exempel 2: Ändra lösenordet för ett konto

$Password = Read-Host -AsSecureString
$UserAccount = Get-LocalUser -Name "User02"
$UserAccount | Set-LocalUser -Password $Password

Det första kommandot uppmanar dig att ange ett lösenord med hjälp av cmdleten Read-Host. Kommandot lagrar lösenordet som en säker sträng i variabeln $Password.

Det andra kommandot hämtar ett användarkonto med namnet User02 med hjälp av Get-LocalUser. Kommandot lagrar kontot i variabeln $UserAccount.

Det tredje kommandot anger det nya lösenordet för användarkontot som lagras i $UserAccount.

Parametrar

-AccountExpires

Anger när användarkontot upphör att gälla. Om du vill hämta ett DateTime--objekt använder du cmdleten Get-Date.

Om du inte vill att kontot ska upphöra att gälla anger du parametern AccountNeverExpires.

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

-InputObject

Anger det användarkonto som den här cmdleten ändrar. Om du vill skaffa ett användarkonto använder du cmdleten Get-LocalUser.

Typ:Microsoft.PowerShell.Commands.LocalUser
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger namnet på det användarkonto som den här cmdleten ändras.

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

-Password

Anger ett lösenord för användarkontot. Om användarkontot är anslutet till ett Microsoft-konto ska du inte ange något lösenord.

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 Set-LocalUser dig att ange användarens lösenord.

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

-PasswordNeverExpires

Anger om lösenordet upphör att gälla.

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

-SID

Anger säkerhets-ID (SID) för användarkontot som den här cmdleten ändrar.

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

-UserMayChangePassword

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

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

-WhatIf

Visar vad som skulle hända om cmdleten körs. 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

System.Management.Automation.SecurityAccountsManager.LocalUser

Du kan skicka en lokal användare till den här cmdleten.

String

Du kan skicka en sträng till den här cmdleten.

SecurityIdentifier

Du kan skicka ett SID till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

Windows PowerShell innehåller följande alias för Set-LocalUser:

  • slu

Egenskapen PrincipalSource är en egenskap på LocalUser, LocalGroupoch LocalPrincipal objekt som beskriver objektets källa. Möjliga källor är följande:

  • Lokal
  • Active Directory
  • Microsoft Entra-grupp
  • Microsoft-konto

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