Convert-Path
Převede cestu z cesty PowerShellu na cestu zprostředkovatele PowerShellu.
Syntaxe
Path (Výchozí)
Convert-Path
[-Path] <String[]>
[<CommonParameters>]
LiteralPath
Convert-Path
-LiteralPath <String[]>
[<CommonParameters>]
Description
Rutina Convert-Path převede cestu z cesty PowerShellu na cestu zprostředkovatele PowerShellu.
Příklady
Příklad 1: Převedení pracovního adresáře na standardní cestu k systému souborů
Tento příklad převede aktuální pracovní adresář, který je reprezentován tečkou (.), na standardní cestu k systému souborů.
PS C:\> Convert-Path .
C:\
Příklad 2: Převod cesty zprostředkovatele na standardní cestu registru
Tento příklad převede cestu zprostředkovatele PowerShellu na standardní cestu registru.
PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft
Příklad 3: Převedení cesty na řetězec
Tento příklad převede cestu k domovskému adresáři aktuálního zprostředkovatele, což je zprostředkovatel FileSystem, na řetězec.
PS C:\> Convert-Path ~
C:\Users\User01
Příklad 4: Převod cest pro skryté položky
Ve výchozím nastavení Convert-Path nevrací skryté položky. V tomto příkladu se k vyhledání skrytých položek používá parametr Force. Příkaz Get-Item potvrdí, že je složka .git skrytá. Použití Convert-Path bez parametru Force vrátí pouze viditelné položky. Přidání parametru Force vrátí všechny položky včetně skrytých položek.
PS> Get-Item .git -Force
Directory: D:\Git\PS-Docs\PowerShell-Docs
Mode LastWriteTime Length Name
---- ------------- ------ ----
d--h- 9/25/2024 4:46 PM .git
PS> Convert-Path .git*
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore
PS> Convert-Path .git* -Force
D:\Git\PS-Docs\PowerShell-Docs\.git
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore
Parametry
-Force
Umožňuje rutině získat položky, ke kterým jinak uživatel nemá přístup, například skryté nebo systémové soubory. Parametr Force nemá schopnost přepsat omezení zabezpečení. Implementace se liší mezi poskytovateli. Pro více informací viz about_Providers.
Tento parametr byl přidán v PowerShellu 7.5-preview.5.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
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 |
-LiteralPath
Určuje jako pole řetězců cestu, která se má převést. Hodnota parametru LiteralPath se používá přesně tak, jak je zadaný. Žádný znak není interpretován jako zástupný znak. Pokud cesta obsahuje únikové znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby žádné znaky neinterpretoval jako únikové sekvence.
Další informace najdete v about_Quoting_Rules.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath, PO |
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 PowerShellu, která se má převést.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| 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 |
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
PowerShell obsahuje následující aliasy pro Convert-Path:
- Všechny platformy:
cvpa
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é PowerShellu. Jsou určené pro použití v programech a skriptech, ve kterých chcete zobrazit celou cestu nebo její část v určitém formátu. Použijte je, jako byste použili Dirname, normpath, realpath, Joinnebo jiné manipulátory cest.
Rutiny cesty můžete použít s několika poskytovateli, včetně FileSystem, Registrua poskytovatelů certifikátů.
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. Pro více informací viz about_Providers.
Convert-Path převede pouze existující cesty. Nedá se použít k převodu umístění, které ještě neexistuje.
