Convert-Path
Převede cestu z cesty Windows PowerShellu na cestu zprostředkovatele Windows PowerShellu.
Syntax
Path (Výchozí)
Convert-Path
[-Path] <String[]>
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Convert-Path
-LiteralPath <String[]>
[-UseTransaction]
[<CommonParameters>]
Description
Rutina Convert-Path převede cestu z cesty Windows PowerShellu na cestu zprostředkovatele Windows PowerShellu.
Příklady
Příklad 1: Převedení pracovního adresáře na standardní cestu k systému souborů
PS C:\> Convert-Path .
Tento příkaz převede aktuální pracovní adresář, který je reprezentován tečkou (.) na standardní cestu k systému souborů.
Příklad 2: Převod cesty zprostředkovatele na standardní cestu registru
PS C:\> Convert-Path HKLM:\Software\Microsoft
Tento příkaz převede cestu zprostředkovatele Windows PowerShellu na standardní cestu registru.
Příklad 3: Převedení cesty na řetězec
PS C:\> Convert-Path ~
C:\Users\User01
Tento příkaz převede cestu k domovskému adresáři aktuálního zprostředkovatele, což je zprostředkovatel FileSystem, na řetězec.
Parametry
-LiteralPath
Určuje jako pole řetězců cestu, která se má převést. Hodnota parametru LiteralPath se používá přesně při psaní. Žádný znak není interpretován jako zástupný znak. Pokud cesta obsahuje únikové znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají prostředí Windows PowerShell, aby nepřekládaly žádné znaky jako řídicí sekvence.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Sady parametrů
LiteralPath
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Path
Určuje cestu prostředí Windows PowerShell, která se má převést.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Path
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-UseTransaction
Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace najdete v tématu about_Transactions.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | usetx |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
K této rutině můžete převést cestu, ale ne literálovou cestu.
Výstupy
String
Tato rutina vrátí řetězec, který obsahuje převedenou cestu.
Poznámky
Rutiny, které obsahují jmenné jméno cesty, manipulují s názvy cest a vracejí názvy ve stručné podobě, které můžou interpretovat všichni poskytovatelé Windows PowerShellu. Jsou určené pro použití v programech a skriptech, ve kterých chcete zobrazit název cesty v určitém formátu nebo jeho část. Použijte je, jako byste použili Dirname, Normpath, Realpath, Join nebo jiné manipulátory cest.
Rutiny cesty můžete použít s několika poskytovateli, včetně zprostředkovatelů FileSystem, Registry a Certificate.
Tato rutina je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem. Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište
Get-PSProvider. Další informace najdete v tématu about_Providers.