Bagikan melalui

New-LocalUser

  • Referensi
Modul:
Microsoft.PowerShell.LocalAccounts

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.

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

-AccountNeverExpires

Menunjukkan bahwa akun tidak kedaluwarsa.

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

-Disabled

Menunjukkan bahwa cmdlet ini membuat akun pengguna sebagai dinonaktifkan.

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

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

-NoPassword

Menunjukkan bahwa akun pengguna tidak memiliki kata sandi.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-PasswordNeverExpires

Menunjukkan apakah kata sandi pengguna baru kedaluwarsa.

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

-UserMayNotChangePassword

Menunjukkan bahwa pengguna tidak dapat mengubah kata sandi pada akun pengguna.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

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