Convert-Path
Преобразует путь из пути PowerShell в путь поставщика PowerShell.
Синтаксис
Path (По умолчанию)
Convert-Path
[-Path] <String[]>
[-UseTransaction]
[<CommonParameters>]
LiteralPath
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[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | PSPath |
Наборы параметров
LiteralPath
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Path
Указывает путь PowerShell для преобразования.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
Path
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-UseTransaction
Включает команду в активную транзакцию. Этот параметр действителен только в том случае, если выполняется транзакция. Дополнительные сведения см. в about_Transactions.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | usetx |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
String
Вы можете передать путь, но не буквальный путь, в этот командлет.
Выходные данные
String
Этот командлет возвращает строку, содержащую преобразованный путь.
Примечания
Windows PowerShell включает следующие псевдонимы для Convert-Path:
cvpa
Командлеты, содержащие существительное Path, управляют именами путей и возвращают их в сжатом формате, который могут интерпретировать все поставщики PowerShell. Они предназначены для использования в программах и сценариях, где вы хотите отобразить все или часть пути в определенном формате. Используйте их, как вы бы использовали Dirname, Normpath, Realpath, Joinили другие манипуляторы пути.
Командлеты пути можно использовать с несколькими поставщиками, включая поставщика файловой системы , поставщика реестра и поставщика сертификатов .
Этот командлет предназначен для работы с данными, предоставляемыми любым провайдером. Чтобы вывести список поставщиков, доступных в сеансе, введите Get-PSProvider. Дополнительные сведения см. в разделе о поставщиках.
Convert-Path преобразует только существующие пути. Его нельзя использовать для преобразования расположения, которое еще не существует.
