Set-LocalUser
Modyfikuje konto użytkownika lokalnego.
Składnia
Name (domyślnie)
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>]
Opis
Polecenie cmdlet Set-LocalUser modyfikuje konto użytkownika lokalnego. To polecenie cmdlet może zresetować hasło konta użytkownika lokalnego.
Uwaga / Notatka
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 Admin07.
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 Get-LocalUser. Polecenie przechowuje konto w zmiennej $UserAccount.
Trzecie polecenie ustawia nowe hasło na koncie użytkownika przechowywanym w $UserAccount.
Parametry
-AccountExpires
Określa, kiedy konto użytkownika wygasa. Aby uzyskać obiekt DateTime, użyj polecenia cmdlet Get-Date.
Jeśli nie chcesz, aby konto wygasało, określ parametr AccountNeverExpires.
Właściwości parametru
| Typ: | DateTime |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-AccountNeverExpires
Wskazuje, że konto nie wygasa.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Description
Określa komentarz dla konta użytkownika. Maksymalna długość to 48 znaków.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-FullName
Określa pełną nazwę konta użytkownika. Pełna nazwa różni się od nazwy użytkownika konta użytkownika.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-InputObject
Określa konto użytkownika, które zmienia to polecenie cmdlet. Aby uzyskać konto użytkownika, użyj polecenia cmdlet Get-LocalUser.
Właściwości parametru
| Typ: | Microsoft.PowerShell.Commands.LocalUser |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
InputObject
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Name
Określa nazwę konta użytkownika, które zmienia to polecenie cmdlet.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Name
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | 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ć Read-Host -AsSecureString, Get-Credentiallub ConvertTo-SecureString, aby utworzyć obiekt SecureString dla hasła.
Jeśli pominięto parametry Password i NoPassword, Set-LocalUser wyświetli monit o podanie hasła użytkownika.
Właściwości parametru
| Typ: | SecureString |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-PasswordNeverExpires
Wskazuje, czy hasło wygasa.
Właściwości parametru
| Typ: | Boolean |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-SID
Określa identyfikator zabezpieczeń (SID) konta użytkownika, które zmienia to polecenie cmdlet.
Właściwości parametru
| Typ: | SecurityIdentifier |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
SecurityIdentifier
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-UserMayChangePassword
Wskazuje, że użytkownik może zmienić hasło na koncie użytkownika.
Właściwości parametru
| Typ: | Boolean |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
System.Management.Automation.SecurityAccountsManager.LocalUser
Możesz przekazać użytkownikowi lokalnemu potok do tego polecenia cmdlet.
String
Możesz przesłać ciąg do tego polecenia cmdlet.
SecurityIdentifier
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 Set-LocalUser:
slu
Właściwość PrincipalSource jest właściwością obiektów LocalUser, LocalGroupi LocalPrincipal, która opisuje źródło obiektu. Możliwe źródła są następujące:
- Lokalny
- Active Directory
- Grupa Microsoft Entra
- Konto Microsoft
PrincipalSource 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.
