Remove-ItemProperty
Menghapus properti dan nilainya dari item.
Sintaks
Remove-ItemProperty
[-Path] <String[]>
[-Name] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Remove-ItemProperty
-LiteralPath <String[]>
[-Name] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Deskripsi
Remove-ItemProperty
Cmdlet 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 kunci registri "SmpApplication" dari kunci registri "HKEY_LOCAL_MACHINE\Software".
Karena perintah dikeluarkan dari drive sistem file (PS C:\>
), perintah ini mencakup jalur yang sepenuhnya memenuhi syarat dari subkunjung "SmpApplication", termasuk drive, HKLM:
, dan kunci "Perangkat Lunak".
Ini menggunakan parameter Nama untuk mengidentifikasi nilai registri yang sedang dihapus.
Remove-ItemProperty -Path "HKLM:\Software\SmpApplication" -Name "SmpProperty"
Contoh 2: Menghapus nilai registri dari lokasi HKCU
Perintah ini menghapus nilai registri "Opsi", dan datanya, dari subkuntah "MyApp" dari "HKEY_CURRENT_USER\Software\MyCompany".
Perintah pertama menggunakan Set-Location
cmdlet untuk mengubah lokasi saat ini ke drive HKEY_CURRENT_USER (HKCU:
) dan subkunji "Software\MyCompany\MyApp".
Perintah kedua menggunakan untuk menghapus nilai registri Remove-ItemProperty
"Opsi", dan datanya, dari subkuntang "MyApp".
Karena Jalur diperlukan, perintah menggunakan titik ('.') untuk menunjukkan lokasi saat ini.
Ini menggunakan Nama untuk menentukan nilai registri mana yang akan dihapus.
Ini menggunakan parameter Konfirmasi untuk meminta permintaan pengguna sebelum menghapus nilai.
PS C:\> Set-Location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> Remove-ItemProperty -Path . -Name "Options" -Confirm
Contoh 3: Menghapus nilai registri dengan menggunakan alur
Perintah ini menghapus nilai registri "NoOfEmployees", dan datanya, dari kunci registri "HKLM\Software\MyCompany".
Perintah menggunakan Get-Item
cmdlet untuk mendapatkan item yang mewakili kunci registri.
Ini menggunakan operator alur (|
) untuk mengirim objek ke Remove-ItemProperty
.
Kemudian, ia menggunakan parameter Remove-ItemProperty
Nama untuk menentukan nama nilai registri.
Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployees
Parameter
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Catatan
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.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
Menentukan item yang dihilangkan cmdlet ini. Nilai parameter ini memenuhi syarat parameter Path . Masukkan elemen atau pola jalur, seperti "*.txt". Karakter kartubebas diizinkan.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Menentukan filter dalam format atau bahasa penyedia. Nilai parameter ini memenuhi syarat parameter Path .
Sintaks filter, termasuk penggunaan karakter kartubebas, tergantung pada penyedia. Filter lebih efisien daripada parameter lain, karena penyedia menerapkannya ketika cmdlet mendapatkan objek daripada memfilter PowerShell objek setelah diambil.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Menentukan, sebagai array string, item atau item yang disertakan cmdlet ini dalam operasi. Nilai parameter ini memenuhi syarat parameter Path . Masukkan elemen atau pola jalur, seperti "*.txt". Karakter kartubebas diizinkan.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Menentukan jalur ke lokasi properti saat ini. Tidak seperti parameter Jalur, nilai LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai kartubebas. 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.
Type: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Menentukan nama properti yang akan dihapus. Karakter kartubebas diizinkan.
Type: | String[] |
Aliases: | PSProperty |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Path
Menentukan jalur item yang propertinya sedang dihapus. Karakter kartubebas diizinkan.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-UseTransaction
Menyertakan perintah dalam transaksi aktif. Parameter ini hanya valid ketika transaksi sedang berlangsung. Untuk informasi selengkapnya, lihat about_Transactions.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Anda dapat menyalurkan string yang berisi jalur, tetapi bukan jalur harfiah, ke cmdlet ini.
Output
None
Cmdlet ini tidak mengembalikan output.
Catatan
Windows PowerShell menyertakan alias berikut untuk Remove-ItemProperty
:
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 di sesi Anda, ketik Get-PSProvider
. Untuk informasi selengkapnya, lihat about_Providers.
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk