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
Эта команда получает значение свойства ProductID объекта \SOFTWARE\Microsoft\Windows NT\CurrentVersion в поставщике реестра Windows.
Get-ItemPropertyValue 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' -Name ProductID
94253-50000-11141-AA785
Пример 2. Получение времени последней записи файла или папки
Эта команда получает значение свойства LastWriteTime или время последнего изменения файла или папки из папки "C:\Users\Test\Documents\ModuleToAssembly", работающей в поставщике FileSystem.
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
Примечание
Этот параметр не поддерживается поставщиками, установленными с помощью PowerShell. Чтобы олицетворить другого пользователя или повысить уровень учетных данных при выполнении этого командлета, используйте Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
Указывает в качестве массива строк элемент или элементы, которые этот командлет исключает в операции. Значение этого параметра определяет параметр Path. Введите элемент пути или шаблон, например *.txt
. Можно использовать подстановочные знаки. Параметр Exclude действует только в том случае, если команда содержит содержимое элемента, например C:\Windows\*
, где подстановочный знак указывает содержимое C:\Windows
каталога.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Указывает фильтр для определения параметра Path . Поставщик FileSystem — единственный установленный поставщик PowerShell, поддерживающий использование фильтров. Синтаксис языка фильтрации файловой системы можно найти в about_Wildcards. Фильтры более эффективны, чем другие параметры, так как поставщик применяет их, когда командлет получает объекты, а не фильтрует объекты PowerShell после их извлечения.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Include
Указывает в качестве массива строк элемент или элементы, которые этот командлет включает в операцию. Значение этого параметра определяет параметр Path. Введите элемент пути или шаблон, например "*.txt"
. Можно использовать подстановочные знаки. Параметр Include действует, только если команда включает содержимое элемента, например C:\Windows\*
, где подстановочный знак указывает содержимое C:\Windows
каталога.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Указывает путь к одному или нескольким расположениям. Значение LiteralPath используется точно так же, как и в типизированном виде. Никакие символы не интерпретируются как знаки подстановки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки предписывают PowerShell не интерпретировать какие-либо символы как escape-последовательности.
Дополнительные сведения см. в разделе 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: | True |
-Path
Указывает путь к элементам. Можно использовать подстановочные знаки.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
Входные данные
В этот командлет можно передать по конвейеру строку, содержащую путь.
Выходные данные
System.Boolean, System.String, System.DateTime
Этот командлет возвращает объект для каждого значения свойства элемента, которое он получает. Тип объекта зависит от извлекаемого значения свойства. Например, на диске файловой системы командлет может вернуть файл или папку.
Примечания
Этот командлет предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы получить список поставщиков, доступных в сеансе Get-PSProvider
, выполните командлет . Дополнительные сведения см. в разделе about_Providers.