New-LocalUser
Membuat akun pengguna lokal.
Sintaks
New-LocalUser
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-Disabled]
[-FullName <String>]
[-Name] <String>
-Password <SecureString>
[-PasswordNeverExpires]
[-UserMayNotChangePassword]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-LocalUser
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-Disabled]
[-FullName <String>]
[-Name] <String>
[-NoPassword]
[-UserMayNotChangePassword]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
New-LocalUser
Cmdlet membuat akun pengguna lokal. Cmdlet ini membuat akun pengguna lokal.
Catatan
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 Read-Host
cmdlet untuk meminta kata sandi kepada Anda. Perintah menyimpan kata sandi sebagai string aman dalam $Password
variabel.
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 Get-Date
cmdlet untuk mendapatkan objek DateTime . Jika Anda tidak menentukan parameter ini, akun tidak akan kedaluwarsa.
Jenis: | DateTime |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-AccountNeverExpires
Menunjukkan bahwa akun tidak kedaluwarsa.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
Jenis: | SwitchParameter |
Alias: | cf |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Description
Menentukan komentar untuk akun pengguna. Panjang maksimum adalah 48 karakter.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Disabled
Menunjukkan bahwa cmdlet ini membuat akun pengguna sebagai dinonaktifkan.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-FullName
Menentukan nama lengkap untuk akun pengguna. Nama lengkap berbeda dari nama pengguna akun pengguna.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | 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 boleh hanya terdiri dari titik .
atau spasi.
Jenis: | String |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-NoPassword
Menunjukkan bahwa akun pengguna tidak memiliki kata sandi.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | 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 parameter Kata Sandi dan NoPassword , New-LocalUser
meminta kata sandi pengguna baru.
Jenis: | SecureString |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-PasswordNeverExpires
Menunjukkan apakah kata sandi pengguna baru kedaluwarsa.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-UserMayNotChangePassword
Menunjukkan bahwa pengguna tidak dapat mengubah kata sandi pada akun pengguna.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Jenis: | SwitchParameter |
Alias: | wi |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
Input
Anda dapat menyalurkan string ke cmdlet ini.
Anda dapat menyalurkan objek DateTime ke cmdlet ini.
Anda dapat menyalurkan nilai boolean ke cmdlet ini.
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 boleh 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 menjelaskan sumber objek. Sumber yang mungkin adalah sebagai berikut:
Local
Active Directory
AzureAD
MicrosoftAccount
Catatan
PrincipalSource hanya didukung oleh Windows 10, Windows Server 2016, dan versi sistem operasi Windows yang lebih baru. Untuk versi yang lebih lama, properti kosong.