Set-LocalUser
Upraví místní uživatelský účet.
Syntax
Name (Výchozí)
Set-LocalUser
[-Name] <String>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Set-LocalUser
[-InputObject] <LocalUser>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Set-LocalUser
[-SID] <SecurityIdentifier>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-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 k uživatelskému účtu uloženému 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 AccountNeverExpires parametr.
Vlastnosti parametru
| Typ: | DateTime |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-AccountNeverExpires
Označuje, že platnost účtu nevyprší.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Description
Určuje komentář pro uživatelský účet. Maximální délka je 48 znaků.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InputObject
Určuje uživatelský účet, který tato rutina změní. Pokud chcete získat uživatelský účet, použijte rutinu Get-LocalUser.
Vlastnosti parametru
| Typ: | Microsoft.PowerShell.Commands.LocalUser |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
InputObject
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje název uživatelského účtu, který tato rutina změní.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Name
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Password
Určuje heslo pro uživatelský účet. Pokud je uživatelský účet připojený k účtu Microsoft, nenastavujte heslo.
K vytvoření objektu Read-Host -AsSecureString ing pro heslo můžete použít Get-Credential, ConvertTo-SecureStringnebo .
Pokud vynecháte parametry Password a NoPass word, Set-LocalUser vás vyzve k zadání hesla uživatele.
Vlastnosti parametru
| Typ: | SecureString |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-PasswordNeverExpires
Určuje, jestli platnost hesla vyprší.
Vlastnosti parametru
| Typ: | Boolean |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-SID
Určuje ID zabezpečení (SID) uživatelského účtu, který tato rutina změní.
Vlastnosti parametru
| Typ: | SecurityIdentifier |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
SecurityIdentifier
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-UserMayChangePassword
Označuje, že uživatel může změnit heslo uživatelského účtu.
Vlastnosti parametru
| Typ: | Boolean |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
System.Management.Automation.SecurityAccountsManager.LocalUser
Do této rutiny můžete převést místního uživatele.
String
Do tohoto příkazletu můžete přesměrovat řetězec.
SecurityIdentifier
Identifikátor SID můžete do této rutiny převést.
Výstupy
None
Tento cmdlet nevrátí žádný výstup.
Poznámky
Windows PowerShell obsahuje následující aliasy pro Set-LocalUser:
slu
Vlastnost PrincipalSource je vlastnost objektů LocalUser, LocalGroupa LocalPrincipal, která popisuje zdroj objektu. Možné zdroje jsou následující:
- Místní
- služba 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á.
