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

Resolve-Path

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

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

Синтаксис

Resolve-Path
       [-Path] <String[]>
       [-Relative]
       [-Credential <PSCredential>]
       [<CommonParameters>]
Resolve-Path
       -LiteralPath <String[]>
       [-Relative]
       [-Credential <PSCredential>]
       [<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 квадратные скобки обрабатываются как обычные символы, а не как регулярное выражение.

PS C:\> Resolve-Path -LiteralPath 'test[xml]'

Параметры

-Credential

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

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

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

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

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Relative

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

String

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

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

PathInfo

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

String

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

Примечания

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

  • Для всех платформ.
    • rvpa

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

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

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