Set-LocalUser

  • Reference
Modul:
Microsoft.PowerShell.LocalAccounts

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

Syntaxe

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 Admin07.

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 .

Typ:DateTime
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AccountNeverExpires

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

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

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Description

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 .

Typ:Microsoft.PowerShell.Commands.LocalUser
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

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

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:SecureString
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PasswordNeverExpires

Určuje, jestli platnost hesla vyprší.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SID

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

Typ:SecurityIdentifier
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-UserMayChangePassword

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

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

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

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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á.