Clear-Content
Bir öğenin içeriğini siler, ancak öğeyi silmez.
Syntax
Path (Default) - FileSystem provider
Clear-Content
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Stream <String>]
[<CommonParameters>]
LiteralPath - FileSystem provider
Clear-Content
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Stream <String>]
[<CommonParameters>]
Path (Default) - All providers
Clear-Content
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
LiteralPath - All providers
Clear-Content
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Description
Clear-Content cmdlet'i bir dosyanın metnini silme gibi bir öğenin içeriğini siler, ancak öğeyi silmez. Sonuç olarak, öğe var ancak boş.
Clear-Content
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, init.txt dizininin tüm alt dizinlerindeki SmpUsers dosyalarındaki 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 da dahil olmak üzere .log dosya adı uzantısıyla 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 yolda .log belirtmek yerine *.log dosya adı uzantısına sahip dosyalarla 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, Clear-Content cmdlet'inin akışı olduğu gibi bırakırken alternatif bir veri akışındaki içeriği nasıl temizleyişi gösterilmektedir.
İlk komut, İnternet'ten indirilen Get-Content dosyasındaki Zone.Identifier akışının içeriğini almak için Copy-Script.ps1 cmdlet'ini kullanır.
İkinci komut, içeriği temizlemek için Clear-Content cmdlet'ini kullanır.
Üçü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 Unblock-File cmdlet'ini 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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Credential
Uyarı
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 Invoke-Commandkullanın.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | Current user |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Exclude
Dize dizisi olarak, bu cmdlet'in içerik yolundan atlayan dizeleri belirtir. Bu parametrenin değeri, Path parametresini niteler.
*.txtgibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
Komutu, kullanıcı onayı istemeden çalışmaya zorlar.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Include
Dize dizisi olarak bu cmdlet'in temizlediği içeriği belirtir. Bu parametrenin değeri, Path parametresini niteler.
*.txtgibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-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, onu tek tırnak içine alın ('). Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini belirtir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | PSPath |
Parametre kümeleri
LiteralPath
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
Path
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-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.
Clear-Contentgibi herhangi bir alternatif veri akışının içeriğini değiştirmek için Zone.Identifier cmdlet'ini kullanabilirsiniz. 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 Unblock-File cmdlet'ini kullanın.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Daha fazla bilgi için bkz. about_FileSystem_Provider.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | usetx |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
None
Bu cmdlet çıkış döndürmez.
Notlar
Windows PowerShell, Clear-Contentiçin aşağıdaki diğer adları içerir:
clc
Clear-Content PowerShell FileSystem sağlayıcısıyla ve içeriği işleyen diğer sağlayıcılarla kullanabilirsiniz. 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 Clear-Itemkullanın.
Clear-Content cmdlet'i 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 Get-PSProvideryazın.
Daha fazla bilgi için bkz. about_Providers.
