Поделиться через

Get-ItemPropertyValue

  • Ссылка
Модуль:
Microsoft.PowerShell.Management

Возвращает значение для одного или нескольких свойств указанного элемента.

Синтаксис

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:\Program Files\PowerShell, работающей в поставщике FileSystem.

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:22:24 AM
LastAccessTimeUtc   : 5/26/2021 2:22:24 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. Чтобы олицетворить другого пользователя или повысить свои учетные данные при выполнении этого командлета, используйте Invoke-Command.

Тип:PSCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Exclude

Указывает как строковый массив, элемент или элементы, которые этот командлет исключает в операции. Значение этого параметра квалифифициирует параметр Path. Введите элемент пути или шаблон, например *.txt. Разрешено использование подстановочных знаков. Параметр Исключить действует только в том случае, если команда включает содержимое элемента, например C:\Windows\*, где подстановочный знак указывает содержимое каталога C:\Windows.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Filter

Указывает фильтр для квалификации параметра Path. Поставщик файловой системы является единственным установленным поставщиком PowerShell, который поддерживает использование фильтров. Синтаксис для языка фильтрации файловой системы можно найти в about_Wildcards. Фильтры более эффективны, чем другие параметры, так как поставщик применяет их, когда командлет получает объекты, а не PowerShell фильтрует их после получения.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Include

Указывает, как строковый массив, элемент или элементы, которые этот командлет включает в операцию. Значение этого параметра квалифифициирует параметр Path. Введите элемент пути или шаблон, например "*.txt". Разрешено использование подстановочных знаков. Параметр Include действует только в том случае, если команда включает содержимое элемента, например C:\Windows\*, где подстановочный знак указывает содержимое каталога C:\Windows.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-LiteralPath

Указывает путь к одному или нескольким расположениям. Значение LiteralPath используется точно в том виде, в котором оно введено. Символы не интерпретируются как подстановочные знаки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки в PowerShell предотвращают интерпретацию символов как escape-последовательности.

Дополнительную информацию см. в about_Quoting_Rules.

Тип:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Указывает имя извлекаемого свойства или свойств.

Тип:String[]
Aliases:PSProperty
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Path

Указывает путь к элементу или элементам. Разрешено использование подстановочных знаков.

Тип:String[]
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:True

Входные данные

String

Можно передать строку, содержащую путь к этому командлету.

Выходные данные

PSObject

Этот командлет возвращает объект для каждого значения свойства элемента, которое он получает. Тип объекта зависит от значения свойства, полученного.

Примечания

PowerShell включает следующие псевдонимы для Get-ItemPropertyValue:

  • Все платформы:
    • gpv

Этот командлет предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы вывести список поставщиков, доступных в сеансе, выполните командлет Get-PSProvider. Дополнительные сведения см. в разделе about_Providers.