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

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

Пример 4. Преобразование путей для скрытых элементов

По умолчанию Convert-Path не возвращает скрытые элементы. В этом примере используется параметр Force для поиска скрытых элементов. Команда Get-Item подтверждает, что .git папка скрыта. Использование Convert-Path без параметра Force возвращает только видимые элементы. Добавление параметра Force возвращает все элементы, включая скрытые элементы.

PS> Get-Item .git -Force

    Directory: D:\Git\PS-Docs\PowerShell-Docs

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d--h-           9/25/2024  4:46 PM                .git

PS> Convert-Path .git*
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore

PS> Convert-Path .git* -Force
D:\Git\PS-Docs\PowerShell-Docs\.git
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore

Параметры

-Force

Позволяет командлету получать элементы, к которым в противном случае не удается получить доступ пользователю, например скрытые или системные файлы. Параметр Force не переопределяет ограничения безопасности. Реализация зависит от поставщика. Дополнительные сведения см. в about_Providers.

Этот параметр был добавлен в PowerShell 7.5-preview.5.

Тип:SwitchParameter
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LiteralPath

Указывает в виде строкового массива путь для преобразования. Значение параметра LiteralPath используется точно так же, как он типизированный. Никакие символы не интерпретируются как знаки подстановки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки говорят PowerShell не интерпретировать какие-либо символы как escape-последовательности.

Дополнительные сведения см. в about_Quoting_Rules.

Тип:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Path

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

Тип:String[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:True

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

String

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

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

String

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

Примечания

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

  • Все платформы:
    • cvpa

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

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

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

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