Bagikan melalui

Clear-Content

  • Referensi
Modul:
Microsoft.PowerShell.Management

Menghapus isi item, tetapi tidak menghapus item.

Sintaks

Clear-Content
     [-Path] <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-Stream <String>]
     [<CommonParameters>]
Clear-Content
     -LiteralPath <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-Stream <String>]
     [<CommonParameters>]
Clear-Content
     [-Path] <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-Content
     -LiteralPath <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Deskripsi

Clear-Content Cmdlet menghapus konten item, seperti menghapus teks dari file, tetapi tidak menghapus item. Akibatnya, item ada, tetapi kosong. Clear-Content mirip Clear-Itemdengan , tetapi berfungsi pada item dengan konten, bukan item dengan nilai.

Contoh

Contoh 1: Menghapus semua konten dari direktori

Clear-Content "..\SmpUsers\*\init.txt"

Perintah ini menghapus semua konten dari init.txt file di semua subdirektori SmpUsers direktori. File tidak dihapus, tetapi kosong.

Contoh 2: Menghapus konten semua file dengan kartubebas

Clear-Content -Path "*" -Filter "*.log" -Force

Perintah ini menghapus konten semua file di direktori saat ini dengan .log ekstensi nama file, termasuk file dengan atribut baca-saja. Tanda bintang (*) di jalur mewakili semua item dalam direktori saat ini. Parameter Force membuat perintah efektif pada file baca-saja. Menggunakan filter untuk membatasi perintah ke file dengan .log ekstensi nama file alih-alih menentukan *.log di jalur membuat operasi lebih cepat.

Contoh 3: Menghapus semua data dari aliran

Contoh ini menunjukkan bagaimana Clear-Content cmdlet menghapus konten dari aliran data alternatif sambil membiarkan aliran tetap utuh.

Perintah pertama menggunakan Get-Content cmdlet untuk mendapatkan konten Zone.Identifier aliran dalam Copy-Script.ps1 file, yang diunduh dari internet.

Perintah kedua menggunakan Clear-Content cmdlet untuk menghapus konten.

Perintah ketiga mengulangi perintah pertama. Ini memverifikasi bahwa konten dibersihkan, tetapi aliran tetap ada. Jika aliran dihapus, perintah akan menghasilkan kesalahan.

Anda dapat menggunakan metode seperti ini untuk menghapus konten aliran data alternatif. Namun, bukan cara yang disarankan untuk menghilangkan pemeriksaan keamanan yang memblokir file yang diunduh dari Internet. Jika Anda memverifikasi bahwa file yang diunduh aman, gunakan Unblock-File cmdlet .

Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier

[ZoneTransfer]
ZoneId=3

Clear-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:None
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, string yang dihilangkan cmdlet ini dari jalur ke konten. Nilai parameter ini memenuhi syarat parameter Path . Masukkan elemen atau pola jalur, seperti *.txt. Kartubebas diizinkan.

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

-Filter

Menentukan filter dalam format atau bahasa penyedia. Nilai parameter ini memenuhi syarat parameter Path . Sintaks filter, termasuk penggunaan wildcard, tergantung pada penyedia. Filter lebih efisien daripada parameter lain, karena penyedia menerapkannya saat mengambil objek, daripada meminta PowerShell memfilter objek setelah diambil.

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

-Force

Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.

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

-Include

Menentukan, sebagai array string, konten yang dihapus cmdlet ini. Nilai parameter ini memenuhi syarat parameter Path . Masukkan elemen atau pola jalur, seperti *.txt. Kartubebas diizinkan.

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

-LiteralPath

Menentukan jalur ke item tempat konten dihapus. 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 bahwa PowerShell tidak menginterpretasikan karakter apa pun sebagai urutan escape.

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

-Path

Menentukan jalur ke item tempat konten dihapus. Kartubebas diizinkan. Jalur harus berupa jalur ke item, bukan ke kontainer. Misalnya, Anda harus menentukan jalur ke satu atau beberapa file, bukan jalur ke direktori. Kartubebas diizinkan. Parameter ini diperlukan, tetapi nama parameter (Jalur) bersifat opsional.

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

-Stream

Ini adalah parameter dinamis yang disediakan oleh penyedia FileSystem . Parameter ini hanya tersedia di Windows.

Menentukan aliran data alternatif untuk konten. Jika aliran tidak ada, cmdlet ini akan membuatnya. Karakter kartubebas tidak didukung.

Anda dapat menggunakan Clear-Content cmdlet untuk mengubah konten aliran data alternatif apa pun, seperti Zone.Identifier. Namun, kami tidak merekomendasikan ini sebagai cara untuk menghilangkan pemeriksaan keamanan yang memblokir file yang diunduh dari internet. Jika Anda memverifikasi bahwa file yang diunduh aman, gunakan Unblock-File cmdlet .

Parameter ini diperkenalkan di PowerShell 3.0. Pada PowerShell 7.2, Clear-Content dapat menghapus konten aliran data alternatif dari direktori serta file.

Untuk informasi selengkapnya, lihat about_FileSystem_Provider.

Jenis:String
Position:Named
Nilai default:None
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

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

PowerShell menyertakan alias berikut untuk Clear-Content:

  • Semua platform:
    • clc

Anda dapat menggunakan Clear-Content dengan penyedia PowerShell FileSystem dan dengan penyedia lain yang memanipulasi konten. Untuk menghapus item yang tidak dianggap sebagai konten, seperti item yang dikelola oleh penyedia Sertifikat PowerShell atau Registri, gunakan Clear-Item.

Clear-Content Cmdlet 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.