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

Convert-Path

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

Преобразует путь из пути PowerShell в путь поставщика PowerShell.

Синтаксис

Convert-Path
       [-Path] <String[]>
       [-UseTransaction]
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [-UseTransaction]
       [<CommonParameters>]

Описание

Командлет Convert-Path преобразует путь из пути PowerShell в путь поставщика PowerShell.

Примеры

Пример 1. Преобразование рабочего каталога в стандартный путь к файловой системе

Этот пример преобразует текущий рабочий каталог, который представлен точкой (.), в стандартный путь файловой системы.

PS C:\> Convert-Path .
C:\

Пример 2. Преобразование пути поставщика в стандартный путь реестра

В этом примере путь поставщика PowerShell преобразуется в стандартный путь к реестру.

PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft

Пример 3. Преобразование пути в строку

В этом примере путь преобразуется в домашний каталог текущего поставщика, который является поставщиком FileSystem, в строку.

PS C:\> Convert-Path ~
C:\Users\User01

Параметры

-LiteralPath

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

Дополнительные сведения см. в about_Quoting_Rules.

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

-Path

Указывает путь PowerShell для преобразования.

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

-UseTransaction

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

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

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

String

Вы можете передать путь, но не литеральный путь к этому командлету.

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

String

Этот командлет возвращает строку, содержащую преобразованный путь.

Примечания

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

  • cvpa

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

Командлеты пути можно использовать с несколькими поставщиками, включая файловую систему, реестр и поставщики сертификатов .

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

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