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 |
Входные данные
Вы можете передать в этот командлет путь, но не литеральный путь.
Выходные данные
Этот командлет возвращает строку, содержащую преобразованный путь.
Примечания
PowerShell включает следующие псевдонимы для Convert-Path
:
- Для всех платформ.
cvpa
Командлеты, содержащие существительное Path, управляют именами путей и возвращают имена в кратком формате, который могут интерпретировать все поставщики PowerShell. Они предназначены для использования в программах и сценариях, где требуется отобразить весь или часть пути в определенном формате. Используйте их так же, как и Dirname, Normpath, Realpath, Join или другие манипуляторы пути.
Командлеты path можно использовать с несколькими поставщиками, включая поставщики файловой системы, реестра и сертификатов .
Этот командлет предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы вывести список поставщиков, доступных в данном сеансе, введите командлет Get-PSProvider
. Дополнительные сведения см. в разделе about_Providers.
Convert-Path
Преобразует только существующие пути. Его нельзя использовать для преобразования расположения, которое еще не существует.