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 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 polecenia Get-LocalUser. Polecenie przechowuje konto w zmiennej $UserAccount.

Trzecie polecenie ustawia nowe hasło na koncie użytkownika przechowywanym w programie $UserAccount.

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
Accept pipeline input:False
Accept wildcard characters:False
-AccountNeverExpires

Wskazuje, że konto nie wygasa.

Type:SwitchParameter
Position:Named
Default value:None
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
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
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
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
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
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 ustawiaj hasła.

Można 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 zostanie wyświetlony monit o podanie hasła użytkownika.

Type:SecureString
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PasswordNeverExpires

Wskazuje, czy hasło wygasa.

Type:Boolean
Position:Named
Default value:None
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
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
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
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

System.Management.Automation.SecurityAccountsManager.LocalUser, System.String, System.Security.Principal.SecurityIdentifier

Do tego polecenia cmdlet można przekazać potok użytkownika lokalnego, ciąg lub identyfikator SID.

Dane wyjściowe

None

To polecenie cmdlet nie generuje żadnych danych wyjściowych.

Uwagi

  • Właściwość PrincipalSource jest właściwością obiektów LocalUser, LocalGroup i LocalPrincipal opisujących źródło obiektu. Możliwe źródła są następujące:

  • Lokalne

  • Active Directory

  • Grupa usługi Azure Active Directory

  • Konto Microsoft

Element PrincipalSource jest obsługiwany tylko przez Windows 10, Windows Server 2016 i nowsze wersje systemu operacyjnego Windows. W przypadku wcześniejszych wersji właściwość jest pusta.