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 na ścieżkę 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

W tym przykładzie ścieżka jest konwertowana na katalog główny 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 konwersji. 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 je ująć w pojedynczy cudzysłów. Znaki pojedynczego cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 nazwę ścieżki ścieżki 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, jak można użyć dirname, Normpath, Realpath, Join lub innych manipulatorów ścieżek.

Możesz użyć poleceń cmdlet ścieżki z kilkoma dostawcami, w tym system plików, rejestr i dostawcy 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 przekonwertowania lokalizacji, która jeszcze nie istnieje.