Udostępnij za pośrednictwem

Convert-Path

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

Konwertuje ścieżkę ze ścieżki programu PowerShell na ścieżkę dostawcy programu PowerShell.

Składnia

Convert-Path
       [-Path] <String[]>
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [<CommonParameters>]

Opis

Polecenie Convert-Path cmdlet konwertuje ścieżkę ze ścieżki programu PowerShell do ścieżki dostawcy programu PowerShell.

Przykłady

Przykład 1. Konwertowanie katalogu roboczego na standardową ścieżkę systemu plików

Ten przykład konwertuje bieżący katalog roboczy reprezentowany przez kropkę (.) na standardową ścieżkę systemu plików.

PS C:\> Convert-Path .
C:\

Przykład 2. Konwertowanie ścieżki dostawcy na standardową ścieżkę rejestru

W tym przykładzie ścieżka dostawcy programu PowerShell jest konwertowana na standardową ścieżkę rejestru.

PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft

Przykład 3. Konwertowanie ścieżki na ciąg

Ten przykład konwertuje ścieżkę do katalogu macierzystego bieżącego dostawcy, który jest dostawcą systemu plików, na ciąg.

PS C:\> Convert-Path ~
C:\Users\User01

Przykład 4. Konwertowanie ścieżek dla ukrytych elementów

Domyślnie Convert-Path nie zwraca ukrytych elementów. W tym przykładzie użyto parametru Force do znalezienia ukrytych elementów. Polecenie Get-Item potwierdza, że .git folder jest ukryty. Użycie Convert-Path bez parametru Force zwraca tylko widoczne elementy. Dodanie parametru Force zwraca wszystkie elementy, w tym ukryte elementy.

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

Parametry

-Force

Umożliwia poleceniem cmdlet pobieranie elementów, do których w przeciwnym razie użytkownik nie może uzyskać dostępu, takich jak ukryte lub systemowe pliki. Parametr Force nie zastępuje ograniczeń zabezpieczeń. Implementacja różni się między dostawcami. Aby uzyskać więcej informacji, zobacz about_Providers.

Ten parametr został dodany w programie PowerShell 7.5-preview.5.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LiteralPath

Określa, jako tablicę ciągów, ścieżkę do przekonwertowania. Wartość parametru LiteralPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze znaki cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.

Typ:String[]
Aliasy:PSPath, LP
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Path

Określa ścieżkę programu PowerShell do przekonwertowania.

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

Dane wejściowe

String

Możesz przekazać ścieżkę, ale nie ścieżkę literału, do tego polecenia cmdlet.

Dane wyjściowe

String

To polecenie cmdlet zwraca ciąg zawierający przekonwertowaną ścieżkę.

Uwagi

Program PowerShell zawiera następujące aliasy dla programu Convert-Path:

  • Wszystkie platformy:
    • cvpa

Polecenia cmdlet zawierające skrót ścieżki manipulują nazwami ścieżek i zwracają nazwy w zwięzłym formacie, który mogą interpretować wszyscy dostawcy programu PowerShell. Są one przeznaczone do użytku w programach i skryptach, w których chcesz wyświetlić całą ścieżkę lub część ścieżki w określonym formacie. Użyj ich tak, jakby używać dirname, Normpath, Realpath, Join lub innych manipulatorów ścieżek.

Możesz użyć poleceń cmdlet ścieżki z kilkoma dostawcami, w tym z systemami plików, rejestrem i dostawcami certyfikatów .

To polecenie cmdlet jest przeznaczone do pracy z danymi udostępnianymi przez dowolnego dostawcę. Aby wyświetlić listę dostawców dostępnych w sesji, wpisz Get-PSProvider. Aby uzyskać więcej informacji, zobacz about_Providers.

Convert-Path konwertuje tylko istniejące ścieżki. Nie można jej użyć do konwersji lokalizacji, która jeszcze nie istnieje.