Share via

Set-LocalUser

  • Referensi
Modul:
Microsoft.PowerShell.LocalAccounts

Memodifikasi akun pengguna lokal.

Sintaks

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

Deskripsi

Set-LocalUser Cmdlet memodifikasi akun pengguna lokal. Cmdlet ini dapat mengatur ulang kata sandi akun pengguna lokal.

Catatan

Modul Microsoft.PowerShell.LocalAccounts tidak tersedia di PowerShell 32-bit pada sistem 64-bit.

Contoh

Contoh 1: Mengubah deskripsi akun pengguna

Set-LocalUser -Name "Admin07" -Description "Description of this account."

Perintah ini mengubah deskripsi akun pengguna bernama Admin07.

Contoh 2: Mengubah kata sandi pada akun

$Password = Read-Host -AsSecureString
$UserAccount = Get-LocalUser -Name "User02"
$UserAccount | Set-LocalUser -Password $Password

Perintah pertama meminta kata sandi dengan menggunakan cmdlet Read-Host. Perintah menyimpan kata sandi sebagai string aman dalam variabel $Password.

Perintah kedua mendapatkan akun pengguna bernama User02 dengan menggunakan Get-LocalUser. Perintah menyimpan akun dalam variabel $UserAccount.

Perintah ketiga mengatur kata sandi baru pada akun pengguna yang disimpan di $UserAccount.

Parameter

-AccountExpires

Menentukan kapan akun pengguna kedaluwarsa. Untuk mendapatkan objek DateTime , gunakan Get-Date cmdlet .

Jika Anda tidak ingin akun kedaluwarsa, tentukan parameter AccountNeverExpires .

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AccountNeverExpires

Menunjukkan bahwa akun tidak kedaluwarsa.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Menentukan komentar untuk akun pengguna. Panjang maksimum adalah 48 karakter.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FullName

Menentukan nama lengkap untuk akun pengguna. Nama lengkap berbeda dari nama pengguna akun pengguna.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Menentukan akun pengguna yang diubah cmdlet ini. Untuk mendapatkan akun pengguna, gunakan Get-LocalUser cmdlet .

Type:Microsoft.PowerShell.Commands.LocalUser
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Menentukan nama akun pengguna yang diubah cmdlet ini.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Password

Menentukan kata sandi untuk akun pengguna. Jika akun pengguna tersambung ke akun Microsoft, jangan atur kata sandi.

Anda dapat menggunakan Read-Host -AsSecureString, Get-Credential, atau ConvertTo-SecureString untuk membuat objek SecureString untuk kata sandi.

Jika Anda menghilangkan parameter Kata Sandi dan NoPassword , Set-LocalUser meminta kata sandi pengguna.

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

-PasswordNeverExpires

Menunjukkan apakah kata sandi kedaluwarsa.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SID

Menentukan ID keamanan (SID) akun pengguna yang diubah cmdlet ini.

Type:SecurityIdentifier
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-UserMayChangePassword

Menunjukkan bahwa pengguna dapat mengubah kata sandi pada akun pengguna.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

System.Management.Automation.SecurityAccountsManager.LocalUser

Anda dapat menyalurkan pengguna lokal ke cmdlet ini.

String

Anda dapat menyalurkan string ke cmdlet ini.

SecurityIdentifier

Anda dapat menyalurkan SID ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

Windows PowerShell menyertakan alias berikut untuk Set-LocalUser:

  • slu

Properti PrincipalSource adalah properti pada objek LocalUser, LocalGroup, dan LocalPrincipal yang menjelaskan sumber objek. Sumber yang mungkin adalah sebagai berikut:

  • Lokal
  • Direktori Aktif
  • Grup Microsoft Entra
  • Akun Microsoft

PrincipalSource hanya didukung oleh Windows 10, Windows Server 2016, dan versi sistem operasi Windows yang lebih baru. Untuk versi yang lebih lama, properti kosong.