Get-ItemProperty
Получает свойства заданного элемента.
Синтаксис
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, таких как объекты, представляющие разделы реестра.
См. также
Концепции
about_Providers
Set-ItemProperty
Clear-ItemProperty
Copy-ItemProperty
Move-ItemProperty
New-ItemProperty
Remove-ItemProperty
Rename-ItemProperty