Set-LocalUser
Modyfikuje konto użytkownika lokalnego.
Składnia
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>]
Opis
Polecenie Set-LocalUser
cmdlet modyfikuje konto użytkownika lokalnego. To polecenie cmdlet może zresetować hasło konta użytkownika lokalnego.
Uwaga
Moduł Microsoft.PowerShell.LocalAccounts nie jest dostępny w 32-bitowym programie PowerShell w systemie 64-bitowym.
Przykłady
Przykład 1. Zmiana opisu konta użytkownika
Set-LocalUser -Name "Admin07" -Description "Description of this account."
To polecenie zmienia opis konta użytkownika o nazwie Administracja 07.
Przykład 2. Zmiana hasła na koncie
$Password = Read-Host -AsSecureString
$UserAccount = Get-LocalUser -Name "User02"
$UserAccount | Set-LocalUser -Password $Password
Pierwsze polecenie wyświetla monit o hasło przy użyciu polecenia cmdlet Read-Host. Polecenie przechowuje hasło jako bezpieczny ciąg w zmiennej $Password.
Drugie polecenie pobiera konto użytkownika o nazwie User02 przy użyciu polecenia Get-LocalUser
. Polecenie przechowuje konto w zmiennej $UserAccount.
Trzecie polecenie ustawia nowe hasło na koncie użytkownika przechowywanym w $UserAccount
programie .
Parametry
-AccountExpires
Określa, kiedy konto użytkownika wygasa. Aby uzyskać obiekt DateTime , użyj Get-Date
polecenia cmdlet .
Jeśli nie chcesz, aby konto wygasało, określ parametr AccountNeverExpires .
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AccountNeverExpires
Wskazuje, że konto nie wygasa.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Określa komentarz dla konta użytkownika. Maksymalna długość to 48 znaków.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FullName
Określa pełną nazwę konta użytkownika. Pełna nazwa różni się od nazwy użytkownika konta użytkownika.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Określa konto użytkownika, które zmienia to polecenie cmdlet. Aby uzyskać konto użytkownika, użyj Get-LocalUser
polecenia cmdlet .
Type: | Microsoft.PowerShell.Commands.LocalUser |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Określa nazwę konta użytkownika, które zmienia to polecenie cmdlet.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Password
Określa hasło dla konta użytkownika. Jeśli konto użytkownika jest połączone z kontem Microsoft, nie należy ustawiać hasła.
Możesz użyć metody Read-Host -AsSecureString
, Get-Credential
lub ConvertTo-SecureString
, aby utworzyć obiekt SecureString dla hasła.
Jeśli pominięto parametry Password i NoPassword , Set-LocalUser
zostanie wyświetlony monit o podanie hasła użytkownika.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordNeverExpires
Wskazuje, czy hasło wygasa.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SID
Określa identyfikator zabezpieczeń (SID) konta użytkownika, które zmienia to polecenie cmdlet.
Type: | SecurityIdentifier |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UserMayChangePassword
Wskazuje, że użytkownik może zmienić hasło na koncie użytkownika.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
System.Management.Automation.SecurityAccountsManager.LocalUser
Możesz przekazać użytkownikowi lokalnemu potok do tego polecenia cmdlet.
Możesz przekazać ciąg do tego polecenia cmdlet.
Do tego polecenia cmdlet można przekazać identyfikator SID.
Dane wyjściowe
None
To polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Uwagi
Program Windows PowerShell zawiera następujące aliasy dla programu Set-LocalUser
:
slu
Właściwość PrincipalSource jest właściwością localuser, LocalGroup i LocalPrincipal obiektów opisujących źródło obiektu. Możliwe źródła są następujące:
- Lokalny
- Active Directory
- Grupa Microsoft Entra
- Microsoft Account
JednostkaSource jest obsługiwana tylko przez system Windows 10, Windows Server 2016 i nowsze wersje systemu operacyjnego Windows. W przypadku wcześniejszych wersji właściwość jest pusta.
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Już wkrótce: w ciągu 2024 r. będziemy stopniowo usuwać problemy z usługą GitHub jako mechanizm opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla