Convert-Path
Converteert een pad van een PowerShell-pad naar een PowerShell-providerpad.
Syntaxis
Path (Standaard)
Convert-Path
[-Path] <String[]>
[<CommonParameters>]
LiteralPath
Convert-Path
-LiteralPath <String[]>
[<CommonParameters>]
Description
De Convert-Path-cmdlet converteert een pad van een PowerShell-pad naar een PowerShell-providerpad.
Voorbeelden
Voorbeeld 1: De werkmap converteren naar een standaardpad van het bestandssysteem
In dit voorbeeld wordt de huidige werkmap, die wordt vertegenwoordigd door een punt (.), geconverteerd naar een standaardpad naar het bestandssysteem.
PS C:\> Convert-Path .
C:\
Voorbeeld 2: Een providerpad converteren naar een standaardregisterpad
In dit voorbeeld wordt het Pad van de PowerShell-provider geconverteerd naar een standaardregisterpad.
PS C:\> Convert-Path HKLM:\Software\Microsoft
HKEY_LOCAL_MACHINE\Software\Microsoft
Voorbeeld 3: Een pad converteren naar een tekenreeks
In dit voorbeeld wordt het pad geconverteerd naar de basismap van de huidige provider, de bestandssysteemprovider, naar een tekenreeks.
PS C:\> Convert-Path ~
C:\Users\User01
Voorbeeld 4: Paden voor verborgen items converteren
Standaard retourneert Convert-Path geen verborgen items. In dit voorbeeld wordt de parameter Force gebruikt om verborgen items te vinden. De opdracht Get-Item bevestigt dat de map .git verborgen is. Als u Convert-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> Convert-Path .git*
D:\Git\PS-Docs\PowerShell-Docs\.github
D:\Git\PS-Docs\PowerShell-Docs\.gitattributes
D:\Git\PS-Docs\PowerShell-Docs\.gitignore
PS> Convert-Path .git* -Force
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
-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, als een tekenreeksmatrix, het pad dat moet worden geconverteerd. De waarde van de parameter LiteralPath wordt exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escape-tekens bevat, zet het dan tussen enkele aanhalingstekens. Enkele aanhalingstekens zorgen ervoor dat PowerShell geen tekens als escapesequenties interpreteert.
Zie about_Quoting_Rulesvoor meer informatie.
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 dat moet worden geconverteerd.
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 |
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 pad, maar geen letterlijk pad, doorsluisen naar deze cmdlet.
Uitvoerwaarden
String
Met deze cmdlet wordt een tekenreeks geretourneerd die het geconverteerde pad bevat.
Notities
PowerShell bevat de volgende aliassen voor Convert-Path:
- Alle platforms:
cvpa
De cmdlets met het naamwoord Path manipuleren padnamen en retourneren de namen in een beknopte indeling die alle PowerShell-providers kunnen interpreteren. Ze zijn ontworpen voor gebruik in programma's en scripts waarin u alle of een deel van een pad in een bepaalde indeling wilt weergeven. Gebruik ze zoals u Dirname, Normpath, Realpath, Joinof andere pad manipulators.
U kunt de pad-cmdlets gebruiken met verschillende providers, waaronder het Bestandssysteem, Registryen Certificate providers.
Deze cmdlet is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PSProvider. Zie about_Providersvoor meer informatie.
Convert-Path alleen bestaande paden converteert. Het kan niet worden gebruikt om een locatie te converteren die nog niet bestaat.
