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.

Kommentar

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 Get-LocalUserav . 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 .

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AccountNeverExpires

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FullName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:Microsoft.PowerShell.Commands.LocalUser
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 Set-LocalUser Lösenord och NoPassword uppmanas du att ange användarens lösenord.

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordNeverExpires

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SID

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

Type:SecurityIdentifier
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-UserMayChangePassword

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 för LocalUser-, LocalGroup- och 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.