Get-ItemProperty 帮助信息

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

译者 : Edengundam( 马涛 )

 

Get-ItemProperty

 

大纲

取得指定项目的属性 .

 

语法

Get-ItemProperty [-path] <string[]> [[-name] <string[]>] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-credential <PSCredential>] [<CommonParameters>]

 

Get-ItemProperty [-literalPath] <string[]> [[-name] <string[]>] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-credential <PSCredential>] [<CommonParameters>]

 

详细描述

取得指定项目的属性 .

 

参数

 

-path <string[]>

指定项目的路径 .

 

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

 

-name <string[]>

指定取得的属性名称 .

 

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

 

-include <string[]>

包含指定项 .

 

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

 

-exclude <string[]>

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

 

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

 

-filter <string>

指定提供程序特定的过滤器 .

 

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

 

-credential <PSCredential>

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

 

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

 

-literalPath <string[]>

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

 

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

 

< 公共参数 >

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

 

返回类型

Object

 

例 1

 

C:/PS>get-itemproperty C:/Windows

 

此命令显示目录 C:/Windows 的信息 .

 

例 2

 

C:/PS>get-itemproperty C:/Test/Weather.xls | format-list

 

此命令取得文件 C:/Test/Weather.xls 的属性 . 结果通过管道发送给 format-list cmdlet, 后者将输出以列表形式显示 .

 

例 3

 

C:/PS>get-itemproperty -path HKLM:/SOFTWARE/Microsoft/Windows/CurrentVersion

 

此命令显示注册表 CurrentVersion 子项中包含的所有值名称及数据 . 注意此命令要求存在名为 HKLM: 的 PSdrive, 并且映射到注册表 HKEY_LOCAL_MACHINE. Windows PowerShell 默认情况下已经带有此名称且映射好的驱动器 . 除了示例的用法 , 此注册表子项的路径还可以指定为下面例子中的形式 , 提供程序名称后跟两个冒号最后是可选的路径 : Registry::HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Windows/CurrentVersion.

 

例 4

 

C:/PS>get-itemproperty -path HKLM:/SOFTWARE/Microsoft/Windows/CurrentVersion `

-name "ProgramFilesDir" | format-list ProgramFilesDir

 

此命令显示 CurrentVersion 注册表子项中包含的 ProgramFilesDir 注册表项的值名称和数据 . 子键通过参数 Path 指定 , 并且通过参数 Name 指定此项的值名称 . 注意 Get-ItemProperty cmdlet 的结果通过管道被发送给 Format-List cmdlet, 后者只取得那些感兴趣的注册表项信息 . 默认情况下 , Windows PowerShell 属性信息也包含在 Get-ItemProperty 的输出中 .

 

相关链接

Set-ItemProperty

Clear-ItemProperty

Copy-ItemProperty

Move-ItemProperty

New-ItemProperty

Remove-ItemProperty

Rename-ItemProperty

about_namespace