Delen via

Resolve-Path

  • Referentie
Module:
Microsoft.PowerShell.Management

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

Syntaxis

Resolve-Path
       [-Path] <string[]>
       [-Relative]
       [-RelativeBasePath <string>]
       [-Credential <pscredential>]
       [-Force]
       [<CommonParameters>]
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 een verkorte notatie voor de basismap van de huidige gebruiker. In dit voorbeeld ziet u Resolve-Path hoe de volledig gekwalificeerde padwaarde wordt geretourneerd.

Resolve-Path ~

Path
----
C:\Users\User01

Voorbeeld 2: Het pad van de Windows-map oplossen

Resolve-Path -Path "windows"

Path
----
C:\Windows

Wanneer deze wordt uitgevoerd vanuit de hoofdmap van het C: station, retourneert deze opdracht het pad van de Windows map 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 C:\Windows map geretourneerd. De opdracht maakt gebruik van een pijplijnoperator (|) om een padtekenreeks naar te Resolve-Pathverzenden.

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 Test[xml] submap 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 pwsh uitvoerbare bestand ten opzichte $env:TEMPvan . Wanneer de opdracht de parameter Relatieve switch bevat, retourneert deze een tekenreeks die het relatieve pad naar het pwsh uitvoerbare bestand $env:TEMP 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

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

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. Standaard is dit 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 Get-Credential cmdlet. 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.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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 overschrijft geen beveiligingsbeperkingen. De implementatie varieert per provider. Zie about_Providers voor meer informatie.

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

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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 geven PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd.

Type:String[]
Aliassen:PSPath, LP
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-Relative

Geeft aan dat deze cmdlet een relatief pad retourneert.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RelativeBasePath

Hiermee geeft u een pad op waaruit het relatieve pad moet worden omgezet. Wanneer u deze parameter gebruikt, retourneert de cmdlet het object System.Management.Automation.PathInfo 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 Path.

Deze parameter is toegevoegd in PowerShell 7.4.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een tekenreeks met een pad naar deze cmdlet doorsluisen.

Uitvoerwaarden

PathInfo

Deze cmdlet retourneert standaard een PathInfo-object .

String

Als u de relatieve parameter 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 de bestandssysteem-, register- en certificaatproviders.

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

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