Convert-Path
Преобразует путь из пути Windows PowerShell в путь поставщика Windows PowerShell.
Синтаксис
Convert-Path
[-Path] <String[]>
[-UseTransaction]
[<CommonParameters>]
Convert-Path
-LiteralPath <String[]>
[-UseTransaction]
[<CommonParameters>]
Описание
Командлет Convert-Path преобразует путь из пути Windows PowerShell в путь поставщика Windows PowerShell.
Примеры
Пример 1. Преобразование рабочего каталога в стандартный путь к файловой системе
PS C:\> Convert-Path .
Эта команда преобразует текущий рабочий каталог, который представлен точкой (.), в стандартный путь к файловой системе.
Пример 2. Преобразование пути поставщика в стандартный путь реестра
PS C:\> Convert-Path HKLM:\Software\Microsoft
Эта команда преобразует путь поставщика Windows PowerShell в стандартный путь реестра.
Пример 3. Преобразование пути в строку
PS C:\> Convert-Path ~
C:\Users\User01
Эта команда преобразует путь к домашнему каталогу текущего поставщика, который является поставщиком FileSystem, в строку.
Параметры
-LiteralPath
Указывает в виде строкового массива путь для преобразования. Значение параметра LiteralPath используется точно так же, как и тип. Символы не интерпретируются как подстановочные знаки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки говорят Windows PowerShell не интерпретировать какие-либо символы как escape-последовательности.
Тип: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Path
Указывает путь Windows PowerShell для преобразования.
Тип: | String[] |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-UseTransaction
Включает команду в активную транзакцию. Этот параметр действителен только в том случае, если выполняется транзакция. Дополнительные сведения см. в about_Transactions.
Тип: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Вы можете передать путь, но не литеральный путь к этому командлету.
Выходные данные
Этот командлет возвращает строку, содержащую преобразованный путь.
Примечания
Командлеты, содержащие имена путей, управляют именами путей и возвращают имена в кратком формате, который могут интерпретировать все поставщики Windows PowerShell. Они предназначены для использования в программах и сценариях, где необходимо отобразить все или часть имени пути в определенном формате. Используйте их, например, использовать Dirname, Нормпат, Realpath, Join или другие манипуляторы пути.
Командлеты пути можно использовать с несколькими поставщиками, включая файловую систему, реестр и поставщики сертификатов.
Этот командлет предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы вывести список поставщиков, доступных в сеансе, введите
Get-PSProvider
. Дополнительные сведения см. в about_Providers.