Get-ItemPropertyValue
获取指定项的一个或多个属性的值。
语法
Get-ItemPropertyValue
[[-Path] <String[]>]
[-Name] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Get-ItemPropertyValue
-LiteralPath <String[]>
[-Name] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
说明
获取 Get-ItemPropertyValue
使用 Name 参数时指定的属性的当前值,该参数位于使用 Path 或 LiteralPath 参数指定的路径中。
示例
示例 1:获取 ProductID 属性的值
此命令获取 Windows 注册表提供程序中“\SOFTWARE\Microsoft\Windows NT\CurrentVersion”对象的 ProductID 属性的值。
Get-ItemPropertyValue HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion -Name ProductID
94253-50000-11141-AA785
示例 2:获取文件或文件夹的上次写入时间
此命令从在 FileSystem 提供程序中工作的“C:\Users\Test\Documents\ModuleToAssembly”文件夹中获取 LastWriteTime 属性的值,或者上次更改文件或文件夹的时间。
Get-ItemPropertyValue -Path C:\Users\Test\Documents\ModuleToAssembly -Name LastWriteTime
Wednesday, September 3, 2014 2:53:22 PM
示例 3:获取文件或文件夹的多个属性的值
此命令用于获取文件夹的 LastWriteTime、CreationTime 和 Root 属性的值。 这些属性值按照属性名称的指定顺序返回。
Get-ItemPropertyValue -Path C:\Users\Test\Documents\ModuleToAssembly -Name LastWriteTime,CreationTime,Root
Wednesday, September 3, 2014 2:53:22 PM
Wednesday, September 3, 2014 2:53:10 PM
Name : C:\
Parent :
Exists : True
Root : C:\
FullName : C:\
Extension :
CreationTime : 9/1/2014 4:59:45 AM
CreationTimeUtc : 9/1/2014 11:59:45 AM
LastAccessTime : 9/27/2014 5:22:02 PM
LastAccessTimeUtc : 9/28/2014 12:22:02 AM
LastWriteTime : 9/27/2014 5:22:02 PM
LastWriteTimeUtc : 9/28/2014 12:22:02 AM
Attributes : Hidden, System, Directory
BaseName : C:\
Target :
LinkType :
Mode : d--hs-
参数
-Credential
指定有权执行此操作的用户帐户。 默认为当前用户。
键入用户名,如“User01”或“Domain01\User01”;或输入 PSCredential 对象,如 Get-Credential
cmdlet 生成的一个 PSCredential 对象。
如果键入用户名,则将提示你输入密码。
警告
随同 Windows PowerShell 一起安装的任何提供程序都不支持此参数。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
指定此 cmdlet 将从操作中排除的一个项或多个项(作为一个字符串数组)。 此参数值使 Path 参数有效。 请输入路径元素或模式,例如“*.txt”。 允许使用通配符。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
以提供程序的格式或语言指定筛选器。 此参数值使 Path 参数有效。
筛选器的语法(包括通配符字符的使用),具体取决于提供程序。 筛选器比其他参数更高效,因为提供程序在 cmdlet 获取对象时应用它们,而不是在检索对象后让 PowerShell 筛选对象。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Include
指定此 cmdlet 将在操作中包含的一个项或多个项(作为一个字符串数组)。 此参数值使 Path 参数有效。 请输入路径元素或模式,例如“*.txt”。 允许使用通配符。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
指定此属性的当前位置的路径。 与 Path 参数不同,LiteralPath 的值严格按照所键入的形式使用。 不会将任何字符解释为通配符。 如果路径包括转义符,请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。
Type: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
指定要检索的属性的名称。
Type: | String[] |
Aliases: | PSProperty |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
指定一个或多个项的路径。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UseTransaction
在活动事务中使用该命令。 仅当正在执行事务时,此参数才有效。 有关详细信息,请参阅 about_Transactions。
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
可以通过管道将包含路径的字符串传递给此 cmdlet。
输出
System.Boolean, System.String, System.DateTime
此 cmdlet 为其所获取的每个项属性返回一个对象。 对象类型取决于检索的属性值。 例如,在文件系统驱动器中,该 cmdlet 可能会返回一个文件或文件夹。
备注
此 cmdlet 用于处理由任何提供程序公开的数据。 若要列出会话中可用的提供程序,请 Get-PSProvider
运行 cmdlet。 有关详细信息,请参阅 about_Providers。