Получает свойства заданного элемента.

Синтаксис

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 получает свойства заданных элементов. Например, командлет Get-ItemProperty можно использовать для получения значения свойства LastAccessTime объекта файла. Командлет Get-ItemProperty можно также использовать для просмотра записей реестра и их значений.

Параметры

-Credential <PSCredential>

Задает учетную запись пользователя, который располагает разрешением для выполнения этого действия. По умолчанию используется значение "Текущий пользователь".

Введите имя пользователя, например "User01" или "Domain01\User01", или введите объект PSCredential, например объект, создаваемый командлетом Get-Credential. При вводе имени пользователя система запросит пароль.

Этот параметр не поддерживается ни одним из установленных с Windows PowerShell поставщиком.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByPropertyName)

Принимать подстановочные знаки?

false

-Exclude <string[]>

Исключает указанные элементы. Подстановочные знаки разрешены.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-Filter <string>

Задает фильтр с использованием формата или языка поставщика. Значение этого параметра определяет значение параметра Path. Синтаксис фильтра, в том числе использование подстановочных знаков, зависит от поставщика. Фильтры эффективнее других параметров, потому что поставщик применяет их при извлечении объектов (вместо использования Windows PowerShell для фильтрации извлеченных объектов).

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-Include <string[]>

Включает заданные элементы.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-LiteralPath <string[]>

Задает путь к свойству элемента. Значение параметра LiteralPath используется точно в том виде, в котором оно введено. Никакие символы не интерпретируются как подстановочные знаки. Если путь включает escape-символы, его нужно заключить в одиночные кавычки. Одиночные кавычки указывают оболочке Windows PowerShell, что никакие символы не следует интерпретировать как escape-символы.

Обязательно?

true

Позиция?

1

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByPropertyName)

Принимать подстановочные знаки?

false

-Name <string[]>

Задает имена извлекаемых свойств.

Обязательно?

false

Позиция?

2

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-Path <string[]>

Задает путь к элементам.

Обязательно?

true

Позиция?

1

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByValue, ByPropertyName)

Принимать подстановочные знаки?

false

-UseTransaction

Включает команду в активную транзакцию. Этот параметр допустим, только если транзакция выполняется. Дополнительные сведения см. в разделе about_Transactions.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

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

System.String

Строку, содержащую путь, можно передать командлету Get-ItemProperty по конвейеру.

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

Object

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

Примечания

Командлет Get-ItemProperty предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы получить список поставщиков, доступных в текущем сеансе, введите команду "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, который отображает его в виде списка.






Пример 3

C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion

Описание
-----------
Эта команда отображает имя параметра и значение для каждой записи реестра, содержащейся в подразделе реестра CurrentVersion. Обратите внимание, что команда требует наличия диска Windows PowerShell с именем HKLM:, который соответствует кусту реестра 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"

Описание
-----------
Эта команда получает имя и данные значения записи реестра ProgramFilesDir, содержащейся в подразделе реестра CurrentVersion. Параметр 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 извлекает записи реестра из раздела Microsoft.PowerShell. В этом подразделе хранятся параметры оболочки Windows PowerShell по умолчанию. Результаты показаны в следующем примере выходных данных.

Выходные данные показывают, что существует две записи реестра: Path и ExecutionPolicy. Если в разделе реестра содержится меньше пяти записей, по умолчанию его содержимое отображается в виде таблицы, однако отображение в виде списка зачастую является более удобным для просмотра.

Во второй команде используется тот же самый командлет Get-ItemProperty. Однако на этот раз применяется оператор конвейера (|), с помощью которого результаты выполнения команды передаются командлету Format-List. В команде Format-List используется параметр Property со значением * (все) для отображения всех свойств объектов в списке.  Результаты показаны в следующем примере выходных данных.

Выходными данными являются записи реестра Path и ExecutionPolicy, а также несколько менее известных свойств объекта раздела реестра. Другие свойства, имеющие префикс "PS", являются свойствами пользовательских объектов Windows PowerShell, таких как объекты, представляющие разделы реестра.






См. также




Содержание