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 $UserAccountprogramie .

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

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