Clear-Content
刪除項目的內容，但不會刪除項目。
Syntax
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>]Description
Cmdlet Clear-Content 會刪除項目的內容，例如從檔案中刪除文字，但不會刪除專案。
因此，項目會存在，但會是空的。
Clear-Content類似於 Clear-Item，但它適用於具有內容的專案，而不是具有值的專案。
範例
範例 1：從目錄刪除所有內容
Clear-Content "..\SmpUsers\*\init.txt"此命令刪除 SmpUsers 目錄之所有子目錄中的 "init.txt" 檔案的所有內容。 檔案不會被刪除，但會是空的。
範例 2：使用通配符刪除所有檔案的內容
Clear-Content -Path "*" -Filter "*.log" -Force此命令刪除目前目錄中副檔名為 ".log" 之所有檔案的內容，包括具有唯讀屬性的檔案。 路徑中的星號 (*) 代表目前目錄中的所有項目。 Force 參數可讓命令在唯讀檔案上生效。 使用篩選將命令限制為擴展名為 .log 的檔案，而不是在路徑中指定 *.log，讓作業更快速。
範例 3：清除數據流中的所有數據
此範例示範 Cmdlet 如何 Clear-Content 清除替代數據流中的內容，同時讓數據流保持不變。
第一個命令會 Get-Content 使用 Cmdlet，在從因特網下載的 Copy-Script.ps1 檔案中取得 Zone.Identifier 數據流的內容。
第二個命令會 Clear-Content 使用 Cmdlet 來清除內容。
第三個命令重複第一個命令。 它會驗證已清除內容，但數據流仍會保留。 如果已刪除資料流，命令會產生錯誤。
您可以使用類似這個的方法清除替代數據流的內容。 但是，不建議使用這個方法來取代封鎖從網際網路下載之檔案的安全性檢查。 如果您確認下載的檔案安全，請使用 Unblock-File Cmdlet。
PS C:\> Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
[ZoneTransfer]
ZoneId=3
PS C:\>Clear-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
PS C:\>Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
PS C:\>參數
-Confirm
在執行 Cmdlet 前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
注意
任何隨 PowerShell 一起安裝的提供者都不支援此參數。 若要模擬其他使用者，或在執行此 Cmdlet 時提高您的認證，請使用 Invoke-Command。
| Type: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Exclude
指定這個 Cmdlet 從內容路徑省略的字串，做為字串陣列。 此參數的值會限定 Path 參數。 輸入路徑元素或模式，例如 "*.txt"。 允許使用萬用字元。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Filter
以提供者的格式或語言指定篩選。 此參數的值會限定 Path 參數。 篩選的語法 (包括是否使用萬用字元) 取決於提供者。 篩選比其他參數更有效率，因為提供者在擷取物件時會套用它們，而不是在擷取對象之後讓PowerShell篩選物件。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Force
強制執行命令而不要求使用者確認。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Include
指定這個 Cmdlet 清除的字串數位內容。 此參數的值會限定 Path 參數。 輸入路徑元素或模式，例如 "*.txt"。 允許使用萬用字元。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-LiteralPath
指定要從中刪除內容之項目的路徑。 與 Path 參數不同，LiteralPath 的值將完全依照其輸入值來使用。 沒有字元會被視為萬用字元。 如果路徑包含逸出字元，請將它括在單引號中。 單引號會告訴PowerShell不要將任何字元解譯為逸出序列。
| Type: | String[] |
| Aliases: | PSPath, LP |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Path
指定要從中刪除內容之項目的路徑。 允許使用萬用字元。 路徑需為項目的路徑，而非容器的路徑。 例如，您必須指定一或多個檔案的路徑，而非目錄的路徑。 允許使用萬用字元。 此為必要參數，但是參數名稱 ("Path") 為選擇性。
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Stream
指定內容的替代數據流。 如果數據流不存在，此 Cmdlet 會建立它。 不支援萬用字元。
Stream 是 FileSystem 提供者新增至 Clear-Content的動態參數。
此參數只適用於檔案系統磁碟機。
您可以使用 Clear-Content Cmdlet 來變更 Zone.Identifier 替代數據流的內容。
不過，我們不建議這麼做，以消除封鎖從因特網下載之檔案的安全性檢查。
如果您確認下載的檔案安全，請使用 Unblock-File Cmdlet。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
None
您無法使用管線會傳送到 Clear-Content。
輸出
None
此 Cmdlet 不會傳回任何物件。
備註
您可以 Clear-Content 搭配 PowerShell FileSystem 提供者和其他操作內容的提供者使用。
若要清除未被視為內容的專案，例如 PowerShell 憑證或登錄提供者所管理的專案，請使用 Clear-Item。
Cmdlet Clear-Content 的設計目的是要處理任何提供者所公開的數據。
若要列出工作階段中可用的提供者，請輸入 Get-PsProvider。
如需詳細資訊，請參閱 about_Providers。