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 cmdlet Convert-Path 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

W tym przykładzie jest konwertowany 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

Parametry

-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.

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:False

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

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łą lub część nazwy ścieżki w określonym formacie. Użyj ich tak, jakby używać Dirname, Normpath, Realpath, Joinlub 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.