Remove-ItemProperty 帮助信息

 

如下说明是翻译: help Remove-ItemProperty 产生的帮助信息.

译者: Edengundam(马涛)

 

Remove-ItemProperty

 

大纲

从一个项目中删除属性及其对应的值.

 

语法

Remove-ItemProperty [-path] <string[]> [-name] <string[]> [-include <string[]>] [-force] [-exclude <string[]>] [-credential <PSCredential>] [-filter <string>] [-whatIf] [-confirm] [<CommonParameters>]

 

Remove-ItemProperty [-literalPath] <string[]> [-name] <string[]> [-include <string[]>] [-force] [-exclude <string[]>] [-credential <PSCredential>] [-filter <string>] [-whatIf] [-confirm] [<CommonParameters>]

 

详细描述

emove-ItemProperty cmdlet从一个项目中删除属性及其对应的值. 你可以使用此命令删除注册表值及其存储的数据.

 

参数

 

-path <string[]>

指定包含了要移除属性的项目路径. 允许使用通配符.

 

强制参数?	true
参数位置?	1
默认值	N/A - 必须指定路径
允许从管道绑定输入?	true (根据值, 根据属性名)
允许通配符扩展?	true

 

-name <string[]>

指定要移除属性的名称.

 

强制参数?	true
参数位置?	2
默认值	String.empty
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	false

 

-include <string[]>

只删除指定的项目. 此参数值用于限定Path参数. 输入一个路径元素或模式, 例如"*.txt"(此参数允许通配符).允许使用通配符.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	true

 

-force <SwitchParameter>

在不破坏安全性的前提下, 能够避免影响命令成功执行的限制条件, 例如: Force参数能够覆盖具有只读属性的文件或创建路径中的必要成分, 但是不会改变人和文件的权限.

 

强制参数?	false
参数位置?	named
默认值	False
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-exclude <string[]>

忽略指定的项目. 此参数值用于限定Path参数. 输入一个路径元素或模式, 例如"*.txt"(此参数允许通配符).允许使用通配符.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	true

 

-credential <PSCredential>

使用其他凭证进行资源访问认证. <Credential>代表着用户名(例如: "User01"或"Domain01/User01") 或者PSCredential对象(例如: 通过Get-Credential cmdlet取得的对象). 如果此处使用用户名, 命令执行时会提示输入该用户密码. 尽管此参数出现, 但是并非所有Windows PowerShell核心cmdlets或providers支持此功能.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	false

 

-filter <string>

指定特定provider格式或语言的过滤器.此参数值用于限定Path参数. 过滤器的语法取决于provider(是否支持通配符也依赖provider). 过滤器相比其他参数更加有效, 主要因为provider取值时候使用过滤器, 而不是等到provider将所有内容返回后, 由Windows PowerShell 过滤对象.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	true

 

-literalPath <string[]>

指定项目属性的路径. 参数-LiteralPath的值将会按照输入的形式被使用. 不会对任何通配符进行解释. 如果路径中包含了转义字符, 需要将路径用单引号保护. 单引号指示Windows PowerShell不对字符串中的转义字符进行处理.

强制参数?	true
参数位置?	1
默认值
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	false

 

-whatIf

描述执行此命令将会发生的现象, 不会真正执行此命令.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-confirm

执行命令前提示你进行确认.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

<公共参数>

此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".

 

返回类型

None

 

注意

 

更多信息, 输入"Get-Help Remove-ItemProperty -detailed".需要技术信息, 输入"Get-Help Remove-ItemProperty -full".

 

在Windows PowerShell注册表提供程序中, 注册表值被认为是注册表键或子键的属性. 你可以使用ItemProperty类的cmdlet来管理这些值.

 

如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".

 

你可以使用Remove-ItemProperty内建别名"rp". 需要更多信息, 查看About_Alias.

 

例1

 

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

 

此命令从HKEY_LOCAL_MACHINE/Software项上, 删除SmpApplication子项的SmpProperty注册表值及其数据.

 

在Windows PowerShell的注册表中, 由于此命令是从文件系统驱动器上目录(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:)中的oftware/MyCompany/MyApp子项

 

第二个命令使用Remove-ItemProperty cmdlet从MyApp子项上删除注册表值Options及其数据. 因为Path参数是强制出现的, 此命令使用点(.)来指示在当前目录应用命令. 它使用Name参数指定哪些注册表值被删除. 通过使用Confirm参数要求在删除注册表值之前提示用户进行确认.

 

相关链接

Set-ItemProperty

Clear-ItemProperty

Copy-ItemProperty

Move-ItemProperty

New-ItemProperty

Get-ItemProperty

Rename-ItemProperty

about_namespace