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


Convert-Path

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

Синтаксис

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

Описание

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

Примеры

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

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

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.

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

-Path

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

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

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

String

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

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

String

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

Примечания

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

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

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

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

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

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