Remove-ItemProperty

發行項
10/30/2009

從項目刪除屬性及其值。

語法

Remove-ItemProperty [-LiteralPath] <string[]> [-Name] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

Remove-ItemProperty [-Path] <string[]> [-Name] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

描述

Remove-ItemProperty Cmdlet 會從項目中刪除屬性及其值。您可以使用它刪除登錄值和存放在其中的資料。

參數

-Credential <PSCredential>

指定具有執行此動作之權限的使用者帳戶。預設為目前使用者。

請輸入使用者名稱，例如 "User01" 或 "Domain01\User01"，或是輸入 PSCredential 物件，例如由 Get-Credential Cmdlet 所產生的物件。如果輸入使用者名稱，將會提示您提供密碼。

所有隨 Windows PowerShell 安裝的提供者都不支援此參數。

必要?	false
位置?	named
預設值
接受管線輸入?	true (ByPropertyName)
接受萬用字元?	false

-Exclude <string[]>

忽略指定的項目。此參數的值用於限定 Path 參數。輸入路徑元素或模式，例如 "*.txt"。允許使用萬用字元。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Filter <string>

指定以提供者的格式或語言表示的篩選器。此參數的值用於限定 Path 參數。篩選器的語法 (包括萬用字元的用法) 依提供者而定。篩選器比其他參數更有效率，因為提供者會在擷取物件時套用篩選器，而非等到 Windows PowerShell 擷取物件後才進行篩選。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Force

允許此 Cmdlet 移除使用者無法以其他方式存取之物件的屬性。實作因提供者而異。如需詳細資訊，請參閱 about_Providers。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-Include <string[]>

只刪除指定的項目。此參數的值用於限定 Path 參數。輸入路徑元素或模式，例如 "*.txt"。允許使用萬用字元。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-LiteralPath <string[]>

指定項目屬性的路徑。LiteralPath 係取用實際輸入的內容做為參數值。任何字元均不被解譯成萬用字元。如果路徑中包含逸出字元，請將其置於單引號內。單引號係告訴 Windows PowerShell 不要將任何字元解譯成逸出序列。

必要?	true
位置?	1
預設值
接受管線輸入?	true (ByPropertyName)
接受萬用字元?	false

-Name <string[]>

指定要擷取的屬性名稱。

必要?	true
位置?	2
預設值
接受管線輸入?	true (ByPropertyName)
接受萬用字元?	false

-Path <string[]>

指定要移除其屬性的項目所在路徑。允許使用萬用字元。

必要?	true
位置?	1
預設值
接受管線輸入?	true (ByValue, ByPropertyName)
接受萬用字元?	false

-Confirm

在執行命令前先提示確認。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-WhatIf

說明執行命令時將會發生何種情況，但不會實際執行命令。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

-UseTransaction

將命令加入現用交易中。此參數只有當交易進行中時才有效。如需詳細資訊，請參閱 about_Transactions。

必要?	false
位置?	named
預設值
接受管線輸入?	false
接受萬用字元?	false

<CommonParameters>

這個 Cmdlet 支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.String

您可經由管道將包含路徑 (但不是常值路徑) 的字串輸出至 Remove-ItemProperty。

輸出

無

這個 Cmdlet 不會傳回任何輸出。

附註

您也可以利用內建的別名 "rp" 來參照 Remove-ItemProperty。如需詳細資訊，請參閱 about_Alias。

在 Windows PowerShell Registry 提供者中，登錄值就是登錄機碼或子機碼的屬性。您可以使用 ItemProperty cmdlet 管理這些值。

Remove-ItemProperty Cmdlet 設計的用意是要操作任一提供者所公開的資料。若要列出可在工作階段中使用的提供者，請輸入 "Get-PSProvider"。如需詳細資訊，請參閱 about_Providers。

範例 1

C:\PS>remove-itemproperty -path HKLM:\Software\SmpApplication -name SmpProperty

描述
-----------
這個命令會從 HKEY_LOCAL_MACHINE\Software 登錄機碼中的 SmpApplication 子機碼，刪除 SmpProperty 登錄值及其資料。

因為這個命令是從檔案系統磁碟機 (C:\PS>) 所發出，所以它會包括指向 SmpApplication 子機碼的完整路徑，包括 HKLM: 磁碟機和 Software 機碼。

它使用 Name 參數識別要刪除的登錄值。

範例 2

C:\PS>set-location HKCU:\Software\MyCompany\MyApp

PS HKCU:\Software\MyCompany\MyApp> remove-itemproperty -path . -Name Options -confirm

描述
-----------
這些命令會從 HKEY_CURRENT_USER\Software\MyCompany 的 MyApp 子機碼，刪除 Options 登錄值及其資料。

這個命令使用 Set-Location Cmdlet 將目前的位置變更為 HKEY_CURRENT_USER 磁碟機 (HKCU:) 與 Software\MyCompany\MyApp 子機碼。

第二個命令會用 Remove-Item Cmdlet 從 MyApp 子機碼移除 Options 登錄值及其資料。因為必須使用 Path 參數，所以此命令會使用點 (.) 指出目前的位置。它使用 Name 參數指定要刪除哪一個登錄值。它使用 Confirm 參數，在刪除該值之前要求使用者提示。

範例 3

C:\PS>get-item -path HKLM:\Software\MyCompany | remove-itemproperty -name NoOfEmployees

描述
-----------
這個命令會從 HKLM\Software\MyCompany 登錄機碼中刪除 NoOfEmployees 登錄值及其資料。

該命令使用 Get-Item Cmdlet 取得代表登錄機碼的項目。它會使用管線運算子 (|) 將物件傳送給 Remove-ItemProperty Cmdlet。接著，它會使用 Remove-ItemProperty 的 Name 參數指定登錄值的名稱。

請參閱

概念

about_Providers
Clear-ItemProperty
Copy-ItemProperty
Get-ItemProperty
Move-ItemProperty
New-ItemProperty
Remove-Item
Rename-ItemProperty
Set-ItemProperty

共用方式為