Remove-Item
刪除指定的項目。
Syntax
Remove-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Recurse]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-Stream <String[]>]
[<CommonParameters>]Remove-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Recurse]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-Stream <String[]>]
[<CommonParameters>]Description
Cmdlet 會 Remove-Item 刪除一或多個專案。 因為許多提供者都支援它，所以可以刪除許多不同類型的專案，包括檔案、資料夾、登錄機碼、變數、別名和函式。
範例
範例 1：刪除擴展名為任何的檔案
本範例會從資料夾中刪除名稱包含點 () .C:\Test 的所有檔案。 因為命令會指定點，所以此命令不會刪除沒有擴展名的資料夾或檔案。
Remove-Item C:\Test\*.*範例 2：刪除資料夾中的部分檔案檔案
此範例會從目前資料夾刪除擴展名 .doc 為 的所有檔案，以及不包含 *1*的名稱。
Remove-Item * -Include *.doc -Exclude *1*它會使用通配符 (*) 來指定目前資料夾的內容。 它會使用 Include 和 Exclude 參數來指定要刪除的檔案。
範例 3：刪除隱藏的唯讀檔案
此命令會刪除 隱藏 和 唯讀的檔案。
Remove-Item -Path C:\Test\hidden-RO-file.txt -Force它會使用 Path 參數來指定檔案。 它會使用 Force 參數來刪除它。 如果沒有 Force，您就無法刪除 唯讀 或 隱藏 的檔案。
範例 4：以遞歸方式刪除子資料夾中的檔案
此命令會以遞歸方式刪除目前資料夾和所有子資料夾中的所有 CSV 檔案。
因為 中的 Remove-ItemRecurse 參數有已知問題，所以此範例中的 命令會使用 Get-ChildItem 來取得所需的檔案，然後使用管線運算符將它們傳遞至 Remove-Item。
Get-ChildItem * -Include *.csv -Recurse | Remove-Item在命令中 Get-ChildItem ， Path 的值為 (*) ，代表目前資料夾的內容。 它會使用 Include 來指定 CSV 檔類型，並使用 Recurse 來遞歸擷取。 如果您嘗試指定路徑的檔類型，例如 -Path *.csv，Cmdlet 會將搜尋的主旨解譯為沒有子項目的檔案，而 Recurse 會失敗。
注意
Windows 版本 1909 和更新版本中已修正此行為。
範例 5：遞歸刪除子機碼
此命令會刪除 「OldApp」 登錄機碼及其所有子機碼和值。 它會使用 Remove-Item 來移除金鑰。 指定路徑，但省略了選擇性參數名稱 (Path) 。
Recurse 參數會以遞歸方式刪除 「OldApp」 金鑰的所有內容。 如果金鑰包含子機碼，而且您省略 Recurse 參數，系統會提示您確定您想要刪除金鑰的內容。
Remove-Item HKLM:\Software\MyCompany\OldApp -Recurse範例 6：刪除具有特殊字元的檔案
下列範例示範如何刪除包含特殊字元的檔案，例如方括弧或括號。
Get-ChildItem
Directory: C:\temp\Downloads
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 6/1/2018 12:19 PM 1362 myFile.txt
-a--- 6/1/2018 12:30 PM 1132 myFile[1].txt
-a--- 6/1/2018 12:19 PM 1283 myFile[2].txt
-a--- 6/1/2018 12:19 PM 1432 myFile[3].txt
Get-ChildItem | Where-Object Name -Like '*`[*'
Directory: C:\temp\Downloads
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 6/1/2018 12:30 PM 1132 myFile[1].txt
-a--- 6/1/2018 12:19 PM 1283 myFile[2].txt
-a--- 6/1/2018 12:19 PM 1432 myFile[3].txt
Get-ChildItem | Where-Object Name -Like '*`[*' | ForEach-Object { Remove-Item -LiteralPath $_.Name }
Get-ChildItem
Directory: C:\temp\Downloads
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 6/1/2018 12:19 PM 1362 myFile.txt範例 7：移除替代數據流
此範例示範如何使用 Cmdlet 的 Remove-ItemStream 動態參數來刪除替代數據流。 數據流參數會在 Windows PowerShell 3.0 中引進。
Get-Item C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
FileName: \\C:\Test\Copy-Script.ps1
Stream Length
------ ------
Zone.Identifier 26
Remove-Item C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
Get-Item C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
Get-Item : Could not open alternate data stream 'Zone.Identifier' of file 'C:\Test\Copy-Script.ps1'.Stream 參數Get-Item會Zone.Identifier取得檔案的Copy-Script.ps1數據流。 Remove-Item會使用 Stream 參數來移除Zone.Identifier檔案的數據流。 最後， Get-Item Cmdlet 會顯示 Zone.Identifier 資料流已刪除。
參數
-Confirm
在執行 Cmdlet 前提示您確認。 如需詳細資訊，請參閱下列文章：
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| 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。 允許使用萬用字元。 Exclude 參數只有在命令包含項目的內容時有效，例如 C:\Windows\*，其中通配符會指定目錄的內容C:\Windows。
搭配 Exclude 使用 Recurse 時，只排除目前目錄的結果。 如果子資料夾中有符合 排除 模式的檔案，這些檔案會連同其父目錄一起移除。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Filter
指定篩選條件以限定 Path 參數。 FileSystem 提供者是唯一支援使用篩選器的已安裝 PowerShell 提供者。 您可以在 about_Wildcards 中找到 FileSystem 篩選語言的語法。 篩選比其他參數更有效率，因為提供者會在 Cmdlet 取得物件時套用它們，而不是在擷取對象之後讓 PowerShell 篩選物件。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Force
強制 Cmdlet 移除無法變更的專案，例如隱藏或唯讀檔案或只讀別名或變數。 Cmdlet 無法移除常數別名或變數。 實作會依提供者而異。 如需詳細資訊，請參閱 about_Providers。 即使使用 Force 參數，Cmdlet 也無法覆寫安全性限制。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Include
以字串陣列指定此 Cmdlet 在作業中納入的項目。 此參數的值會限定 Path 參數。 輸入路徑元素或模式，例如 "*.txt"。 允許使用萬用字元。 Include 參數只有在命令包含項目的內容時有效，例如 C:\Windows\*，其中通配符會指定目錄的內容C:\Windows。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-LiteralPath
指定一個或多個位置的路徑。 LiteralPath 的值會與類型完全相同使用。 沒有字元會被視為萬用字元。 如果路徑包含逸出字元，請將它括在單引號中。 單引號會指示PowerShell不要將任何字元解譯為逸出序列。
如需詳細資訊，請參閱 about_Quoting_Rules。
| Type: | String[] |
| Aliases: | PSPath, LP |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Path
指定要移除之項目的路徑。 允許使用萬用字元。
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Recurse
表示此 Cmdlet 會刪除指定位置中的專案，以及位置的所有子專案中的專案。
Recurse 參數可能不會刪除所有子資料夾或所有子專案。 這是已知的問題。
注意
Windows 版本 1909 和更新版本中已修正此行為。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Stream
注意
此參數僅適用於 Windows。
Stream 參數是 FileSystem 提供者新增至 Remove-Item的動態參數。
此參數只適用於檔案系統磁碟機。
您可以使用 Remove-Item 來移除替代資料流，例如 Zone.Identifier。
但是，不建議使用這個方法來取代封鎖從網際網路下載之檔案的安全性檢查。 如果您確認下載的檔案安全，請使用 Unblock-File Cmdlet。
此參數是在 Windows PowerShell 3.0 引進。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
您可以使用管線將包含路徑 (但不是常值路徑) 的字串傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
此 Remove-Item Cmdlet 的設計目的是要處理任何提供者所公開的數據。 若要列出工作階段中可用的提供者，請輸入 Get-PsProvider。 如需詳細資訊，請參閱 about_Providers。
當您嘗試刪除包含項目的資料夾而不使用 Recurse 參數時，Cmdlet 會提示確認。 使用 -Confirm:$false 不會隱藏提示。 這是產品的設計。