Delen via

Split-Path

  • Referentie
Module:
Microsoft.PowerShell.Management

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 Split-Path 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 het station.

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 bladblad genoemd, geeft de opdracht alleen de bestandsnamen weer.

De parameter Resolve geeft aan Split-Path dat de items moeten worden weergegeven waarnaar het gesplitste pad verwijst, in plaats van dat het gesplitste pad wordt weergegeven.

Net als alle Split-Path opdrachten retourneert deze opdracht tekenreeksen. Het retourneert geen FileInfo-objecten die de bestanden vertegenwoordigen.

Voorbeeld 3: De bovenliggende container ophalen

Split-Path -Parent "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 splitsingslocatie 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 $Falsehet .

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 pad te retourneren dat is opgeslagen in de ingebouwde $Profile variabele. De bovenliggende parameter is de standaard splitslocatieparameter. Daarom kunt u deze weglaten in de opdracht. De haakjes sturen 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-Pathverzenden. 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. Gebruik Invoke-Command om een andere gebruiker te imiteren of uw referenties te verhogen bij het uitvoeren van deze cmdlet.

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.logwordt bijvoorbeeld alleen .loggeretourneerd.

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.logwordt bijvoorbeeld alleen Pass1.loggeretourneerd.

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 de leaf retourneert. In het pad C:\Test\Logs\Pass1.logwordt bijvoorbeeld alleen Pass1geretourneerd.

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 precies gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escape-tekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan 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 het bestandssysteem of registerproviders is de kwalificatie het station van het providerpad, zoals C: of HKCU:. In het pad C:\Test\Logs\Pass1.logwordt bijvoorbeeld alleen \Test\Logs\Pass1.loggeretourneerd.

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 die is opgegeven door het pad retourneert. In het pad C:\Test\Logs\Pass1.logwordt bijvoorbeeld geretourneerd C:\Test\Logs. De bovenliggende parameter is de standaard splitslocatieparameter.

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 het 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

String

U kunt een tekenreeks doorsnijden die een pad naar deze cmdlet bevat.

Uitvoerwaarden

String

Deze cmdlet retourneert teksttekenreeksen. Wanneer u de parameter Resolve opgeeft, wordt een tekenreeks geretourneerd die de locatie van de items beschrijft. Er worden geen objecten geretourneerd die de items vertegenwoordigen, zoals een FileInfo - of RegistryKey-object .

Boolean

Wanneer u de parameter IsAbsolute opgeeft, retourneert deze cmdlet een Booleaanse waarde.

Notities

  • De splitslocatieparameters (Kwalificatie, Bovenliggend, Extensie, Blad, LeafBase en NoQualifier) zijn exclusief. U kunt slechts één in elke opdracht gebruiken.

  • De cmdlets met het zelfstandig naamwoord Pad (de pad-cmdlets ) 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 deze 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 elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PSProvider. Zie about_Providers voor meer informatie.