Set-LocalUser

  • Reference
Modul:
Microsoft.PowerShell.LocalAccounts

Upraví místní uživatelský účet.

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

Rutina Set-LocalUser upraví místní uživatelský účet. Tato rutina může resetovat heslo místního uživatelského účtu.

Poznámka:

Modul Microsoft.PowerShell.LocalAccounts není k dispozici v 32bitovém PowerShellu v 64bitovém systému.

Příklady

Příklad 1: Změna popisu uživatelského účtu

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

Tento příkaz změní popis uživatelského účtu s názvem Správa 07.

Příklad 2: Změna hesla účtu

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

První příkaz vás vyzve k zadání hesla pomocí rutiny Read-Host. Příkaz uloží heslo jako zabezpečený řetězec do proměnné $Password.

Druhý příkaz získá uživatelský účet s názvem User02 pomocí .Get-LocalUser Příkaz uloží účet do proměnné $UserAccount.

Třetí příkaz nastaví nové heslo pro uživatelský účet uložený v $UserAccount.

Parametry

-AccountExpires

Určuje, kdy vyprší platnost uživatelského účtu. K získání objektu DateTime použijte rutinu Get-Date .

Pokud nechcete, aby platnost účtu vypršela, zadejte parametr AccountNeverExpires .

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

-AccountNeverExpires

Označuje, že platnost účtu nevyprší.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Description

Určuje komentář pro uživatelský účet. Maximální délka je 48 znaků.

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

-FullName

Určuje celé jméno uživatelského účtu. Celé jméno se liší od uživatelského jména uživatelského účtu.

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

-InputObject

Určuje uživatelský účet, který tato rutina změní. K získání uživatelského účtu použijte rutinu Get-LocalUser .

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

-Name

Určuje název uživatelského účtu, který tato rutina změní.

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

-Password

Určuje heslo pro uživatelský účet. Pokud je uživatelský účet připojený k účtu Microsoft, nenastavujte heslo.

Můžete použít Read-Host -AsSecureString, Get-Credentialnebo ConvertTo-SecureString vytvořit SecureString objekt pro heslo.

Pokud parametry Password a NoPassword vynecháte, Set-LocalUser zobrazí se výzva k zadání hesla uživatele.

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

-PasswordNeverExpires

Určuje, jestli platnost hesla vyprší.

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

-SID

Určuje ID zabezpečení (SID) uživatelského účtu, který tato rutina změní.

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

-UserMayChangePassword

Označuje, že uživatel může změnit heslo uživatelského účtu.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

System.Management.Automation.SecurityAccountsManager.LocalUser

Do této rutiny můžete převést místního uživatele.

String

Do této rutiny můžete zamísit řetězec.

SecurityIdentifier

Identifikátor SID můžete do této rutiny převést.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

Windows PowerShell obsahuje následující aliasy pro Set-LocalUser:

  • slu

PrincipalSource vlastnost je vlastnost localUser, LocalGroup a LocalPrincipal objekty, které popisují zdroj objektu. Možné zdroje jsou následující:

  • Místní
  • Active Directory
  • Skupina Microsoft Entra
  • Účet Microsoft

PrincipalSource podporuje jenom Windows 10, Windows Server 2016 a novější verze operačního systému Windows. U starších verzí je tato vlastnost prázdná.