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 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, kullanarak Get-LocalUserUser02 adlı bir kullanıcı hesabı alır. komutu hesabı $UserAccount değişkeninde depolar.

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

Parametreler

-AccountExpires

Kullanıcı hesabının süresinin ne zaman doleceğini belirtir. Bir DateTime nesnesi almak için cmdlet'ini Get-Date 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 cmdlet'ini Get-LocalUser 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 , Get-Credentialveya ConvertTo-SecureString kullanabilirsinizRead-Host -AsSecureString.

Password ve NoPassword parametrelerini atlarsanız, Set-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ıyorsa 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 için aşağıdaki diğer adları Set-LocalUseriçerir:

  • slu

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

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