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]
     [-UseTransaction]
     [-Stream <String>]
     [<CommonParameters>]
Clear-Content
     -LiteralPath <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-UseTransaction]
     [-Stream <String>]
     [<CommonParameters>]
Clear-Content
     [-Path] <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-UseTransaction]
     [<CommonParameters>]
Clear-Content
     -LiteralPath <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-UseTransaction]
     [<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.

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, 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.

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 wildcard, tergantung pada penyedia. Filter lebih efisien daripada parameter lain, karena penyedia menerapkannya saat mengambil objek, daripada meminta PowerShell memfilter objek setelah diambil.

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

-Force

Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-Stream

Ini adalah parameter dinamis yang disediakan oleh penyedia FileSystem .

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 Windows PowerShell 3.0.

Untuk informasi selengkapnya, lihat about_FileSystem_Provider.

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

-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

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

Windows PowerShell menyertakan alias berikut untuk Clear-Content:

  • 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.