Move-ItemProperty 帮助信息

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

译者 : Edengundam( 马涛 )

 

Move-ItemProperty

 

大纲

将属性从一个位置移动到另一个位置 .

 

语法

Move-ItemProperty [-path] <string[]> [-destination] <string> [-name] <string[]> [-include <string[]>] [-force] [-passThru] [-exclude <string[]>] [-credential <PSCredential>] [-filter <string>] [-whatIf] [-confirm] [<CommonParamete

rs>]

 

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

 

详细描述

Move-ItemProperty cmdlet 将项的 属性移动到另一个项 . 例如 , 它能够从一个注册表项移动注册表项 ( 值 ) 到另一个注册表项 .  当你移动一个属性时 , 它在新位置被添加并从旧位置删除 .

 

参数

 

-path <string[]>

指定属性的当前位置路径 ( 译注 : 属性所位于的注册表项的位置 ). 允许使用通配符 .

 

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

 

-destination <string>

指定目标位置的路径 .

 

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

 

-name <string[]>

指定被移动的属性名称 .

 

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

 

-include <string[]>

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

 

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

 

-force <SwitchParameter>

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

 

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

 

-passThru <SwitchParameter>

输出此命令创建的对象到管道中 . 默认情况下 , 此命令不会将对象输出到管道 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	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[]>

指定属性的当前位置路径 . 与 Path 不同 , 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".

 

注意

 

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

 

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

 

Path, Destination 和 Name 参数的名称是可选项 . 如果你忽略了参数的名称 , 未命名的参数值必须按照下面顺序出现 : Path, Destination, Name. 如果你包含了参数名称 , 参数可以按照任何顺序出现 .

 

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

 

例 1

 

C:/PS>move-itemproperty HKLM:/Software/MyCompany/MyApp -Name `

Version -Destination HKLM:/Software/MyCompany/NewApp

 

此命令将位于 HKLM/Software/MyCompany 注册表项上 , MyApp 子项上的 "Version" 注册表值 ( 译注 : 既这个命令所指的属性 ) 及其对应的数据 , 移动到位于 HKLM/Software/MyCompany 注册表项上的子项 NewApp 上 .

 

 

相关链接

Clear-ItemProperty

New-ItemProperty

Copy-ItemProperty

Rename-ItemProperty

Get-ItemProperty

Set-ItemProperty

Remove-ItemProperty

about_namespace