Remove-ItemProperty

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 输入的一个 PSCredential 对象。如果键入用户名，则将提示您输入密码。

随同 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。

输出

None

此 cmdlet 不返回任何输出。

还可以使用 Remove-ItemProperty 的内置别名“rp”来对其进行引用。有关详细信息，请参阅 about_Alias。

在 Windows PowerShell Registry 提供程序中，注册表值被看作是注册表项或子项的属性。您可以使用 ItemProperty cmdlet 来管理这些值。

Remove-ItemProperty cmdlet 用于处理由任何提供程序公开的数据。要列出会话中可用的提供程序，请键入“Get-PSProvider”。有关详细信息，请参阅 about_Providers。

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

说明
-----------
此命令从 HKEY_LOCAL_MACHINE\Software 注册表项的 SmpApplication 子项中删除 SmpProperty 注册表值及其数据。

因为命令是从一个文件系统驱动器 (C:\PS>) 发出的，它包括到 SmpApplication 子项的完全限定路径，包括驱动器、HKLM: 和 Software 项。

它使用 Name 参数来标识要删除的注册表值。

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 参数在删除值之前请求用户提示消息。

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 参数指定该注册表值的名称。