Sdílet prostřednictvím

Convert-Path

  • Reference
Modul:
Microsoft.PowerShell.Management

Převede cestu z cesty PowerShellu na cestu zprostředkovatele PowerShellu.

Syntaxe

Convert-Path
       [-Path] <String[]>
       [-UseTransaction]
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [-UseTransaction]
       [<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

Parametry

-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é znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby nepřekládaly žádné znaky jako řídicí sekvence.

Další informace najdete v tématu about_Quoting_Rules.

Typ:String[]
Aliasy:PSPath
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Path

Určuje cestu PowerShellu, která se má převést.

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

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

Typ:SwitchParameter
Aliasy:usetx
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

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

Windows PowerShell obsahuje následující aliasy pro Convert-Path:

  • 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. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PSProvider. Další informace naleznete v tématu about_Providers.

Convert-Path převede pouze existující cesty. Nedá se použít k převodu umístění, které ještě neexistuje.