Get-ItemProperty

获取指定项的属性。

语法

Get-ItemProperty [-LiteralPath] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]

Get-ItemProperty [-Path] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]

说明

Get-ItemProperty cmdlet 获取指定项的属性。例如，可以使用 Get-ItemProperty 来获取文件对象的 LastAccessTime 属性值。还可以使用 Get-ItemProperty 来查看注册表条目及其值。

参数

-Credential <PSCredential>

指定有权执行此操作的用户帐户。默认值为当前用户。

键入用户名，如“User01”或“Domain01\User01”；或输入 PSCredential 对象，如 Get-Credential cmdlet 生成的一个 PSCredential 对象。如果键入用户名，则将提示您输入密码。

随同 Windows PowerShell 一起安装的任何提供程序都不支持此参数。

-Exclude <string[]>

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

-Filter <string>

以提供程序的格式或语言指定筛选器。此参数的值对 Path 参数进行限定。筛选器的语法（包括通配符的使用）取决于提供程序。筛选器比其他参数更有效，因为提供程序是在检索对象时应用筛选器，而不是在检索对象后再由 Windows PowerShell 筛选对象。

-Include <string[]>

包括指定项。

-LiteralPath <string[]>

指定指向项属性的路径。LiteralPath 的值严格按照所键入的形式使用。不会将任何字符解释为通配符。如果路径包括转义符，请将其括在单引号中。单引号会告知 Windows PowerShell 不要将所有字符都解释为转义序列。

-Name <string[]>

指定要检索的属性的名称。

-Path <string[]>

指定一个或多个项的路径。

-UseTransaction

将命令包含在活动事务中。仅当正在执行事务时，此参数才有效。有关详细信息，请参阅 about_Transactions。

<CommonParameters>

此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.

输入和输出

输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。

说明

Get-ItemProperty cmdlet 用于处理由任何提供程序公开的数据。要列出会话中可用的提供程序，请键入“Get-PSProvider”。有关详细信息，请参阅 about_Providers。

示例 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: 的 Windows PowerShell 驱动器（映射到注册表的 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"

说明
-----------
此命令获取 CurrentVersion 注册表子项中的 ProgramFilesDir 注册表条目的值名称和数据。此命令使用 Path 参数来指定子项，使用 Name 参数来指定条目的值名称。

示例 5

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\PowerShellEngine

ApplicationBase         : C:\Windows\system32\WindowsPowerShell\v1.0\
ConsoleHostAssemblyName : Microsoft.PowerShell.ConsoleHost, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad
                          364e35, ProcessorArchitecture=msil
PowerShellVersion       : 2.0
RuntimeVersion          : v2.0.50727
CTPVersion              : 5
PSCompatibleVersion     : 1.0,2.0

说明
-----------
此命令获取 PowerShellEngine 注册表项中的注册表条目的值名称和数据。结果显示在下面的示例输出中。

示例 6

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell

Path                                                        ExecutionPolicy
----                                                        ---------------
C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe   RemoteSigned


C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell | format-list -property *

PSPath          : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds\Micro
                  soft.PowerShell
PSParentPath    : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds
PSChildName     : Microsoft.PowerShell
PSDrive         : HKLM
PSProvider      : Microsoft.PowerShell.Core\Registry
Path            : C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe
ExecutionPolicy : RemoteSigned

说明
-----------
此示例演示如何将 Get-ItemProperty 命令的输出格式设置为列表以便轻松查看注册表值和数据，以及方便地解释这些结果。

第一个命令使用 Get-ItemProperty cmdlet 来获取 Microsoft.PowerShell 子项中的注册表条目。此子项存储 Windows PowerShell 的默认 shell 的选项。结果显示在下面的示例输出中。

输出显示有两个注册表条目，分别是 Path 和 ExecutionPolicy。如果注册表项中包含的条目少于 5 个，则默认情况下，将以表的形式显示它，但通常列表形式更易于查看。

第二个命令使用相同的 Get-ItemProperty 命令。但是，该命令这一次使用管道运算符 (|) 将命令结果发送给 Format-List cmdlet。Format-List 命令使用值为 *（所有）的 Property 参数来以列表形式显示对象的所有属性。结果显示在下面的示例输出中。

生成的显示界面显示了 Path 和 ExecutionPolicy 注册表条目以及注册表项对象的几个不太熟悉的属性。以“PS”为前缀的其他属性是 Windows PowerShell 自定义对象（例如表示注册表项的对象）的属性。

另请参阅

概念

about_providers
Set-ItemProperty
Clear-ItemProperty
Copy-ItemProperty
Move-ItemProperty
New-ItemProperty
Remove-ItemProperty
Rename-ItemProperty