Dela via


Convert-Path

Konverterar en sökväg från en PowerShell-sökväg till en PowerShell-providersökväg.

Syntax

Convert-Path
       [-Path] <String[]>
       [-UseTransaction]
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [-UseTransaction]
       [<CommonParameters>]

Description

Cmdleten Convert-Path konverterar en sökväg från en PowerShell-sökväg till en PowerShell-providersökväg.

Exempel

Exempel 1: Konvertera arbetskatalogen till en standardsökväg för filsystemet

I det här exemplet konverteras den aktuella arbetskatalogen, som representeras av en punkt (.), till en standardsökväg för FileSystem.

PS C:\> Convert-Path .
C:\

Exempel 2: Konvertera en providersökväg till en standardregistersökväg

Det här exemplet konverterar PowerShell-providersökvägen till en standardregistersökväg.

PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft

Exempel 3: Konvertera en sökväg till en sträng

I det här exemplet konverteras sökvägen till hemkatalogen för den aktuella providern, som är FileSystem-providern, till en sträng.

PS C:\> Convert-Path ~
C:\Users\User01

Parametrar

-LiteralPath

Anger sökvägen som ska konverteras som en strängmatris. Värdet för parametern LiteralPath används exakt som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.

Mer information finns i about_Quoting_Rules.

Typ:String[]
Alias:PSPath
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Path

Anger den PowerShell-sökväg som ska konverteras.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-UseTransaction

Innehåller kommandot i den aktiva transaktionen. Den här parametern är endast giltig när en transaktion pågår. Mer information finns i about_transactions.

Typ:SwitchParameter
Alias:usetx
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Du kan skicka en sökväg, men inte en literal sökväg, till den här cmdleten.

Utdata

String

Den här cmdleten returnerar en sträng som innehåller den konverterade sökvägen.

Kommentarer

Windows PowerShell innehåller följande alias för Convert-Path:

  • cvpa

Cmdletarna som innehåller path-substantivet manipulerar sökvägsnamnen och returnerar namnen i ett kortfattat format som alla PowerShell-leverantörer kan tolka. De är utformade för användning i program och skript där du vill visa hela eller en del av en sökväg i ett visst format. Använd dem som om du skulle använda Dirname, Normpath, Realpath, Join eller andra sökvägsmanipulatörer.

Du kan använda sökvägs-cmdletar med flera leverantörer, inklusive Filsystem, Register och Certifikatprovidrar .

Den här cmdleten är utformad för att fungera med data som exponeras av alla leverantörer. Om du vill visa en lista över tillgängliga leverantörer i sessionen skriver du Get-PSProvider. Mer information finns i about_Providers.

Convert-Path konverterar endast befintliga sökvägar. Det kan inte användas för att konvertera en plats som inte finns ännu.