Delen via


Resolve-Path

Hiermee worden de jokertekens in een pad omgezet en wordt de inhoud van het pad weergegeven.

Syntaxis

Path (Standaard)

Resolve-Path
    [-Path] <string[]>
    [-Relative]
    [-RelativeBasePath <string>]
    [-Credential <pscredential>]
    [-Force]
    [<CommonParameters>]

LiteralPath

Resolve-Path
    -LiteralPath <string[]>
    [-Relative]
    [-RelativeBasePath <string>]
    [-Credential <pscredential>]
    [-Force]
    [<CommonParameters>]

Description

De Resolve-Path cmdlet geeft de items en containers weer die overeenkomen met het jokertekenpatroon op de opgegeven locatie. De overeenkomst kan bestanden, mappen, registersleutels of een ander object bevatten dat toegankelijk is vanuit een PSDrive- provider.

Voorbeelden

Voorbeeld 1: Het pad naar de basismap oplossen

Het tilde-teken (~) is de verkorte notatie voor de basismap van de huidige gebruiker. In dit voorbeeld ziet u Resolve-Path de volledig gekwalificeerde padwaarde retourneert.

Resolve-Path ~
Path
----
C:\Users\User01

Voorbeeld 2: Het pad van de Windows-map oplossen

Resolve-Path -Path "windows"
Path
----
C:\Windows

Wanneer deze opdracht wordt uitgevoerd vanuit de hoofdmap van het C: station, retourneert deze opdracht het pad van de map Windows in het C: station.

Voorbeeld 3: Alle paden ophalen in de Windows-map

"C:\windows\*" | Resolve-Path

Met deze opdracht worden alle bestanden en mappen in de map C:\Windows geretourneerd. De opdracht maakt gebruik van een pijplijnoperator (|) om een padtekenreeks naar Resolve-Pathte verzenden.

Voorbeeld 4: Een UNC-pad oplossen

Resolve-Path -Path "\\Server01\public"

Met deze opdracht wordt een UNC-pad (Universal Naming Convention) omgezet en worden de shares in het pad geretourneerd.

Voorbeeld 5: Relatieve paden ophalen

Resolve-Path -Path "C:\prog*" -Relative
.\Program Files
.\Program Files (x86)
.\programs.txt

Met deze opdracht worden relatieve paden voor de mappen in de hoofdmap van het C: station geretourneerd.

Voorbeeld 6: Een pad met vierkante haken oplossen

In dit voorbeeld wordt de parameter LiteralPath gebruikt om het pad van de submap Test[xml] op te lossen. Als u LiteralPath gebruikt, worden de vierkante haken behandeld als normale tekens in plaats van een reguliere expressie.

Resolve-Path -LiteralPath 'test[xml]'

Voorbeeld 7: Een pad ten opzichte van een andere map oplossen

In dit voorbeeld wordt de parameter RelativeBasePath gebruikt om het pad van het uitvoerbare pwsh ten opzichte van $Env:TEMPop te lossen. Wanneer de opdracht de parameter Relatieve switch bevat, wordt een tekenreeks geretourneerd die het relatieve pad van $Env:TEMP naar het uitvoerbare pwsh vertegenwoordigt.

$ExecutablePath = Get-Command -Name pwsh | Select-Object -ExpandProperty Source
Resolve-Path -Path $ExecutablePath -RelativeBasePath $Env:TEMP -Relative
..\..\..\..\..\Program Files\PowerShell\7\pwsh.exe

Voorbeeld 8: Paden voor verborgen items oplossen

Standaard retourneert Resolve-Path geen verborgen items. In dit voorbeeld wordt de parameter Force gebruikt om verborgen items op te lossen. De opdracht Get-Item bevestigt dat de map .git verborgen is. Als u Resolve-Path zonder de parameter Forceren gebruikt, worden alleen de zichtbare items geretourneerd. Als u de parameter Forceren toevoegt, worden alle items, inclusief verborgen items, geretourneerd.

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

Parameters

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. De standaardwaarde is de huidige gebruiker.

Typ een gebruikersnaam, zoals User01 of Domain01\User01, of geef een PSCredential--object door. U kunt een PSCredential--object maken met behulp van de cmdlet Get-Credential. Als u een gebruikersnaam typt, wordt u door deze cmdlet gevraagd om een wachtwoord.

Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met PowerShell.

Parametereigenschappen

Type:PSCredential
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Force

Hiermee kan de cmdlet items ophalen die anders niet kunnen worden geopend door de gebruiker, zoals verborgen bestanden of systeembestanden. De parameter Force overschrijdt geen beveiligingsbeperkingen. De implementatie varieert per provider. Zie about_Providersvoor meer informatie.

Deze parameter is toegevoegd in PowerShell 7.5-preview.5.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-LiteralPath

Hiermee geeft u het pad dat moet worden omgezet. De waarde van de parameter LiteralPath wordt exact zoals getypt gebruikt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens ('). Enkele aanhalingstekens zorgen ervoor dat PowerShell geen tekens als escapesequenties interpreteert.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:PSPath, LP

Parametersets

LiteralPath
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Path

Hiermee geeft u het PowerShell-pad op dat moet worden omgezet. Deze parameter is vereist. U kunt ook een padtekenreeks doorsluisen naar Resolve-Path. Jokertekens zijn toegestaan.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

Path
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Relative

Geeft aan dat deze cmdlet een relatief pad retourneert.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Path
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
LiteralPath
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RelativeBasePath

Hiermee geeft u een pad op waaruit het relatieve pad moet worden omgezet. Wanneer u deze parameter gebruikt, retourneert de cmdlet het System.Management.Automation.PathInfo object voor het opgeloste pad.

Wanneer u deze parameter gebruikt met de parameter Relatieve switch, retourneert de cmdlet een tekenreeks die het relatieve pad weergeeft van RelativeBasePath- naar Pad.

Deze parameter is toegevoegd in PowerShell 7.4.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

U kunt een tekenreeks die een pad naar deze cmdlet bevat, doorgeven.

Uitvoerwaarden

PathInfo

Deze cmdlet retourneert standaard een PathInfo--object.

String

Als u de parameter Relatieve opgeeft, retourneert deze cmdlet een tekenreekswaarde voor het opgeloste pad.

Notities

PowerShell bevat de volgende aliassen voor Resolve-Path:

  • Alle platforms:
    • rvpa

De *-Path cmdlets werken met het Bestandssysteem, Registryen Certificate providers.

Resolve-Path is ontworpen om met elke provider te werken. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PSProvider. Zie about_Providersvoor meer informatie.

Resolve-Path alleen bestaande paden oplost. Het kan niet worden gebruikt om een locatie op te lossen die nog niet bestaat.