Sdílet prostřednictvím


Convert-Path

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

Syntax

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

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