Udostępnij za pośrednictwem

Set-LocalUser

  • Odwołanie
Moduł:
Microsoft.PowerShell.LocalAccounts

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 cmdlet Set-LocalUser modyfikuje konto użytkownika lokalnego. To polecenie cmdlet może zresetować hasło konta użytkownika lokalnego.

Nuta

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.

Typ:DateTime
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AccountNeverExpires

Wskazuje, że konto nie wygasa.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Description

Określa komentarz dla konta użytkownika. Maksymalna długość to 48 znaków.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FullName

Określa pełną nazwę konta użytkownika. Pełna nazwa różni się od nazwy użytkownika konta użytkownika.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Określa konto użytkownika, które zmienia to polecenie cmdlet. Aby uzyskać konto użytkownika, użyj polecenia cmdlet Get-LocalUser.

Typ:Microsoft.PowerShell.Commands.LocalUser
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę konta użytkownika, które zmienia to polecenie cmdlet.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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.

Typ:SecureString
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PasswordNeverExpires

Wskazuje, czy hasło wygasa.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SID

Określa identyfikator zabezpieczeń (SID) konta użytkownika, które zmienia to polecenie cmdlet.

Typ:SecurityIdentifier
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-UserMayChangePassword

Wskazuje, że użytkownik może zmienić hasło na koncie użytkownika.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

System.Management.Automation.SecurityAccountsManager.LocalUser

Możesz przekazać użytkownikowi lokalnemu potok do tego polecenia cmdlet.

String

Możesz przekazać 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ą LocalUser, LocalGroupi obiektów LocalPrincipal opisujących ź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.