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

Resolve-Path

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

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

Синтаксис

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

Описание

Командлет Resolve-Path отображает элементы и контейнеры, соответствующие шаблону подстановочных знаков в указанном расположении. Совпадение может включать файлы, папки, разделы реестра или любой другой объект, доступный из поставщика PSDrive.

Примеры

Пример 1. Разрешение пути к домашней папке

Символ тильды (~) — это сокращенная нотация для домашней папки текущего пользователя. В этом примере показано, Resolve-Path возвращает полное значение пути.

Resolve-Path ~

Path
----
C:\Users\User01

Пример 2. Разрешение пути к папке Windows

Resolve-Path -Path "windows"

Path
----
C:\Windows

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

Пример 3. Получение всех путей в папке Windows

"C:\windows\*" | Resolve-Path

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

Пример 4. Разрешение пути UNC

Resolve-Path -Path "\\Server01\public"

Эта команда разрешает путь универсального соглашения об именовании (UNC) и возвращает общие папки в пути.

Пример 5. Получение относительных путей

Resolve-Path -Path "c:\prog*" -Relative

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

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

Пример 6. Разрешение пути, содержащего квадратные скобки

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

Resolve-Path -LiteralPath 'test[xml]'

Параметры

-Credential

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

Введите имя пользователя, например User01 или Domain01\User01, или передайте объект PSCredential. Можно создать объект PSCredential с помощью командлета Get-Credential. При вводе имени пользователя этот командлет запрашивает пароль.

Этот параметр не поддерживается поставщиками, установленными с помощью PowerShell.

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

-LiteralPath

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

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

-Path

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

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

-Relative

Указывает, что этот командлет возвращает относительный путь.

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

-UseTransaction

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

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

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

String

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

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

PathInfo

По умолчанию этот командлет возвращает объект PathInfo.

String

Если указать параметр Относительной, этот командлет возвращает строковое значение для разрешенного пути.

Примечания

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

  • rvpa

Командлеты *-Path работают с файловой системы, реестраи поставщиками сертификатов.

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

Resolve-Path разрешает только существующие пути. Его нельзя использовать для разрешения расположения, которое еще не существует.