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

Convert-Path

  • Ссылка
Модуль:
Microsoft.PowerShell.Management

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

Синтаксис

Convert-Path
       [-Path] <String[]>
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [<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 не интерпретировать какие-либо символы как 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

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

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

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

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