Dela via


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.