Dela via

Convert-Path

  • Referens
Modul:
Microsoft.PowerShell.Management

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

Syntax

Convert-Path
       [-Path] <String[]>
       [<CommonParameters>]
Convert-Path
       -LiteralPath <String[]>
       [<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

Exempel 4: Konvertera sökvägar för dolda objekt

Som standard Convert-Path returnerar inte dolda objekt. I det här exemplet används force-parametern för att hitta dolda objekt. Kommandot Get-Item bekräftar att .git mappen är dold. Om du använder Convert-Path utan force-parametern returneras endast de synliga objekten. Om du lägger till force-parametern returneras alla objekt, inklusive dolda objekt.

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

Parametrar

-Force

Tillåter att cmdleten hämtar objekt som annars inte kan nås av användaren, till exempel dolda filer eller systemfiler. Force-parametern åsidosätter inte säkerhetsbegränsningar. Implementeringen varierar mellan olika leverantörer. Mer information finns i about_Providers.

Den här parametern lades till i PowerShell 7.5-preview.5.

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

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

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

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

  • Alla plattformar:
    • 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.