Split-Path

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[]>
    -IsAbsolute
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Split-Path
    -LiteralPath <String[]>
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

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, retourneert Split-Path het bovenliggende deel van het opgegeven pad.

De opdracht Split-Path retourneert tekenreeksen. Het retourneert geen FileInfo- of andere itemobjecten, zoals de *-Item opdrachten wel.

Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier

HKCU:

Met deze opdracht wordt alleen de kwalificatie van het pad geretourneerd. De kwalificatie is de drive.

Wanneer u de parameter Leaf gebruikt, retourneert Split-Path alleen het laatste item in de opgegeven padtekenreeks, 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 Resolve gebruikt, Split-Path de opgegeven padtekenreeks omgezet en worden de items geretourneerd waarnaar wordt verwezen door het pad.

Wanneer u de parameter Bovenliggende gebruikt, retourneert Split-Path alleen het bovenliggende containergedeelte van de opgegeven padtekenreeks. Als de pad- tekenreeks geen bovenliggende container bevat, retourneert Split-Path 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 Resolve gebruikt, wordt de opgegeven padtekenreeks Split-Path omgezet en wordt het volledige pad van de bovenliggende container geretourneerd.

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 het $false.

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

False

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 maakt gebruik van Split-Path om alleen het bovenliggende pad te retourneren dat is opgeslagen in de ingebouwde $PROFILE variabele. De parameter Bovenliggende is de standaardparameter 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.

'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.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een tekenreeks die een pad naar deze cmdlet bevat, doorgeven.

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.

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

• De parameters voor splitslocatie (Qualifier, Parent, Extension, Leaf, LeafBaseen NoQualifier) zijn exclusief. U kunt slechts één in elke opdracht gebruiken.

• De cmdlets die het Pad zelfstandig naamwoord (de cmdlets Path) 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, Joinof andere padmanipulors zou gebruiken.

• U kunt de Path 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 u Get-PSProvider. Zie about_Providersvoor meer informatie.