Get-ItemPropertyValue
获取指定项的一个或多个属性的值。
语法
Get-ItemPropertyValue
[[-Path] <String[]>]
[-Name] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-ItemPropertyValue
-LiteralPath <String[]>
[-Name] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[<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:获取文件或文件夹的上次写入时间
此命令从C:\Program Files\PowerShell
在 FileSystem 提供程序中工作的文件夹中获取 LastWriteTime 属性的值,或者上次更改文件或文件夹时的值。
Get-ItemPropertyValue -Path 'C:\Program Files\PowerShell' -Name LastWriteTime
Wednesday, September 3, 2014 2:53:22 PM
示例 3:获取文件或文件夹的多个属性的值
此命令用于获取文件夹的 LastWriteTime、CreationTime 和 Root 属性的值。 这些属性值按照属性名称的指定顺序返回。
Get-ItemPropertyValue -Path 'C:\Program Files\PowerShell' -Name LastWriteTime,CreationTime,Root
Tuesday, March 23, 2021 6:53:13 AM
Monday, August 14, 2017 1:42:40 PM
Parent :
Root : C:\
FullName : C:\
Extension :
Name : C:\
Exists : True
CreationTime : 10/30/2015 1:28:30 AM
CreationTimeUtc : 10/30/2015 6:28:30 AM
LastAccessTime : 5/26/2021 9:24:04 AM
LastAccessTimeUtc : 5/26/2021 2:24:04 PM
LastWriteTime : 5/25/2021 7:25:08 AM
LastWriteTimeUtc : 5/25/2021 12:25:08 PM
Attributes : Hidden, System, Directory
Mode : d--hs
ModeWithoutHardLink : d--hs
BaseName : C:\
Target :
LinkType :
参数
-Credential
注意
随 PowerShell 一起安装的任何提供程序都不支持此参数。 若要模拟其他用户,或在运行此 cmdlet 时提升凭据,请使用 Invoke-Command。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
指定此 cmdlet 在操作中排除的一个或多个项作为字符串数组。 此参数值使 Path 参数有效。 请输入路径元素或模式,例如 *.txt
。 允许使用通配符。 仅当命令包含项的内容(例如 C:\Windows\*
),其中通配符指定目录的内容C:\Windows
时,Exclude 参数才有效。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
指定用于限定 Path 参数的筛选器。 FileSystem 提供程序是唯一支持使用筛选器的已安装 PowerShell 提供程序。 可以在 about_Wildcards 中找到 FileSystem 筛选器语言的语法。 筛选器比其他参数更高效,因为提供程序在 cmdlet 获取对象时应用它们,而不是在检索对象后让 PowerShell 筛选对象。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Include
指定此 cmdlet 将在操作中包含的一个项或多个项(作为一个字符串数组)。 此参数值使 Path 参数有效。 请输入路径元素或模式,例如 "*.txt"
。 允许使用通配符。 仅当命令包含项的内容(例如 C:\Windows\*
),其中通配符指定目录的内容C:\Windows
时,Include 参数才有效。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
指定一个或多个位置的路径。 LiteralPath 的值与键入时完全相同。 不会将任何字符解释为通配符。 如果路径包括转义符,请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。
有关详细信息,请参阅 about_Quoting_Rules。
Type: | String[] |
Aliases: | PSPath, LP |
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: | True |
输入
可以通过管道将包含路径的字符串传递给此 cmdlet。
输出
System.Boolean, System.String, System.DateTime
此 cmdlet 为其所获取的每个项属性返回一个对象。 对象类型取决于检索的属性值。 例如,在文件系统驱动器中,该 cmdlet 可能会返回一个文件或文件夹。
备注
此 cmdlet 用于处理由任何提供程序公开的数据。 若要列出会话中可用的提供程序,请 Get-PSProvider
运行 cmdlet。 有关详细信息,请参阅 about_Providers。