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[]>
       [<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

Příklad 4: Převod cest pro skryté položky

Ve výchozím nastavení Convert-Path nevrací skryté položky. Tento příklad používá parametr Force k vyhledání skrytých položek. Příkaz Get-Item potvrdí, že .git je složka 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 nepřepíše omezení zabezpečení. Implementace se liší mezi poskytovateli. Další informace najdete v tématu about_Providers.

Tento parametr byl přidán v PowerShellu 7.5-preview.5.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 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.

Typ:String[]
Aliasy:PSPath, LP
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

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.