New-ItemProperty 帮助信息

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

译者: Edengundam(马涛)

 

New-ItemProperty

 

大纲

在指定位置的项上, 设置一个新的属性.

 

语法

New-ItemProperty [-path] <string[]> [-name] <string> [-propertyType <string>] [-value <Object>] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-force] [-credential <PSCredential>] [-whatIf] [-confirm] [<CommonParameters>]

 

New-ItemProperty [-literalPath] <string[]> [-name] <string> [-propertyType <string>] [-value <Object>] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-force] [-credential <PSCredential>] [-whatIf] [-confirm] [<CommonParameters>]

 

详细描述

在指定位置的项上, 设置一个新的属性.

 

参数

 

-path <string[]>

新属性创建到的项的路径.

 

强制参数?	true
参数位置?	1
默认值	N/A - 路径必须指定
允许从管道绑定输入?	false
允许通配符扩展?	true

 

-name <string>

创建属性的名称.

 

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

 

-propertyType <string>

属性的类型.

 

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

 

-value <Object>

属性的值.

 

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

 

-include <string[]>

指定只由此cmdlet操作的对象, 排除所有其它对象.

 

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

 

-exclude <string[]>

忽略指定的项. 允许使用通配符.

 

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

 

-filter <string>

指定提供程序要求的和支持的过滤元素.

 

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

 

-force <SwitchParameter>

在不破坏安全性的前提下, 能够避免影响命令成功执行的限制条件, 例如: 更改已经存在的变量名.

 

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

 

-credential <PSCredential>

使用其他凭证进行资源访问认证. 如果指定了一个之前使用Get-Credential获得的PSCredential对象, 将会直接使用该对象. 如果此处使用用户名, 命令执行时会提示输入该用户密码.

 

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

 

-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".

 

返回类型

Object

 

注意

 

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

 

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

 

例1

 

C:/PS>new-itemproperty SmpApplication -name config -Type int -Value 1

 

此例子假设工作于注册表名字空间, 此名字空间中, 位于"HKLM:/Software"之下, 有名为"SmpApplication"储藏区(注册表中的键). 在储藏区中, 创建了一个名为"Exp"的整型类型的属性.

 

相关链接

Clear-ItemProperty

Copy-ItemProperty

Move-ItemProperty

Rename-ItemProperty

Get-ItemProperty

Set-ItemProperty

Remove-ItemProperty

about_namespace