Resolve-Path

  • Referens
Modul:
Microsoft.PowerShell.Management

Löser jokertecken i en sökväg och visar sökvägens innehåll.

Syntax

Resolve-Path
       [-Path] <string[]>
       [-Relative]
       [-RelativeBasePath <string>]
       [-Credential <pscredential>]
       [<CommonParameters>]
Resolve-Path
       -LiteralPath <string[]>
       [-Relative]
       [-RelativeBasePath <string>]
       [-Credential <pscredential>]
       [<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 kan nås 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 hur du 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 enhetens C: rot returnerar det här kommandot sökvägen till Windows mappen på 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 C:\Windows mappen. 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å 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 pwsh körbara filen i förhållande till $env:TEMP. När kommandot innehåller parametern Relativ växel returneras en Sträng som representerar den relativa sökvägen från $env:TEMP till den pwsh körbara filen.

$ExecutablePath = Get-Command -Name pwsh | Select-Object -ExpandProperty Source
Resolve-Path -Path $ExecutablePath -RelativeBasePath $env:TEMP -Relative

..\..\..\..\..\Program Files\PowerShell\7\pwsh.exe

Parametrar

-Credential

Anger ett användarkonto som har behörighet att utföra den här åtgärden. Standard ä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.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Relative

Anger att den här cmdleten returnerar en relativ sökväg.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 parametern Relativ växel returnerar cmdleten en sträng som representerar den relativa sökvägen från RelativeBasePath till Sökväg.

Den här parametern lades till i PowerShell 7.4.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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 lösta sökvägen.

Kommentarer

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

  • Alla plattformar:
    • rvpa

Cmdletarna *-Path fungerar med filesystem-, register- och certifikatprovidrar .

Resolve-Path är utformad 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 about_providers.

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.