Clear-Item

Clear-Item cmdlet可以清除項的內容，但不刪除該項。 例如，Clear-Item cmdlet 可以刪除變數的值，但不會刪除該變數。 用於表示已清除項的值由每個 PowerShell 提供程式定義。 此 cmdlet 類似於 Clear-Content，但前者用於處理別名和變數，而不是檔案。

基本介紹

• 外文名：Clear-Item
• 模組：Microsoft.PowerShell.Management 

語法

Clear-Item
[-Path] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]

Clear-Item
-LiteralPath <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]

示例

示例 1

此命令清除名為 TestVar1 的變數的值。 該變數仍將保留並且有效，但其值設定為 $null。 該變數名加有前綴 Variable: 以指示 PowerShell Variable 提供程式。

其他命令表明若要獲取相同結果，可以切換到 PowerShell Variable: 驅動器，然後運行 Clear-Item 命令。

Clear-Item Variable:TestVar1
Set-Location Variable:
PS Variable:\> Clear-Item TestVar1

示例 2

此命令清除“MyKey”子項中的所有註冊表條目，但僅在提示你確認你的意圖後才會刪除。 此命令不會刪除“MyKey”子項，也不會影響其他任何註冊表項或條目。 可以使用 Include 參數和 Exclude 參數來標識特定的註冊表項，但不能使用這兩個參數來標識註冊表條目。

• 若要刪除特定的註冊表條目，請使用 Remove-ItemProperty cmdlet。
• 若要刪除註冊表條目的值，請使用 Clear-ItemProperty cmdlet。

Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm

參數

-Confirm

提示你在運行cmdlet之前進行確認。

-Credential

注意：隨同 PowerShell 一起安裝的任何提供程式都不支持此參數。 要模擬其他用戶，或在運行此 cmdlet 時提升憑據，請使用 Invoke-Command。

-Exclude

以字元串數組的形式指定此 cmdlet 將在操作中排除的項。 此參數值使 Path 參數有效。 請輸入路徑元素或模式，例如 *.txt。 允許使用通配符。 僅當該命令包括項的內容時（例如 C:\Windows\*，其中通配符指定 C:\Windows 目錄的內容），Exclude 參數才有效。

-Filter

指定用於限定 Path 參數的篩選器。 FileSystem 提供程式是唯一支持使用篩選器的已安裝 PowerShell 提供程式。 可以在 about_Wildcards 中找到 FileSystem 篩選器語言的語法。 篩選器比其他參數更有效，因為提供程式是在 cmdlet 獲取對象時套用篩選器，而不是在檢索對象後再讓 PowerShell 篩選對象。

-Force

指示 cmdlet 清除在其他情況下無法更改的項（如唯讀別名）。 此 cmdlet 不能清除常量。 不同提供程式有不同的實現。 有關詳細信息，請參閱 about_Providers。 即使使用 Force 參數，該 cmdlet 也無法覆蓋安全限制。

-Include

指定此 cmdlet 將在操作中包含的一個項或多個項（作為一個字元串數組）。 此參數值使 Path 參數有效。 請輸入路徑元素或模式，例如 "*.txt"。 允許使用通配符。 僅當該命令包括項的內容時（例如 C:\Windows\*，其中通配符指定 C:\Windows 目錄的內容），Include 參數才有效。

-LiteralPath

指定一個或多個位置的路徑。 LiteralPath 的值嚴格按照所鍵入的形式使用。 不會將任何字元解釋為通配符。 如果路徑包括轉義符，請將其括在單引號中。 單引號告知 PowerShell 不要將任何字元解釋為轉義序列。

-Path

指定要清除的項的路徑。 允許使用通配符。 此參數為必需參數，但參數名 Path 為可選項。

-WhatIf

顯示運行該 cmdlet 時會發生什麼情況。 cmdlet 未運行。

輸出

此 cmdlet 不返回任何輸出。