Clear-Item
Menghapus isi item, tetapi tidak menghapus item.
Sintaks
Clear-Item
[-Path] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Clear-Item
-LiteralPath <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Deskripsi
Clear-Item
Cmdlet menghapus konten item, tetapi tidak menghapus item.
Misalnya, Clear-Item
cmdlet dapat menghapus nilai variabel, tetapi tidak menghapus variabel. Nilai yang digunakan untuk mewakili item yang dihapus ditentukan oleh setiap penyedia PowerShell.
Cmdlet ini mirip Clear-Content
dengan , tetapi berfungsi pada alias dan variabel, bukan file.
Contoh
Contoh 1: Menghapus nilai variabel
Perintah ini menghapus nilai variabel bernama TestVar1
.
Variabel tetap dan valid, tetapi nilainya diatur ke $null
.
Nama variabel diawali dengan Variable:
untuk menunjukkan penyedia Variabel PowerShell.
Perintah alternatif menunjukkan bahwa, untuk mendapatkan hasil yang sama, Anda dapat beralih ke drive PowerShell Variable:
lalu menjalankan Clear-Item
perintah.
Clear-Item Variable:TestVar1
Set-Location Variable:
PS Variable:\> Clear-Item TestVar1
Contoh 2: Hapus semua entri registri
Perintah ini menghapus semua entri registri di subkuntah "MyKey", tetapi hanya setelah meminta Anda untuk mengonfirmasi niat Anda. Ini tidak menghapus subkuntang "MyKey" atau memengaruhi kunci atau entri registri lainnya. Anda dapat menggunakan parameter Sertakan dan Kecualikan untuk mengidentifikasi kunci registri tertentu, tetapi Anda tidak dapat menggunakannya untuk mengidentifikasi entri registri.
- Untuk menghapus entri registri tertentu, gunakan
Remove-ItemProperty
cmdlet . - Untuk menghapus nilai entri registri, gunakan
Clear-ItemProperty cmdlet
.
Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm
Parameter
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
Jenis: | SwitchParameter |
Alias: | cf |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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.
Jenis: | PSCredential |
Position: | Named |
Nilai default: | Current user |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Exclude
Menentukan, sebagai array string, item atau item yang dikecualikan cmdlet ini dalam operasi. Nilai parameter ini memenuhi syarat parameter Path . Masukkan elemen atau pola jalur, seperti *.txt
. Karakter kartubebas diizinkan. Parameter Kecualikan hanya efektif ketika perintah menyertakan konten item, seperti C:\Windows\*
, di mana karakter kartubebas C:\Windows
menentukan konten direktori.
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 memfilter PowerShell objek setelah diambil.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | True |
-Force
Menunjukkan bahwa cmdlet menghapus item yang tidak dapat diubah, seperti alias baca-saja. Cmdlet tidak dapat menghapus konstanta. Implementasi bervariasi dari penyedia ke penyedia. Untuk informasi selengkapnya, lihat about_Providers. Cmdlet tidak dapat mengambil alih pembatasan keamanan, bahkan ketika parameter Force digunakan.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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. Parameter Sertakan hanya efektif ketika perintah menyertakan konten item, seperti C:\Windows\*
, di mana karakter kartubebas C:\Windows
menentukan konten direktori.
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 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.
Untuk informasi selengkapnya, lihat about_Quoting_Rules.
Jenis: | String[] |
Alias: | PSPath |
Position: | Named |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Path
Menentukan jalur ke item yang sedang dibersihkan. Karakter kartubebas diizinkan. Parameter ini diperlukan, tetapi jalur nama parameter bersifat opsional.
Jenis: | String[] |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | True |
-UseTransaction
Menyertakan perintah dalam transaksi aktif. Parameter ini hanya valid ketika transaksi sedang berlangsung. Untuk informasi selengkapnya, lihat about_Transactions.
Jenis: | SwitchParameter |
Alias: | usetx |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Jenis: | SwitchParameter |
Alias: | wi |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
Input
Anda dapat menyalurkan string jalur ke cmdlet ini.
Output
None
Cmdlet ini tidak mengembalikan output.
Catatan
Windows PowerShell menyertakan alias berikut untuk Clear-Item
:
cli
Clear-Item
Cmdlet hanya didukung oleh beberapa penyedia PowerShell, termasuk penyedia Alias, Lingkungan, Fungsi, Registri, dan Variabel. Dengan demikian, Anda dapat menggunakanClear-Item
untuk menghapus konten item di namespace penyedia. Untuk mencantumkan penyedia yang tersedia di sesi Anda, ketikGet-PsProvider
. Untuk informasi selengkapnya, lihat about_Providers.Anda tidak dapat menggunakan
Clear-Item
untuk menghapus konten file, karena penyedia PowerShell FileSystem tidak mendukung cmdlet ini. Untuk menghapus file, gunakanClear-Content
.