Set-LocalUser
Yerel kullanıcı hesabını değiştirir.
Syntax
Name (Varsayılan)
Set-LocalUser
[-Name] <String>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Set-LocalUser
[-InputObject] <LocalUser>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Set-LocalUser
[-SID] <SecurityIdentifier>
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-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.
Uyarı
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.
Parametre özellikleri
| Tür: | DateTime |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-AccountNeverExpires
Hesabın süresinin dolmadığını gösterir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Description
Kullanıcı hesabı için bir açıklama belirtir. Uzunluk üst sınırı 48 karakterdir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | Microsoft.PowerShell.Commands.LocalUser |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
InputObject
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Name
Bu cmdlet'in değiştirdiğini kullanıcı hesabının adını belirtir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
Name
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 Read-Host -AsSecureString nesnesi oluşturmak için Get-Credential, ConvertTo-SecureStringveya kullanabilirsiniz.
Parola atlar ve NoPassword parametreleriniSet-LocalUser sizden kullanıcının parolasını ister.
Parametre özellikleri
| Tür: | SecureString |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-PasswordNeverExpires
Parolanın süresinin dolup dolmadığını gösterir.
Parametre özellikleri
| Tür: | Boolean |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-SID
Bu cmdlet'in değiştirdiğini kullanıcı hesabının güvenlik kimliğini (SID) belirtir.
Parametre özellikleri
| Tür: | SecurityIdentifier |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
SecurityIdentifier
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-UserMayChangePassword
Kullanıcının kullanıcı hesabındaki parolayı değiştirebileceğini gösterir.
Parametre özellikleri
| Tür: | Boolean |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
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:
- 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 özellik boştur.
