Aracılığıyla paylaş

Clear-Content

  • Başvuru
Modül:
Microsoft.PowerShell.Management

Bir öğenin içeriğini siler, ancak öğeyi silmez.

Sözdizimi

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

Description

Clear-Content Cmdlet bir dosyanın metnini silme gibi bir öğenin içeriğini siler, ancak öğeyi silmez. Sonuç olarak, öğe var ancak boş. Clear-Content , değerine Clear-Itembenzer, ancak değerleri olan öğeler yerine içeriği olan öğeler üzerinde çalışır.

Örnekler

Örnek 1: Dizindeki tüm içeriği silme

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

Bu komut, dizinin tüm alt dizinlerindeki SmpUsers dosyalardan init.txt tüm içeriği siler. Dosyalar silinmez, ancak boş olur.

Örnek 2: Joker karakter içeren tüm dosyaların içeriğini silme

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

Bu komut, salt okunur özniteliğine sahip dosyalar dahil olmak üzere dosya adı uzantısıyla .log geçerli dizindeki tüm dosyaların içeriğini siler. Yoldaki yıldız işareti (*), geçerli dizindeki tüm öğeleri temsil eder. Force parametresi komutu salt okunur dosyalarda etkili hale getirir. Komutu yol içinde belirtmek *.log yerine dosya adı uzantısına sahip dosyalarla .log kısıtlamak için bir filtre kullanmak işlemi hızlandırır.

Örnek 3: Bir akıştan tüm verileri temizleme

Bu örnekte, cmdlet'in Clear-Content akışı olduğu gibi bırakırken alternatif bir veri akışındaki içeriği nasıl temizleyişi gösterilmektedir.

İlk komut, internetten indirilen dosyadaki Copy-Script.ps1 akışın Zone.Identifier içeriğini almak için cmdlet'ini kullanırGet-Content.

İkinci komut, içeriği temizlemek için cmdlet'ini kullanır Clear-Content .

Üçüncü komut ilk komutu yineler. İçeriğin temizlendiğini doğrular, ancak akış kalır. Akış silinirse komut bir hata oluşturur.

Alternatif bir veri akışının içeriğini temizlemek için bunun gibi bir yöntem kullanabilirsiniz. Ancak, İnternet'ten indirilen dosyaları engelleyen güvenlik denetimlerini ortadan kaldırmanın önerilen yolu değildir. İndirilen bir dosyanın güvenli olduğunu doğrularsanız cmdlet'ini Unblock-File kullanın.

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

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Credential

Not

Bu parametre, PowerShell ile yüklenen hiçbir sağlayıcı tarafından desteklenmez. Başka bir kullanıcının kimliğine bürünmek veya bu cmdlet'i çalıştırırken kimlik bilgilerinizi yükseltmek için kullanın Invoke-Command.

Tür:PSCredential
Position:Named
Default value:Current user
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Exclude

Dize dizisi olarak, bu cmdlet'in içerik yolundan atlayan dizeleri belirtir. Bu parametrenin değeri Path parametresini niteler. gibi *.txtbir yol öğesi veya deseni girin. Joker karakterlere izin verilir.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

-Filter

Sağlayıcının biçiminde veya dilinde bir filtre belirtir. Bu parametrenin değeri Path parametresini niteler. Joker karakterlerin kullanımı da dahil olmak üzere filtrenin söz dizimi sağlayıcıya bağlıdır. Sağlayıcı, nesneleri aldıktan sonra PowerShell'in filtrelemesini yapmak yerine nesneleri alırken bunları uyguladığından filtreler diğer parametrelerden daha verimlidir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

-Force

Komutu, kullanıcı onayı istemeden çalışmaya zorlar.

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Include

Dize dizisi olarak bu cmdlet'in temizlediği içeriği belirtir. Bu parametrenin değeri Path parametresini niteler. gibi *.txtbir yol öğesi veya deseni girin. Joker karakterlere izin verilir.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

-LiteralPath

İçeriğin silindiği öğelerin yollarını belirtir. Path parametresinden farklı olarak, LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, tek tırnak işareti (' içine alın). Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini belirtir.

Tür:String[]
Diğer adlar:PSPath
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Path

İçeriğin silindiği öğelerin yollarını belirtir. Joker karakterlere izin verilir. Yollar kapsayıcılara değil öğelere giden yollar olmalıdır. Örneğin, dizin yolu değil, bir veya daha fazla dosya için yol belirtmeniz gerekir. Joker karakterlere izin verilir. Bu parametre gereklidir, ancak parametre adı (Yol) isteğe bağlıdır.

Tür:String[]
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:True

-Stream

Bu, FileSystem sağlayıcısı tarafından sağlanan dinamik bir parametredir.

İçerik için alternatif bir veri akışı belirtir. Akış yoksa, bu cmdlet onu oluşturur. Joker karakterler desteklenmez.

gibi Zone.Identifierherhangi bir alternatif veri akışının içeriğini değiştirmek için cmdlet'ini kullanabilirsinizClear-Content. Ancak, İnternet'ten indirilen dosyaları engelleyen güvenlik denetimlerini ortadan kaldırmanın bir yolu olarak bunu önermeyiz. İndirilen bir dosyanın güvenli olduğunu doğrularsanız cmdlet'ini Unblock-File kullanın.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

Daha fazla bilgi için bkz . about_FileSystem_Provider.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UseTransaction

Komutunu etkin işleme ekler. Bu parametre yalnızca bir işlem devam ederken geçerlidir. Daha fazla bilgi için bkz . about_transactions.

Tür:SwitchParameter
Diğer adlar:usetx
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

Windows PowerShell için aşağıdaki diğer adları Clear-Contentiçerir:

  • clc

PowerShell FileSystem sağlayıcısıyla ve içeriği işleyen diğer sağlayıcılarla kullanabilirsiniz Clear-Content . PowerShell Sertifikası veya Kayıt Defteri sağlayıcıları tarafından yönetilen öğeler gibi içerik olarak kabul edilmeyen öğeleri temizlemek için kullanın Clear-Item.

Clear-Content Cmdlet, herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için yazın Get-PsProvider. Daha fazla bilgi için bkz . about_Providers.