Convert-Path
Konverterar en sökväg från en PowerShell-sökväg till en PowerShell-providersökväg.
Syntax
Path (Standard)
Convert-Path
[-Path] <String[]>
[<CommonParameters>]
LiteralPath
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 returnerar Convert-Path inte dolda objekt. I det här exemplet används parametern Force för att hitta dolda objekt. Kommandot Get-Item bekräftar att mappen .git är dold. Om du använder Convert-Path utan parametern Force returneras endast de synliga objekten. Om du lägger till parametern Force 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. Parametern Force åsidosätter inte säkerhetsbegränsningar. Implementeringen varierar mellan olika leverantörer. Mer information finns i om_Leverantörer.
Den här parametern lades till i PowerShell 7.5-preview.5.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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 wildcards. 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.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | PSPath, SP |
Parameteruppsättningar
LiteralPath
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Path
Anger den PowerShell-sökväg som ska konverteras.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
Path
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
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 du skulle använda Dirname, Normpath, Realpath, Joineller andra sökvägsmanipulatörer.
Du kan använda sökvägs-cmdletar med flera providers, inklusive FileSystem, Registryoch Certificate providers.
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 om_Leverantörer.
Convert-Path konverterar bara befintliga sökvägar. Det kan inte användas för att konvertera en plats som inte finns ännu.
