New-LocalUser
Membuat akun pengguna lokal.
Sintaks
Password (Default)
New-LocalUser
[-Name] <String>
-Password <SecureString>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-Disabled]
[-FullName <String>]
[-PasswordNeverExpires]
[-UserMayNotChangePassword]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NoPassword
New-LocalUser
[-Name] <String>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-Disabled]
[-FullName <String>]
[-NoPassword]
[-UserMayNotChangePassword]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
cmdlet New-LocalUser membuat akun pengguna lokal. Cmdlet ini membuat akun pengguna lokal.
Nota
Modul Microsoft.PowerShell.LocalAccounts tidak tersedia di PowerShell 32-bit pada sistem 64-bit.
Contoh
Contoh 1: Membuat akun pengguna
New-LocalUser -Name 'User02' -Description 'Description of this account.' -NoPassword
Name Enabled Description
---- ------- -----------
User02 True Description of this account.
Perintah ini membuat akun pengguna lokal dan tidak menentukan parameter AccountExpires atau Password. Akun tidak kedaluwarsa atau memiliki kata sandi.
Contoh 2: Membuat akun pengguna yang memiliki kata sandi
$Password = Read-Host -AsSecureString
$params = @{
Name = 'User03'
Password = $Password
FullName = 'Third User'
Description = 'Description of this account.'
}
New-LocalUser @params
Name Enabled Description
---- ------- -----------
User03 True Description of this account.
Perintah pertama menggunakan cmdlet Read-Host untuk meminta kata sandi kepada Anda. Perintah menyimpan kata sandi sebagai string aman dalam variabel $Password.
Perintah kedua membuat akun pengguna lokal dan mengatur kata sandi akun baru ke string aman yang disimpan di $Password. Perintah menentukan nama pengguna, nama lengkap, dan deskripsi untuk akun pengguna.
Parameter
-AccountExpires
Menentukan kapan akun pengguna kedaluwarsa. Anda dapat menggunakan cmdlet Get-Date untuk mendapatkan objek DateTime. Jika Anda tidak menentukan parameter ini, akun tidak akan kedaluwarsa.
Properti parameter
| Jenis: | DateTime |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-AccountNeverExpires
Menunjukkan bahwa akun tidak kedaluwarsa.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Description
Menentukan komentar untuk akun pengguna. Panjang maksimum adalah 48 karakter.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Disabled
Menunjukkan bahwa cmdlet ini membuat akun pengguna sebagai dinonaktifkan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-FullName
Menentukan nama lengkap untuk akun pengguna. Nama lengkap berbeda dari nama pengguna akun pengguna.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Name
Menentukan nama pengguna untuk akun pengguna.
Nama pengguna dapat berisi hingga 20 karakter huruf besar atau karakter huruf kecil. Nama pengguna tidak boleh berisi karakter berikut:
", , /, [\, ], :;, , |, =, ,, +, *, , ?, <, , >,@
Nama pengguna tidak dapat hanya terdiri dari titik . atau spasi.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-NoPassword
Menunjukkan bahwa akun pengguna tidak memiliki kata sandi.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
NoPassword
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Password
Menentukan kata sandi untuk akun pengguna. Anda dapat menggunakan Read-Host -AsSecureString, Get-Credential, atau ConvertTo-SecureString untuk membuat objek SecureString untuk kata sandi.
Jika Anda menghilangkan Kata Sandi dan parameter NoPassword, New-LocalUser meminta kata sandi pengguna baru.
Properti parameter
| Jenis: | SecureString |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
Password
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-PasswordNeverExpires
Menunjukkan apakah kata sandi pengguna baru kedaluwarsa.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
Password
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-UserMayNotChangePassword
Menunjukkan bahwa pengguna tidak dapat mengubah kata sandi pada akun pengguna.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
Input
String
Anda dapat menyalurkan string ke cmdlet ini.
DateTime
Anda dapat menyalurkan objek DateTime ke cmdlet ini.
Boolean
Anda dapat menyalurkan nilai boolean ke cmdlet ini.
SecureString
Anda dapat menyalurkan string aman ke cmdlet ini.
Output
System.Management.Automation.SecurityAccountsManager.LocalUser
Cmdlet ini mengembalikan objek LocalUser yang mewakili akun pengguna yang dibuat.
Catatan
Windows PowerShell menyertakan alias berikut untuk New-LocalUser:
nlu
Nama pengguna tidak bisa identik dengan nama pengguna atau nama grup lain di komputer. Nama pengguna tidak dapat hanya terdiri dari titik . atau spasi. Nama pengguna dapat berisi hingga 20 karakter huruf besar atau karakter huruf kecil. Nama pengguna tidak boleh berisi karakter berikut:
", , /, [\, ], :;, , |, =, ,, +, *, , ?, <, , >,@
Kata sandi dapat berisi hingga 127 karakter.
Properti PrincipalSource adalah properti pada objek LocalUser, LocalGroup, dan LocalPrincipal yang menggambarkan sumber dari objek tersebut. Sumber yang mungkin adalah sebagai berikut:
LocalActive DirectoryAzureADMicrosoftAccount
Nota
PrincipalSource hanya didukung oleh Windows 10, Windows Server 2016, dan versi sistem operasi Windows yang lebih baru. Untuk versi yang lebih lama, atributnya kosong.
