Remove-ItemProperty

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

Özelliği ve değerini bir öğeden siler.

Syntax

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

Description

cmdlet bir Remove-ItemProperty özelliği ve değerini bir öğeden 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, kayıt defteri anahtarının "SmpApplication" alt anahtarından HKEY_LOCAL_MACHINE\Software "SmpProperty" kayıt defteri değerini ve verilerini siler.

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

Komut bir dosya sistemi sürücüsünden ()PS C:\> verildiğinden, sürücü HKLM:, ve "Yazılım" anahtarı dahil olmak üzere "SmpApplication" alt anahtarının tam yolunu içerir.

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

Bu komutlar "Options" kayıt defteri değerini ve verilerini "HKEY_CURRENT_USER\Software\MyCompany" alt anahtarından 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 alt anahtara değiştirmek için cmdlet'ini Software\MyCompany\MyApp kullanırSet-Location.

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

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

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

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

komut, kayıt defteri anahtarını temsil eden bir öğeyi almak için cmdlet'ini kullanır Get-Item . nesnesini Remove-ItemPropertyadresine göndermek için işlem hattı işlecini (|) kullanır. Ardından, kayıt defteri değerinin adını belirtmek için name parametresini Remove-ItemProperty kullanır.

Parametreler

-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

-Credential

Not

Bu parametre, PowerShell ile yüklenen hiçbir sağlayıcı tarafından desteklenmez. Başka bir kullanıcının kimliğine bürünmek veya bu cmdlet'i çalıştırırken kimlik bilgilerinizi yükseltmek için Invoke-Command kullanın.

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Exclude

Dize dizisi olarak, bu cmdlet'in işlemde hariç tutulduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. gibi *.txtbir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Exclude parametresi yalnızca komutu gibi C:\Windows\*bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter dizinin içeriğini C:\Windows belirtir.

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

-Filter

Path parametresini nitelemek için bir filtre belirtir. FileSystem sağlayıcısı, filtrelerin kullanımını destekleyen tek yüklü PowerShell sağlayıcısıdır. FileSystem filtre dilinin söz dizimini about_Wildcards bulabilirsiniz. Filtreler diğer parametrelerden daha verimlidir, çünkü sağlayıcı, nesneleri aldıktan sonra PowerShell'in filtrelemesini yapmak yerine cmdlet nesneleri aldığında bunları uygular.

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

-Force

Cmdlet'i, kullanıcı tarafından başka türlü erişilemeyen bir nesnenin özelliğini kaldırmaya zorlar. Uygulama sağlayıcıdan sağlayıcıya değişir. Daha fazla bilgi için bkz . about_Providers.

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

-Include

Dize dizisi olarak, bu cmdlet'in işleme dahil olduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. gibi "*.txt"bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Include parametresi yalnızca komutu gibi C:\Windows\*bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter dizinin içeriğini C:\Windows belirtir.

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

-LiteralPath

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

Daha fazla bilgi için bkz . about_Quoting_Rules.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Aliases:PSProperty
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Path

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

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

-WhatIf

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

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

Girişler

String

Bu cmdlet'e yol içeren ancak değişmez yol içermeyen bir dizeyi kanala aktarabilirsiniz.

Çıkışlar

None

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

Notlar

PowerShell için aşağıdaki diğer adları Remove-ItemPropertyiç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ı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için yazın Get-PSProvider. Daha fazla bilgi için bkz . about_Providers.