Split-Path
Retourneert het opgegeven deel van een pad.
Syntax
Split-Path
[-Path] <String[]>
[-Parent]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-Leaf
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-LeafBase
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-Extension
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-Qualifier
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-NoQualifier
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
[-Resolve]
-IsAbsolute
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
-LiteralPath <String[]>
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
De cmdlet retourneert alleen het opgegeven deel van een pad, zoals de bovenliggende map, een submap of een bestandsnaam. Het kan ook items ophalen waarnaar wordt verwezen door het gesplitste pad en bepalen of het pad relatief of absoluut is.
U kunt deze cmdlet gebruiken om alleen een geselecteerd deel van een pad op te halen of te verzenden.
Voorbeelden
Voorbeeld 1: de kwalificatie van een pad ophalen
Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:
Met deze opdracht wordt alleen de kwalificatie van het pad geretourneerd. De kwalificatie is de drive.
Voorbeeld 2: bestandsnamen weergeven
Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve
Pass1.log
Pass2.log
...
Met deze opdracht worden de bestanden weergegeven waarnaar wordt verwezen door het gesplitste pad. Omdat dit pad is gesplitst naar het laatste item, ook wel het bladblad genoemd, geeft de opdracht alleen de bestandsnamen weer.
De parameter Resolve geeft Split-Path
aan dat de items moeten worden weergegeven waarnaar het gesplitste pad verwijst, in plaats van het gesplitste pad weer te geven.
Net als alle Split-Path
opdrachten retourneert deze opdracht tekenreeksen. Er worden geen FileInfo-objecten geretourneerd die de bestanden vertegenwoordigen.
Voorbeeld 3: De bovenliggende container ophalen
Split-Path -Path "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"
C:\WINDOWS\system32\WindowsPowerShell\V1.0
Met deze opdracht worden alleen de bovenliggende containers van het pad geretourneerd. Omdat deze geen parameters bevat om de splitsing op te geven, Split-Path
wordt de standaardinstelling voor de splitslocatie gebruikt, namelijk Bovenliggend.
Voorbeeld 4: Bepaalt of een pad absoluut is
Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute
False
Met deze opdracht wordt bepaald of het pad relatief of absoluut is. In dit geval, omdat het pad relatief is ten opzichte van de huidige map, die wordt vertegenwoordigd door een punt (.
), retourneert $False
het .
Voorbeeld 5: locatie wijzigen in een opgegeven pad
PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Documents and Settings\User01\My Documents\WindowsPowerShell>
Met deze opdracht wordt uw locatie gewijzigd in de map die het PowerShell-profiel bevat.
De opdracht tussen haakjes gebruikt Split-Path
om alleen het bovenliggende item van het pad te retourneren dat is opgeslagen in de ingebouwde $Profile
variabele. De bovenliggende parameter is de standaard gesplitste locatieparameter.
Daarom kunt u deze weglaten uit de opdracht. Met de haakjes wordt powershell om de opdracht eerst uit te voeren. Dit is een handige manier om naar een map met een lange padnaam te gaan.
Voorbeeld 6: een pad splitsen met behulp van de pijplijn
'C:\Documents and Settings\User01\My Documents\My Pictures' | Split-Path
C:\Documents and Settings\User01\My Documents
Deze opdracht maakt gebruik van een pijplijnoperator (|
) om een pad naar te Split-Path
verzenden. Het pad staat tussen aanhalingstekens om aan te geven dat het één token is.
Parameters
-Credential
Notitie
Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met PowerShell. Als u een andere gebruiker wilt imiteren of uw referenties wilt verhogen bij het uitvoeren van deze cmdlet, gebruikt u Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Extension
Geeft aan dat deze cmdlet alleen de extensie van de leaf retourneert. In het pad C:\Test\Logs\Pass1.log
wordt bijvoorbeeld alleen .log
geretourneerd.
Deze parameter is geïntroduceerd in PowerShell 6.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IsAbsolute
Geeft aan dat deze cmdlet retourneert $True
als het pad absoluut is en $False als het relatief is. Een absoluut pad heeft een lengte die groter is dan nul en gebruikt geen punt (.
) om het huidige pad aan te geven.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Leaf
Geeft aan dat deze cmdlet alleen het laatste item of de laatste container in het pad retourneert. In het pad C:\Test\Logs\Pass1.log
wordt bijvoorbeeld alleen Pass1.log geretourneerd.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LeafBase
Geeft aan dat deze cmdlet alleen de basisnaam van het blad retourneert. In het pad C:\Test\Logs\Pass1.log
wordt bijvoorbeeld alleen Pass1
geretourneerd.
Deze parameter is geïntroduceerd in PowerShell 6.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LiteralPath
Hiermee geeft u de paden die moeten worden gesplitst. In tegenstelling tot Path wordt de waarde van LiteralPath exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens vertellen PowerShell dat geen tekens als escape-reeksen worden geïnterpreteerd.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoQualifier
Geeft aan dat deze cmdlet het pad retourneert zonder de kwalificatie. Voor de bestandssysteem- of registerproviders is de kwalificatie het station van het providerpad, zoals C:
of HKCU:
. In het pad C:\Test\Logs\Pass1.log
wordt bijvoorbeeld alleen \Test\Logs\Pass1.log
geretourneerd.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Parent
Geeft aan dat deze cmdlet alleen de bovenliggende containers van het item of van de container retourneert die door het pad zijn opgegeven. In het pad C:\Test\Logs\Pass1.log
wordt bijvoorbeeld geretourneerd C:\Test\Logs
.
De bovenliggende parameter is de standaard gesplitste locatieparameter.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Hiermee geeft u de paden die moeten worden gesplitst. Jokertekens zijn toegestaan. Als het pad spaties bevat, plaatst u het tussen aanhalingstekens. U kunt ook een pad naar deze cmdlet doorsnijden.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Qualifier
Geeft aan dat deze cmdlet alleen de kwalificatie van het opgegeven pad retourneert. Voor de bestandssysteem- of registerproviders is de kwalificatie het station van het providerpad, zoals C:
of HKCU:
.
Type: | SwitchParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Resolve
Geeft aan dat deze cmdlet de items weergeeft waarnaar wordt verwezen door het resulterende gesplitste pad in plaats van de padelementen weer te geven.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
U kunt een tekenreeks doorsnijden die een pad naar deze cmdlet bevat.
Uitvoerwaarden
System.String, System.Boolean
Split-Path
retourneert tekenreeksen. Wanneer u de parameter Resolve opgeeft, Split-Path
retourneert een tekenreeks die de locatie van de items beschrijft; deze retourneert geen objecten die de items vertegenwoordigen, zoals een FileInfo - of RegistryKey-object .
Wanneer u de parameter IsAbsolute opgeeft, Split-Path
wordt een Booleaanse waarde geretourneerd.
Notities
De gesplitste locatieparameters (Kwalificatie, Bovenliggend, Extensie, Blad, Bladbasis en NoQualifier) zijn exclusief. U kunt slechts één in elke opdracht gebruiken.
De cmdlets die het pad-zelfstandig naamwoord (de pad-cmdlets ) bevatten, werken met 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 waarbij u een padnaam geheel of gedeeltelijk in een bepaalde indeling wilt weergeven. Gebruik ze op de manier waarop u Dirname, Normpath, Realpath, Join of andere padmanipulators gebruikt.
U kunt de Pad-cmdlets samen met verschillende providers gebruiken. Deze omvatten de bestandssysteem-, register- en certificaatproviders.
Split-Path
is ontworpen om te werken met de gegevens die door een provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt uGet-PSProvider
. Zie about_Providers voor meer informatie.