Aracılığıyla paylaş

New-LocalUser

  • Başvuru
Modül:
Microsoft.PowerShell.LocalAccounts

Yerel bir kullanıcı hesabı oluşturur.

Syntax

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

Description

New-LocalUser cmdlet'i bir yerel kullanıcı hesabı oluşturur. Bu cmdlet bir yerel kullanıcı hesabı oluşturur.

Not

Microsoft.PowerShell.LocalAccounts modülü 64 bit sistemdeki 32 bit PowerShell'de kullanılamaz.

Örnekler

Örnek 1: Kullanıcı hesabı oluşturma

New-LocalUser -Name 'User02' -Description 'Description of this account.' -NoPassword

Name    Enabled  Description
----    -------  -----------
User02  True     Description of this account.

Bu komut yerel bir kullanıcı hesabı oluşturur ve AccountExpires veya Password parametrelerini belirtmez. Hesabın süresi dolmuyor veya parolası var.

Örnek 2: Parolası olan bir kullanıcı hesabı oluşturma

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

İlk komut cmdlet'ini Read-Host kullanarak sizden parola ister. komutu, parolayı değişkeninde $Password güvenli bir dize olarak depolar.

İkinci komut bir yerel kullanıcı hesabı oluşturur ve yeni hesabın parolasını içinde $Passworddepolanan güvenli dizeye ayarlar. komutu, kullanıcı hesabı için bir kullanıcı adı, tam ad ve açıklama belirtir.

Parametreler

-AccountExpires

Kullanıcı hesabının süresinin ne zaman doleceğini belirtir. Bir DateTime nesnesi almak için cmdlet'ini kullanabilirsinizGet-Date. Bu parametreyi belirtmezseniz hesabın süresi dolmaz.

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

-AccountNeverExpires

Hesabın süresinin dolmadığını gösterir.

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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

-Description

Kullanıcı hesabı için bir açıklama belirtir. Uzunluk üst sınırı 48 karakterdir.

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

-Disabled

Bu cmdlet'in kullanıcı hesabını devre dışı olarak oluşturduğunu gösterir.

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

-FullName

Kullanıcı hesabının tam adını belirtir. Tam ad, kullanıcı hesabının kullanıcı adından farklıdır.

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

-Name

Kullanıcı hesabının kullanıcı adını belirtir.

Kullanıcı adı en fazla 20 büyük veya küçük karakter içerebilir. Kullanıcı adı aşağıdaki karakterleri içeremez:

", /, \, , [, ], :, , ;, |, =, ,, +, <*?, >,@

Kullanıcı adı yalnızca noktalardan veya boşluklardan . oluşamaz.

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

-NoPassword

Kullanıcı hesabının parolası olmadığını gösterir.

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

-Password

Kullanıcı hesabı için bir parola belirtir. Parola için bir SecureString nesnesi oluşturmak için , Get-Credentialveya ConvertTo-SecureString kullanabilirsinizRead-Host -AsSecureString.

Password ve NoPassword parametrelerini atlarsanız, New-LocalUser sizden yeni kullanıcının parolasını ister.

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

-PasswordNeverExpires

Yeni kullanıcının parolasının süresinin dolup dolmadığını gösterir.

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

-UserMayNotChangePassword

Kullanıcının kullanıcı hesabındaki parolayı değiştirediğini gösterir.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

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

Girişler

String

Bir dizeyi bu cmdlet'e yöneltebilirsiniz.

DateTime

Bir DateTime nesnesini bu cmdlet'e yöneltebilirsiniz.

Boolean

Bu cmdlet'e boole değeri yöneltebilirsiniz.

SecureString

Bu cmdlet'e güvenli bir dize yöneltebilirsiniz.

Çıkışlar

System.Management.Automation.SecurityAccountsManager.LocalUser

Bu cmdlet, oluşturulan kullanıcı hesabını temsil eden bir LocalUser nesnesi döndürür.

Notlar

Windows PowerShell için aşağıdaki diğer adları New-LocalUseriçerir:

  • nlu

Kullanıcı adı, bilgisayardaki diğer kullanıcı adı veya grup adıyla aynı olamaz. Kullanıcı adı yalnızca noktalardan veya boşluklardan . oluşamaz. Kullanıcı adı en fazla 20 büyük veya küçük karakter içerebilir. Kullanıcı adı aşağıdaki karakterleri içeremez:

", /, \, , [, ], :, , ;, |, =, ,, +, <*?, >,@

Parola en fazla 127 karakter içerebilir.

PrincipalSource özelliği LocalUser, LocalGroup ve LocalPrincipal nesnelerinde nesnenin kaynağını açıklayan bir özelliktir. Olası kaynaklar şunlardır:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

Not

PrincipalSource yalnızca Windows 10, Windows Server 2016 ve Windows işletim sisteminin sonraki sürümleri tarafından desteklenir. Önceki sürümler için özelliği boş.