Aracılığıyla paylaş

Set-LocalUser

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

Yerel kullanıcı hesabını değiştirir.

Sözdizimi

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

Description

Set-LocalUser cmdlet'i bir yerel kullanıcı hesabını değiştirir. Bu cmdlet, yerel bir kullanıcı hesabının parolasını sıfırlayabilir.

Not

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

Örnekler

Örnek 1: Kullanıcı hesabının açıklamasını değiştirme

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

Bu komut Admin07 adlı bir kullanıcı hesabının açıklamasını değiştirir.

Örnek 2: Hesapta parolayı değiştirme

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

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

İkinci komut, Get-LocalUserkullanarak User02 adlı bir kullanıcı hesabı alır. komutu hesabı $UserAccount değişkeninde depolar.

Üçüncü komut, $UserAccountiçinde depolanan kullanıcı hesabında yeni parolayı ayarlar.

Parametreler

-AccountExpires

Kullanıcı hesabının süresinin ne zaman doleceğini belirtir. DateTime nesnesi almak için Get-Date cmdlet'ini kullanın.

Hesabın süresinin dolmasını istemiyorsanız AccountNeverExpires parametresini belirtin.

Tür:DateTime
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-AccountNeverExpires

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

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

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

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Description

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

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-InputObject

Bu cmdlet'in değiştirdiğini kullanıcı hesabını belirtir. Kullanıcı hesabı almak için Get-LocalUser cmdlet'ini kullanın.

Tür:Microsoft.PowerShell.Commands.LocalUser
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Name

Bu cmdlet'in değiştirdiğini kullanıcı hesabının adını belirtir.

Tür:String
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Password

Kullanıcı hesabı için bir parola belirtir. Kullanıcı hesabı bir Microsoft hesabına bağlıysa parola ayarlamayın.

parola için bir SecureString nesnesi oluşturmak için Read-Host -AsSecureString, Get-Credentialveya ConvertTo-SecureString kullanabilirsiniz.

Parola atlar ve NoPassword parametreleriniSet-LocalUser sizden kullanıcının parolasını ister.

Tür:SecureString
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PasswordNeverExpires

Parolanın süresinin dolup dolmadığını gösterir.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SID

Bu cmdlet'in değiştirdiğini kullanıcı hesabının güvenlik kimliğini (SID) belirtir.

Tür:SecurityIdentifier
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-UserMayChangePassword

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

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

System.Management.Automation.SecurityAccountsManager.LocalUser

Yerel kullanıcıyı bu cmdlet'e yöneltebilirsiniz.

String

Bir dizeyi bu cmdlet'e yöneltebilirsiniz.

SecurityIdentifier

Sid'yi bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

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

  • slu

PrincipalSource özelliği, LocalUser, LocalGroupve nesnenin kaynağını açıklayan LocalPrincipal nesneleri üzerindeki bir özelliktir. Olası kaynaklar şunlardır:

  • Yöresel
  • Active Directory
  • Microsoft Entra grubu
  • Microsoft Hesabı

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