Remove-ItemProperty
刪除項目的屬性及其值。
Syntax
Remove-ItemProperty
[-Path] <String[]>
[-Name] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Remove-ItemProperty
-LiteralPath <String[]>
[-Name] <String[]>
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Description
Remove-ItemProperty
Cmdlet 會從專案中刪除屬性及其值。
您可以使用它來刪除登錄值和它們所儲存的資料。
範例
範例 1:刪除登錄值
此命令會從 「HKEY_LOCAL_MACHINE\Software」 登錄機碼的 「SmpApplication」 子機碼中刪除 「SmpProperty」 登錄值及其數據。
因為命令是從文件系統磁碟驅動器 () PS C:\>
發出,所以它包含 「SmpApplication」 子機碼的完整路徑,包括磁碟驅動器、 HKLM:
和 「Software」 密鑰。
它會使用 Name 參數來識別正在刪除的登錄值。
Remove-ItemProperty -Path "HKLM:\Software\SmpApplication" -Name "SmpProperty"
範例 2︰從 HKCU 位置刪除登錄值
這些命令會從 「HKEY_CURRENT_USER\Software\MyCompany」 的 「MyApp」 子機碼中刪除 「Options」 登錄值及其數據。
第一個命令會 Set-Location
使用 Cmdlet 將目前的位置變更為HKEY_CURRENT_USER磁碟驅動器, (HKCU:
) 和 “Software\MyCompany\MyApp” 子機碼。
第二個命令會使用 Remove-ItemProperty
從 「MyApp」 子機碼移除 「Options」 登錄值及其數據。
因為 需要Path ,所以命令會使用點 (。'。') 表示目前的位置。
它會使用 Name 來指定要刪除的登錄值。
它會使用 Confirm 參數在刪除值之前要求使用者提示。
PS C:\> Set-Location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> Remove-ItemProperty -Path . -Name "Options" -Confirm
範例 3︰使用管線移除登錄值
此命令會從 「HKLM\Software\MyCompany」 登錄機碼中刪除 「NoOfEmployees」 登錄值及其數據。
此命令會 Get-Item
使用 Cmdlet 來取得代表登錄機碼的專案。
它會使用管線運算子 (|
) 將物件傳送至 Remove-ItemProperty
。
然後,它會使用的 Remove-ItemProperty
Name 參數來指定登錄值的名稱。
Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployees
參數
-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"。 允許使用萬用字元。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
以提供者的格式或語言指定篩選。 此參數的值會限定 Path 參數。
篩選的語法 (包括是否使用萬用字元) 取決於提供者。 篩選比其他參數更有效率,因為提供者會在 Cmdlet 取得物件時套用它們,而不是在擷取對象之後讓 PowerShell 篩選物件。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
強制 Cmdlet 對使用者無法以其他方式存取的物件移除屬性。 實作會依提供者而異。 如需詳細資訊,請參閱 about_Providers。
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 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
指定要移除的屬性名稱。 允許使用萬用字元。
Type: | String[] |
Aliases: | PSProperty |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Path
指定要移除其屬性的項目路徑。 允許使用萬用字元。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-UseTransaction
將命令加入使用中交易。 只有交易為處理中狀態時,此參數才有效。 如需詳細資訊,請參閱 about_Transactions。
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
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 |
輸入
您可以使用管線將包含路徑 (但不是常值路徑) 的字串傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
在PowerShell登錄提供者中,登錄值會被視為登錄機碼或子機碼的屬性。 您可以使用 ItemProperty Cmdlet 來管理這些值。
Remove-ItemProperty
是設計來使用任何提供者所公開的數據。 若要列出工作階段中可用的提供者,請輸入 Get-PSProvider
。 如需詳細資訊,請參閱 about_Providers。