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

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 на то, что не следует интерпретировать какие-либо символы как управляющие последовательности.

Дополнительную информацию см. в разделе 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

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

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

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

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