Sdílet prostřednictvím

Convert-Path

  • Reference
Modul:
Microsoft.PowerShell.Management

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

Syntaxe

Convert-Path
       [-Path] <String[]>
       [-UseTransaction]
       [<CommonParameters>]
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é znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají prostředí Windows PowerShell, aby nepřekládaly žádné znaky jako řídicí sekvence.

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 prostředí Windows PowerShell, 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: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.

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

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