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

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.

Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.