Разрешает значения подстановочных знаков в пути и отображает содержимое, находящееся по заданному пути.

Синтаксис

Resolve-Path [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Relative] [-UseTransaction] [<CommonParameters>]

Resolve-Path [-Path] <string[]> [-Credential <PSCredential>] [-Relative] [-UseTransaction] [<CommonParameters>]

Описание

Командлет Resolve-Path интерпретирует подстановочные знаки в пути и отображает элементы и контейнеры, которые находятся в указанном местоположении, например файлы и папки или разделы и подразделы реестра.

Параметры

-Credential <PSCredential>

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

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

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

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

false

Позиция?

named

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

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

true (ByPropertyName)

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

false

-LiteralPath <string[]>

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

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

true

Позиция?

1

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

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

true (ByPropertyName)

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

false

-Path <string[]>

Задает путь Windows PowerShell, который требуется разрешить. Это обязательный параметр. Можно также передать строку пути командлету Resolve-Path по конвейеру.

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

true

Позиция?

1

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

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

true (ByValue, ByPropertyName)

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

false

-Relative

Возвращает относительный путь.

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

false

Позиция?

named

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

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

false

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

false

-UseTransaction

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

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

false

Позиция?

named

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

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

false

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

false

<CommonParameters>

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

Ввод и вывод

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

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

System.String

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

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

System.String

Командлет Resolve-Path возвращает строку с разрешенным путем.

Примечания

Командлеты, в именах которых содержится существительное Path (командлеты Path), оперируют именами путей и возвращают эти имена в сокращенном формате, который поддерживается всеми поставщиками Windows PowerShell. Они предназначены для использования в программах и скриптах, в которых требуется отображать имя пути или его часть в конкретном формате. Используйте их аналогично другим командам для работы с путями, таким как Dirname, Normpath, Realpath и Join.

Командлеты Path можно использовать с несколькими поставщиками, включая FileSystem, Registry и Certificate.

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

Пример 1

C:\PS>resolve-path ~ 

C:\Users\User01

Описание
-----------
Эта команда разрешает путь, представленный символом "~", который обозначает путь к корневому каталогу.






Пример 2

C:\PS>resolve-path windows

C:\Windows

Описание
-----------
При запуске из корневого каталога диска C: эта команда возвращает путь к каталогу Windows на диске C:.






Пример 3

C:\PS>"C:\windows\*" | resolve-path

Описание
-----------
Эта команда возвращает все вложенные каталоги каталога C:\Windows. Эта команда передает строку пути командлету Resolve-Path с помощью оператора конвейера (|).






Пример 4

C:\PS>resolve-path \\Server01\public

Описание
-----------
Эта команда разрешает UNC-путь и возвращает ресурсы совместного использования этого пути.






Пример 5

C:\PS>resolve-path c:\prog* -relative

..\Program Files
..\Program Files (x86)
..\programs.txt

Описание
-----------
Эта команда возвращает относительные пути для каталогов в корне диска C:.






Пример 6

C:\PS>resolve-path -literalPath test[xml]

Описание
-----------
Эта команда разрешает путь ко вложенному каталогу Test[xml] текущего каталога. В ней используется параметр LiteralPath для указания, что скобки не являются символами регулярного выражения.






См. также