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.