Delen via

Split-Path

  • Referentie
Module:
Microsoft.PowerShell.Management

Retourneert het opgegeven deel van een pad.

Syntaxis

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. Er kunnen ook items worden opgehaald waarnaar wordt verwezen door het gesplitste pad en nagaan of het pad relatief of absoluut is. Als u een pad splitst zonder andere parameters op te geven, Split-Path wordt het bovenliggende deel van het opgegeven pad geretourneerd.

De Split-Path opdracht retourneert tekenreeksen. FileInfo of andere itemobjecten worden niet geretourneerd, zoals de *-Item opdrachten.

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: Bestandsbestandsgedeelte van het pad weergeven

Wanneer u de Leaf-parameter gebruikt, Split-Path wordt alleen het laatste item in de opgegeven padtekenreeks geretourneerd, ongeacht of dat item een bestand of map is.

Split-Path -Path .\folder1\*.txt -Leaf

*.txt

Split-Path -Path .\folder1\*.txt -Leaf -Resolve

file1.txt
file2.txt

Wanneer u de parameter Oplossen gebruikt, Split-Path wordt de opgegeven padtekenreeks omgezet en worden de items geretourneerd waarnaar wordt verwezen door het pad.

Voorbeeld 3: De bovenliggende container ophalen

Wanneer u de bovenliggende parameter gebruikt, Split-Path wordt alleen het bovenliggende containergedeelte van de opgegeven padtekenreeks geretourneerd. Als de padtekenreeks geen bovenliggende container bevat, Split-Path retourneert u een lege tekenreeks.

Split-Path -Path .\folder1\file1.txt -Parent

.\folder1

Split-Path -Path .\folder1\file1.txt -Parent -Resolve

D:\temp\test\folder1

Wanneer u de parameter Oplossen gebruikt, Split-Path wordt de opgegeven padtekenreeks omgezet en wordt het volledige pad van de bovenliggende container geretourneerd.

Voorbeeld 4: bepaalt of een pad absoluut is

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 (.), wordt het geretourneerd $False.

Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute

False

Voorbeeld 5: Locatie wijzigen in een opgegeven pad

Met deze opdracht wordt uw locatie gewijzigd in de map die het PowerShell-profiel bevat.

PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Users\User01\Documents\PowerShell>

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 parameter voor gesplitste locatie. Daarom kunt u deze weglaten uit de opdracht. De haakjes leiden 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:\Users\User01\My Documents\My Pictures' | Split-Path

C:\Users\User01\My Documents

Deze opdracht maakt gebruik van een pijplijnoperator (|) om een pad naar Split-Pathte 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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Extension

Geeft aan dat deze cmdlet alleen de extensie van het blad 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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-IsAbsolute

Geeft aan dat deze cmdlet retourneert $True als het pad absoluut is en $False of het relatief is. In Windows moet een absolute padtekenreeks beginnen met een providerstationaanduiding, zoals C: of HKCU:. Een relatief pad begint met een punt (.) of een punt-stip (..).

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

-Leaf

Wanneer u de Leaf-parameter gebruikt, Split-Path wordt alleen het laatste item in de opgegeven padtekenreeks geretourneerd, ongeacht of dat item een bestand of map is.

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

-LeafBase

Geeft aan dat deze cmdlet alleen de basisnaam van het blad 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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-LiteralPath

Hiermee geeft u de paden die moeten worden gesplitst. In tegenstelling tot het pad wordt de waarde van LiteralPath precies 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 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

-NoQualifier

Geeft aan dat deze cmdlet het pad retourneert zonder de kwalificatie. Voor het bestandssysteem of de registerproviders is de kwalificatie het station van het pad van de provider, 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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Parent

Split-Path retourneert alleen het bovenliggende containergedeelte van de opgegeven padtekenreeks. Als de padtekenreeks geen bovenliggende container bevat, Split-Path retourneert u een lege tekenreeks.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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 doorsluisen.

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

-Qualifier

Geeft aan dat deze cmdlet alleen de kwalificatie van het opgegeven pad retourneert. Voor het bestandssysteem of de registerproviders is de kwalificatie het station van het pad van de provider, zoals C: of HKCU:.

Type:SwitchParameter
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Resolve

Geeft aan dat met deze cmdlet de items worden weergegeven waarnaar wordt verwezen door het resulterende gesplitste pad in plaats van de padelementen weer te geven.

Type:SwitchParameter
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

String

Met deze cmdlet worden teksttekenreeksen geretourneerd. Wanneer u de parameter Resolve opgeeft, wordt een tekenreeks geretourneerd die de locatie van de items beschrijft. Het retourneert geen objecten 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 parameters voor gesplitste locaties (Kwalificatie, Parent, Extension, Leaf, LeafBase en NoQualifier) zijn exclusief. U kunt slechts één in elke opdracht gebruiken.

  • De cmdlets die het naamwoord Path (de Path-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 waarin u de volledige of een deel van een padnaam in een bepaalde indeling wilt weergeven. Gebruik ze op de manier waarop u Dirname, Normpath, Realpath, Join of andere pad manipulators zou gebruiken.

  • U kunt de Pad-cmdlets samen met verschillende providers gebruiken. Dit zijn onder andere 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 Get-PSProvideru . Zie about_Providers voor meer informatie.