Set-ItemProperty 帮助信息

 

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

译者 : Edengundam( 马涛 )

 

Set-ItemProperty

 

大纲

设置指定位置的属性值 .

 

语法

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

 

Set-ItemProperty [-path] <string[]> -inputObject <psobject> [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-force] [-passThru] [-credential <PSCredential>] [-whatIf] [-confirm] [<CommonParameters>]

 

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

>]

 

Set-ItemProperty [-literalPath] <string[]> -inputObject <psobject> [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-force] [-passThru] [-credential <PSCredential>] [-whatIf] [-confirm] [<CommonParameters>]

 

详细描述

设置指定位置的属性值 . 能够支持不同位置的不同属性 .

 

参数

 

-path <string[]>

指定要设置属的性项目目录 .

 

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

 

-inputObject <psobject>

指定要设置的属性名称 .

 

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

 

-include <string[]>

指定那些要被此 cmdlet 处理的对象 , 忽略其他的 .

 

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

 

-exclude <string[]>

指定那些要被此 cmdlet 忽略的对象 , 处理其他的 .

 

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

 

-filter <string>

指定 providers 支持的和要求的过滤器元素 .

 

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

 

-force <SwitchParameter>

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

 

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

 

-passThru <SwitchParameter>

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

 

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

 

-credential <PSCredential>

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

 

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

 

-name <string>

指定属性的名称 .

 

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

 

-value <Object>

指定属性的值 .

 

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

 

-literalPath <string[]>

Specifies a path to the item property. 参数 -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 Set-ItemProperty  -detailed".需要技术信息, 输入 "Get-Help Set-ItemProperty -full".

 

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

 

例 1

 

C:/PS>set-itemproperty -name SmpProperty -Value exp

 

此命令设置 SmpProperty 的值为 exp.

 

相关链接

Get-ItemProperty

New-ItemProperty

Clear-ItemProperty

Remove-ItemProperty

Rename-ItemProperty

Move-ItemProperty

Copy-ItemProperty

about_namespace