Convert-Path

  • Reference
Modul:
Microsoft.PowerShell.Management

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

Syntax

Convert-Path
       [-Path] <String[]>
       [<CommonParameters>]
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 zadána. Žá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.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

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

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