Remove-ItemProperty (Microsoft.PowerShell.Management)

Remove-ItemProperty

Modül:

Microsoft.PowerShell.Management

Bir öğeden özelliği ve değerini siler.

Sözdizimi

Remove-ItemProperty
      [-Path] <String[]>
      [-Name] <String[]>
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-InformationAction <ActionPreference>]
      [-InformationVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-ItemProperty
      -LiteralPath <String[]>
      [-Name] <String[]>
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Tanım

Remove-ItemProperty cmdlet'i bir öğeden bir özelliği ve değerini siler. Kayıt defteri değerlerini ve depoladıkları verileri silmek için bunu kullanabilirsiniz.

Örnekler

Örnek 1: Kayıt defteri değerini silme

Bu komut, "SmpProperty" kayıt defteri değerini ve verilerini HKEY_LOCAL_MACHINE\Software kayıt defteri anahtarının "SmpApplication" alt anahtarından siler.

Remove-ItemProperty -Path "HKLM:\Software\SmpApplication" -Name "SmpProperty"

Komut bir dosya sistemi sürücüsünden (PS C:\>) verildiği için, HKLM: ve "Yazılım" tuşuna basın.

Örnek 2: HKCU konumundan bir kayıt defteri değerini silin

Bu komutlar, "HKEY_CURRENT_USER\Software\MyCompany"nin "Uygulamam" alt anahtarındaki "Seçenekler" kayıt defteri değerini ve verilerini siler.

PS C:\> Set-Location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> Remove-ItemProperty -Path . -Name "Options" -Confirm

İlk komut, geçerli konumu HKEY_CURRENT_USER sürücüsüne (HKCU:) ve Software\'e değiştirmek için Set-Location cmdlet'ini kullanır. Şirketim\Uygulamam alt anahtarı.

İkinci komut, "Seçenekler" kayıt defteri değerini ve verilerini "Uygulamam" alt anahtarından kaldırmak için Remove-ItemProperty'i kullanır. Yol gerekli olduğundan, komut geçerli konumu belirtmek için bir nokta (.) kullanır. Onayla parametresi, değeri silmeden önce kullanıcıdan bir istem ister.

Örnek 3: İşlem hattını kullanarak bir kayıt defteri değerini kaldırma

Bu komut, "NoOfEmployees" kayıt defteri değerini ve verilerini HKLM\Software\MyCompany kayıt defteri anahtarından siler.

Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployees

Komut, kayıt defteri anahtarını temsil eden bir öğeyi almak için Get-Item cmdlet'ini kullanır. Nesneyi Remove-ItemProperty'e göndermek için bir ardışık düzen operatörü (|) kullanır. Daha sonra, kayıt defteri değerinin adını belirtmek için Remove-ItemProperty'nin Ad parametresini kullanır.

Parametreler

-Confirm

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

Tip :

SwitchParameter

Takma adlar:

cf

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Credential

Tip :

PSCredential'ı

Konum:

Adlandırılmış

Varsayılan değer:

Geçerli kullanıcı

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Exclude

Bu cmdlet'in işlemde hariç tuttuğu bir öğeyi veya öğeleri dize dizisi olarak belirtir. Bu parametrenin değeri Yol parametresini nitelendirir. *.txt gibi bir yol öğesi veya modeli girin. Joker karakterlere izin verilir. Hariç Tut parametresi yalnızca komut, C:\Windows\* gibi bir öğenin içeriğini içerdiğinde etkilidir; burada joker karakter, C:\Windows dizini.

Tip :

String[]

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

True

-Filter

Yol parametresini nitelendirecek bir filtre belirtir. FileSystem sağlayıcısı, filtre kullanımını destekleyen tek yüklü PowerShell sağlayıcısıdır. FileSystem filtre dilinin söz dizimini about_Wildcards'da bulabilirsiniz. Filtreler diğer parametrelerden daha etkilidir çünkü sağlayıcı, PowerShell'in nesneleri alındıktan sonra filtrelemesini sağlamak yerine cmdlet nesneleri aldığında bunları uygular.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

True

-Force

Kullanıcı tarafından başka şekilde erişilemeyen bir nesnenin özelliğini kaldırmak için cmdlet'i zorlar. Uygulama sağlayıcıdan sağlayıcıya değişir. Daha fazla bilgi için bkz. about_Providers.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Include

Bu cmdlet'in işleme dahil ettiği bir öğeyi veya öğeleri dize dizisi olarak belirtir. Bu parametrenin değeri Yol parametresini nitelendirir. "*.txt" gibi bir yol öğesi veya modeli girin. Joker karakterlere izin verilir. Dahil Et parametresi yalnızca komut, C:\Windows\* gibi bir öğenin içeriğini içerdiğinde etkilidir; burada joker karakter, C:\Windows dizini.

Tip :

String[]

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

True

-LiteralPath

Bir veya daha fazla konuma giden yolu belirtir. LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmaz. Yol kaçış karakterleri içeriyorsa, onu tek tırnak işaretleri içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamamasını söyler.

Daha fazla bilgi için bkz. about_Quoting_Rules.

Tip :

String[]

Takma adlar:

PSPath, LP

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Name

Kaldırılacak özelliklerin adlarını belirtir. Joker karakterlere izin verilir.

Tip :

String[]

Takma adlar:

PSProperty

Konum:

1

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

True

-Path

Özellikleri kaldırılmakta olan öğenin yolunu belirtir. Joker karakterlere izin verilir.

Tip :

String[]

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

True

-WhatIf

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

Tip :

SwitchParameter

Takma adlar:

wi

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

Dize

Bu cmdlet'e bir yol içeren ancak gerçek bir yol içermeyen bir dize yönlendirebilirsiniz.

Çıkışlar

Yok

Bu cmdlet hiçbir çıktı döndürmez.

Notlar

PowerShell, Remove-ItemProperty için aşağıdaki takma adları içerir:

• Tüm platformlar:

  rp

• PowerShell Kayıt Defteri sağlayıcısında kayıt defteri değerleri, bir kayıt defteri anahtarının veya alt anahtarının özellikleri olarak kabul edilir. Bu değerleri yönetmek için ItemProperty cmdlet'lerini kullanabilirsiniz.

• Remove-ItemProperty herhangi bir sağlayıcının açığa çıkardığı verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda mevcut olan sağlayıcıları listelemek için Get-PSProvider yazın. Daha fazla bilgi için bkz. about_Providers.