Получает элемент, находящийся в заданном местоположении.
Синтаксис
Get-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>] Get-Item [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Описание
Командлет Get-Item возвращает элемент из заданного местоположения. Извлечение содержимого заданного элемента производится только при запросе всего содержимого с помощью подстановочного знака (*).
Командлет Get-Item используется поставщиками Windows PowerShell для перемещения по хранилищам данных разных типов.
Параметры
-Credential <PSCredential>
Задает учетную запись пользователя, который располагает разрешением для выполнения этого действия. По умолчанию используется значение "Текущий пользователь".
Введите имя пользователя, например "User01" или "Domain01\User01", или введите объект PSCredential, например объект, создаваемый командлетом Get-Credential. При вводе имени пользователя система запросит пароль.
Этот параметр не поддерживается ни одним из установленных с Windows PowerShell поставщиком.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-Exclude <string[]>
Исключает указанные элементы. Значение этого параметра определяет значение параметра Path. Введите элемент пути или шаблон, например "*.txt". Подстановочные знаки разрешены.
Параметр Exclude действует только в том случае, если команда включает содержимое элемента, например "C:\Windows\*", где подстановочный знак определяет содержимое каталога "C:\Windows".
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Filter <string>
Задает фильтр с использованием формата или языка поставщика. Значение этого параметра определяет значение параметра Path. Синтаксис фильтра, в том числе использование подстановочных знаков, зависит от поставщика. Фильтры эффективнее других параметров, потому что поставщик применяет их при извлечении объектов (вместо использования Windows PowerShell для фильтрации извлеченных объектов).
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Force
Позволяет командлету получать элементы, которые недоступны другими способами, например скрытые элементы. Реализация варьируется от поставщика к поставщику. Дополнительные сведения см. в разделе About_Providers. Даже при использовании параметра Force командлет не может переопределить ограничения безопасности.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Include <string[]>
Извлекает только указанные элементы. Значение этого параметра определяет значение параметра Path. Введите элемент пути или шаблон, например "*.txt". Подстановочные знаки разрешены.
Параметр Include действует только в том случае, если команда включает содержимое элемента, например "C:\Windows\*", где подстановочный знак определяет содержимое каталога "C:\Windows".
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-LiteralPath <string[]>
Задает путь к элементу. В отличие от значения параметра Path, значение параметра LiteralPath используется точно в том виде, в котором оно введено. Никакие символы не интерпретируются как подстановочные знаки. Если путь включает escape-символы, его нужно заключить в одиночные кавычки. Одиночные кавычки указывают оболочке Windows PowerShell, что никакие символы не следует интерпретировать как escape-символы.
|
Обязательно? |
true |
|
Позиция? |
1 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-Path <string[]>
Задает путь к элементу. Для получения элемента, находящегося в указанном местоположении, используется командлет Get-Item. Подстановочные знаки разрешены. Этот параметр обязателен, но его имя ("Path") можно не указывать.
Для указания текущего местоположения используйте точку (.). Для указания всех элементов в текущем местоположении используйте подстановочный знак (*).
|
Обязательно? |
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-Item по конвейеру. |
|
Выходные данные |
Object Командлет Get-Item возвращает получаемые им объекты. Тип определяется типом объектов пути. |
Примечания
Командлет Get-Item также можно вызывать с помощью встроенного псевдонима "gi". Дополнительные сведения см. в разделе About_Aliases.
Командлет Get-Item не имеет параметра Recurse, так как он извлекает только элемент, а не его содержимое. Для рекурсивного извлечения содержимого элемента используется командлет Get-ChildItem.
При работе с реестром для извлечения разделов реестра используется командлет Get-Item, а для извлечения параметров и значений реестра используется командлет Get-ItemProperty. Параметры реестра являются свойствами раздела реестра.
Командлет Get-Item предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы получить список поставщиков, доступных в текущем сеансе, введите команду "Get-PsProvider". Дополнительные сведения см. в разделе About_Providers.
Пример 1
C:\PS>get-item . Directory: C:\ Mode LastWriteTime Length Name ---- ------------- ------ ---- d---- 7/26/2006 10:01 AM ps-test Описание ----------- Эта команда извлекает текущий каталог. Точка (.) обозначает элемент в текущем местоположении (но не его содержимое).
Пример 2
C:\PS>get-item * Directory: C:\ps-test Mode LastWriteTime Length Name ---- ------------- ------ ---- d---- 7/26/2006 9:29 AM Logs d---- 7/26/2006 9:26 AM Recs -a--- 7/26/2006 9:28 AM 80 date.csv -a--- 7/26/2006 10:01 AM 30 filenoext -a--- 7/26/2006 9:30 AM 11472 process.doc -a--- 7/14/2006 10:47 AM 30 test.txt Описание ----------- Эта команда извлекает все элементы из текущего каталога. Подстановочный знак (*) обозначает все содержимое текущего элемента.
Пример 3
C:\PS>get-item C:\ Описание ----------- Эта команда возвращает текущий каталог диска C:. Извлекаемый объект представляет только каталог, но не его содержимое.
Пример 4
C:\PS>get-item C:\* Описание ----------- Эта команда возвращает элементы диска C:. Подстановочный знак (*) обозначает не только сам контейнер, но и все его элементы. Для отображения всего содержимого в оболочке Windows PowerShell используется одиночная звездочка (*) вместо традиционного сочетания "*.*". Шаблон интерпретируется посимвольно, поэтому при использовании сочетания "*.*" не будут извлекаться каталоги и файлы с именами, не содержащими точки.
Пример 5
C:\PS>(get-item C:\Windows).LastAccessTime Описание ----------- Эта команда извлекает свойство LastAccessTime каталога C:\Windows. LastAccessTime является одним из свойств каталогов файловой системы. Чтобы отобразить полный список свойств каталога, введите команду "(Get-Item <имя_ папки>) | Get-Member".
Пример 6
C:\PS>get-item hklm:\software\microsoft\powershell\1\shellids\microsoft.powershell\* Описание ----------- Эта команда отображает содержимое раздела реестра Microsoft.PowerShell. При использовании поставщика Registry Windows PowerShell для извлечения разделов и вложенных разделов реестра можно использовать командлет Get-Item, однако для извлечения параметров и значений реестра нужно использовать командлет Get-ItemProperty.
Пример 7
C:\PS>get-item c:\Windows\* -include *.* -exclude w* Описание ----------- Эта команда извлекает элементы каталога Windows, имена которых включают точку (.) и не начинаются с буквы "w". Эта команда может использоваться только в том случае, когда для указания содержимого элемента в путь включается подстановочный знак (*).