Convert-Path
Konwertuje ścieżkę ze ścieżki programu PowerShell na ścieżkę dostawcy programu PowerShell.
Składnia
Path (domyślnie)
Convert-Path
[-Path] <String[]>
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Convert-Path
-LiteralPath <String[]>
[-UseTransaction]
[<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. Żadne znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze cudzysłowy wskazują programowi PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.
Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Zestawy parametrów
LiteralPath
| Position: | Named |
| Obowiązkowe: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Path
Określa ścieżkę programu PowerShell do przekonwertowania.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | True |
| DontShow: | False |
Zestawy parametrów
Path
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-UseTransaction
Zawiera polecenie w aktywnej transakcji. Ten parametr jest prawidłowy tylko wtedy, gdy transakcja jest w toku. Aby uzyskać więcej informacji, zobacz about_Transactions.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | usetx |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
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 Windows PowerShell zawiera następujące aliasy dla Convert-Path:
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, Joinlub innych manipulatorów ścieżek.
Możesz użyć poleceń cmdlet ścieżki z kilkoma dostawcami, w tym dostawcami FileSystem, Registryi dostawcami certyfikatów.
Cmdlet jest przeznaczony do pracy z danymi udostępnionymi 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.
