Remove-ItemProperty

Referensi

Modul:: Microsoft.PowerShell.Management

Menghapus properti dan nilainya dari item.

Sintaks

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

Deskripsi

cmdlet Remove-ItemProperty menghapus properti dan nilainya dari item. Anda dapat menggunakannya untuk menghapus nilai registri dan data yang disimpannya.

Contoh

Contoh 1: Menghapus nilai registri

Perintah ini menghapus nilai registri "SmpProperty", dan datanya, dari subkunjung "SmpApplication" dari kunci registri HKEY_LOCAL_MACHINE\Software.

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

Karena perintah dikeluarkan dari drive sistem file (PS C:\>), perintah tersebut mencakup jalur lengkap subkunci "SmpApplication", termasuk drive, HKLM:, dan kunci "Software".

Contoh 2: Menghapus nilai registri dari lokasi HKCU

Perintah ini menghapus nilai registri "Opsi", dan datanya, dari subkunci "MyApp" dari "HKEY_CURRENT_USER\Software\MyCompany".

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

Perintah pertama menggunakan cmdlet Set-Location untuk mengubah lokasi saat ini ke drive HKEY_CURRENT_USER (HKCU:) dan subkuntah Software\MyCompany\MyApp.

Perintah kedua menggunakan Remove-ItemProperty untuk menghapus nilai registri "Options", dan datanya, dari subkunci "MyApp". Karena Jalur diperlukan, perintah menggunakan titik (.) untuk menunjukkan lokasi saat ini. Parameter Konfirmasi meminta permintaan pengguna sebelum menghapus nilai.

Contoh 3: Menghapus nilai registri dengan menggunakan alur

Perintah ini menghapus nilai registri "NoOfEmployees", dan datanya, dari kunci registri HKLM\Software\MyCompany.

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

Perintah menggunakan cmdlet Get-Item untuk mendapatkan item yang mewakili kunci registri. Ini menggunakan operator alur (|) untuk mengirim objek ke Remove-ItemProperty. Kemudian, ia menggunakan parameter Nama dari Remove-ItemProperty untuk menentukan nama nilai registri.

Parameter

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Credential

Nota

Parameter ini tidak didukung oleh penyedia apa pun yang diinstal dengan PowerShell. Untuk meniru pengguna lain, atau meningkatkan kredensial Anda saat menjalankan cmdlet ini, gunakan Invoke-Command.

Jenis:	PSCredential
Position:	Named
Nilai default:	Current user
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	False

-Exclude

Menentukan item atau beberapa item yang dikecualikan dalam operasi ini dalam bentuk array string untuk cmdlet ini. Nilai parameter ini memenuhi syarat parameter Jalur. Masukkan elemen atau pola jalur, seperti *.txt. Karakter wildcard diizinkan. Parameter Kecuali efektif hanya ketika perintah memuat isi item, seperti C:\Windows\*, di mana karakter kartu bebas menentukan isi direktori C:\Windows.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	True

-Filter

Menentukan filter untuk memenuhi syarat parameter Jalur. Penyedia FileSystem adalah satu-satunya penyedia PowerShell yang diinstal yang mendukung penggunaan filter. Anda dapat menemukan sintaks untuk bahasa filter FileSystem dalam about_Wildcards. Filter lebih efisien daripada parameter lain, karena penyedia menerapkannya ketika cmdlet mendapatkan objek, daripada PowerShell memfilter objek setelah diambil.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	True

-Force

Memaksa cmdlet untuk menghapus properti objek yang tidak dapat diakses oleh pengguna. Implementasi bervariasi dari penyedia ke penyedia. Untuk informasi selengkapnya, lihat about_Providers.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Include

Menspesifikasikan, sebagai array string, satu atau beberapa item yang disertakan cmdlet ini dalam operasi. Nilai parameter ini memenuhi syarat parameter Jalur. Masukkan elemen atau pola jalur, seperti "*.txt". Karakter wildcard diizinkan. Parameter Sertakan hanya efektif ketika perintah menyertakan konten item, seperti C:\Windows\*, di mana karakter wildcard menentukan konten direktori C:\Windows.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	True

-LiteralPath

Menentukan jalur ke satu atau beberapa lokasi. Nilai LiteralPath digunakan persis seperti yang diketik. Tidak ada karakter yang ditafsirkan sebagai karakter pengganti. Jika jalur menyertakan karakter escape, sertakan dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.

Untuk informasi selengkapnya, lihat about_Quoting_Rules.

Jenis:	String[]
Alias:	PSPath, LP
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-Name

Menentukan nama properti yang akan dihapus. Karakter wildcard diizinkan.

Jenis:	String[]
Alias:	PSProperty
Position:	1
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	True

-Path

Menentukan jalur item yang propertinya sedang dihapus. Karakter wildcard diizinkan.

Jenis:	String[]
Position:	0
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	True

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet dijalankan. Cmdlet tidak dijalankan.

Jenis:	SwitchParameter
Alias:	wi
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

Input

String

Anda dapat menyalurkan string yang berisi jalur, tetapi bukan jalur harfiah, ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

PowerShell menyertakan alias berikut untuk Remove-ItemProperty:

Semua platform:
- rp
Di penyedia PowerShell Registry, nilai registri dianggap sebagai properti kunci registri atau subkunci. Anda dapat menggunakan cmdlet ItemProperty untuk mengelola nilai-nilai ini.
Remove-ItemProperty dirancang untuk bekerja dengan data yang diekspos oleh penyedia mana pun. Untuk mencantumkan penyedia yang tersedia dalam sesi Anda, ketik Get-PSProvider. Untuk informasi selengkapnya, lihat about_Providers.