Resolve-Path
Löser jokertecken i en sökväg och visar sökvägens innehåll.
Syntax
Path (Standard)
Resolve-Path
[-Path] <string[]>
[-Relative]
[-RelativeBasePath <string>]
[-Credential <pscredential>]
[-Force]
[<CommonParameters>]
LiteralPath
Resolve-Path
-LiteralPath <string[]>
[-Relative]
[-RelativeBasePath <string>]
[-Credential <pscredential>]
[-Force]
[<CommonParameters>]
Description
Cmdleten Resolve-Path visar de objekt och containrar som matchar jokerteckenmönstret på den angivna platsen. Matchningen kan innehålla filer, mappar, registernycklar eller andra objekt som är tillgängliga från en PSDrive- provider.
Exempel
Exempel 1: Lös sökvägen till hemmappen
Tilde-tecknet (~) är en kortfattad notation för den aktuella användarens hemmapp. Det här exemplet visar Resolve-Path returnerar det fullständigt kvalificerade sökvägsvärdet.
Resolve-Path ~
Path
----
C:\Users\User01
Exempel 2: Lös sökvägen till Windows-mappen
Resolve-Path -Path "windows"
Path
----
C:\Windows
När du kör från roten på den C: enheten returnerar det här kommandot sökvägen till mappen Windows i C:-enheten.
Exempel 3: Hämta alla sökvägar i Windows-mappen
"C:\windows\*" | Resolve-Path
Det här kommandot returnerar alla filer och mappar i mappen C:\Windows. Kommandot använder en pipelineoperator (|) för att skicka en sökvägssträng till Resolve-Path.
Exempel 4: Lösa en UNC-sökväg
Resolve-Path -Path "\\Server01\public"
Det här kommandot löser en UNC-sökväg (Universal Naming Convention) och returnerar resurserna i sökvägen.
Exempel 5: Hämta relativa sökvägar
Resolve-Path -Path "C:\prog*" -Relative
.\Program Files
.\Program Files (x86)
.\programs.txt
Det här kommandot returnerar relativa sökvägar för katalogerna i roten på den C: enheten.
Exempel 6: Lösa en sökväg som innehåller hakparenteser
I det här exemplet används parametern LiteralPath för att matcha sökvägen för undermappen Test[xml].
Om du använder LiteralPath behandlas hakparenteserna som normala tecken i stället för ett reguljärt uttryck.
Resolve-Path -LiteralPath 'test[xml]'
Exempel 7: Lösa en sökväg i förhållande till en annan mapp
I det här exemplet används parametern RelativeBasePath för att matcha sökvägen för den körbara pwsh i förhållande till $Env:TEMP. När kommandot innehåller växelparametern Relativ returneras en String- som representerar den relativa sökvägen från $Env:TEMP till den körbara pwsh.
$ExecutablePath = Get-Command -Name pwsh | Select-Object -ExpandProperty Source
Resolve-Path -Path $ExecutablePath -RelativeBasePath $Env:TEMP -Relative
..\..\..\..\..\Program Files\PowerShell\7\pwsh.exe
Exempel 8: Lösa sökvägar för dolda objekt
Som standard returnerar Resolve-Path inte dolda objekt. I det här exemplet används parametern Force för att lösa dolda objekt. Kommandot Get-Item bekräftar att mappen .git är dold. Om du använder Resolve-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> Resolve-Path .git*
Path
----
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore
PS> Resolve-Path .git* -Force
Path
----
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
-Credential
Anger ett användarkonto som har behörighet att utföra den här åtgärden. Standardvärdet är den aktuella användaren.
Ange ett användarnamn, till exempel User01 eller Domain01\User01, eller skicka ett PSCredential--objekt. Du kan skapa ett PSCredential--objekt med hjälp av cmdleten Get-Credential. Om du skriver ett användarnamn uppmanas du att ange ett lösenord i den här cmdleten.
Den här parametern stöds inte av några leverantörer som är installerade med PowerShell.
Parameteregenskaper
| Typ: | PSCredential |
| Standardvärde: | None |
| 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: | True |
| Värde från återstående argument: | False |
-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 den sökväg som ska matchas. Värdet för parametern LiteralPath används exakt som skrivet. 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.
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 matchas. Den här parametern krävs. Du kan också skicka en sökvägssträng till Resolve-Path. Jokertecken tillåts.
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 |
-Relative
Anger att den här cmdleten returnerar en relativ sökväg.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
Path
| 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
| 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 |
-RelativeBasePath
Anger en sökväg för att matcha den relativa sökvägen från. När du använder den här parametern returnerar cmdleten objektet System.Management.Automation.PathInfo för den lösta sökvägen.
När du använder den här parametern med växelparametern Relativ returnerar cmdleten en sträng som representerar den relativa sökvägen från RelativeBasePath till Path.
Den här parametern lades till i PowerShell 7.4.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| 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 |
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 sträng som innehåller en sökväg till den här cmdleten.
Utdata
PathInfo
Som standard returnerar den här cmdleten ett PathInfo- objekt.
String
Om du anger parametern Relativ returnerar den här cmdleten ett strängvärde för den matchade sökvägen.
Kommentarer
PowerShell innehåller följande alias för Resolve-Path:
- Alla plattformar:
rvpa
Cmdletarna *-Path fungerar med FileSystem, Registryoch Certificate providers.
Resolve-Path är utformat för att fungera med 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.
Resolve-Path löser bara befintliga sökvägar. Det kan inte användas för att lösa en plats som inte finns ännu.