Split-Path

Returnerar den angivna delen av en sökväg.

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

Cmdleten Split-Path returnerar endast den angivna delen av en sökväg, till exempel den överordnade mappen, en undermapp eller ett filnamn. Den kan också hämta objekt som refereras av den delade sökvägen och avgöra om sökvägen är relativ eller absolut.

Du kan använda den här cmdleten för att hämta eller skicka endast en vald del av en sökväg.

Exempel

Exempel 1: Hämta kvalificeraren för en sökväg

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

HKCU:

Det här kommandot returnerar endast sökvägens kvalificerare. Kvalificeringen är drivkraften.

Exempel 2: Visa filnamn

Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve

Pass1.log
Pass2.log
...

Det här kommandot visar de filer som refereras av den delade sökvägen. Eftersom den här sökvägen är delad till det sista objektet, även kallat lövobjektet, visar kommandot endast filnamnen.

Parametern Resolve instruerar Split-Path att visa de objekt som refererar till den delade sökvägen i stället för att visa den delade sökvägen.

Precis som alla Split-Path kommandon returnerar det här kommandot strängar. Den returnerar inte FileInfo-objekt som representerar filerna.

Exempel 3: Hämta den överordnade containern

Split-Path -Path "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"

C:\WINDOWS\system32\WindowsPowerShell\V1.0

Det här kommandot returnerar endast sökvägens överordnade containrar. Eftersom den inte innehåller några parametrar för att ange delningen Split-Path använder standardvärdet för delad plats, som är Överordnad.

Exempel 4: Avgör om en sökväg är absolut

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

False

Det här kommandot avgör om sökvägen är relativ eller absolut. I det här fallet, eftersom sökvägen är relativ till den aktuella mappen, som representeras av en punkt (.), returnerar $Falseden .

Exempel 5: Ändra plats till en angiven sökväg

PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Documents and Settings\User01\My Documents\WindowsPowerShell>

Det här kommandot ändrar din plats till mappen som innehåller PowerShell-profilen.

Kommandot inom parentes använder Split-Path för att endast returnera den överordnade sökvägen som lagras i den inbyggda $Profile variabeln. Den överordnade parametern är standardparametern för delad plats. Därför kan du utelämna det från kommandot . Parenteserna dirigerar PowerShell till att köra kommandot först. Det här är ett användbart sätt att flytta till en mapp som har ett långt sökvägsnamn.

Exempel 6: Dela en sökväg med hjälp av pipelinen

'C:\Documents and Settings\User01\My Documents\My Pictures' | Split-Path

C:\Documents and Settings\User01\My Documents

Det här kommandot använder en pipelineoperator (|) för att skicka en sökväg till Split-Path. Sökvägen omges av citattecken för att indikera att det är en enda token.

Parametrar

-Credential

Anteckning

Den här parametern stöds inte av några providers som är installerade med PowerShell. Om du vill personifiera en annan användare eller höja dina autentiseringsuppgifter när du kör den här cmdleten använder du Invoke-Command.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Extension

Anger att denna cmdlet endast returnerar bladets förlängning. I sökvägen C:\Test\Logs\Pass1.logreturnerar den till exempel bara .log.

Den här parametern introducerades i PowerShell 6.0.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-IsAbsolute

Anger att denna cmdlet returnerar $True om sökvägen är absolut och $False om den är relativ. En absolut sökväg har en längd som är större än noll och använder inte en punkt (.) för att ange den aktuella sökvägen.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Leaf

Anger att denna cmdlet endast returnerar det sista objektet eller containern i sökvägen. I sökvägen C:\Test\Logs\Pass1.logreturnerar den till exempel bara Pass1.log.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-LeafBase

Anger att denna cmdlet endast returnerar lövets basnamn. I sökvägen C:\Test\Logs\Pass1.logreturnerar den till exempel bara Pass1.

Den här parametern introducerades i PowerShell 6.0.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

Anger de sökvägar som ska delas. Till skillnad från Path används värdet för LiteralPath exakt som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken instruerar PowerShell att inte tolka några tecken som escape-sekvenser.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-NoQualifier

Anger att denna cmdlet returnerar sökvägen utan kvalificeraren. För Filsystem eller registerprovidrar är kvalificeraren enheten för providersökvägen, till exempel C: eller HKCU:. I sökvägen C:\Test\Logs\Pass1.logreturnerar den till exempel bara \Test\Logs\Pass1.log.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Parent

Anger att denna cmdlet endast returnerar de överordnade containrarna för objektet eller för den container som anges av sökvägen. I sökvägen C:\Test\Logs\Pass1.logreturnerar C:\Test\Logsden till exempel . Den överordnade parametern är standardparametern för delad plats.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Path

Anger de sökvägar som ska delas. Jokertecken tillåts. Om sökvägen innehåller blanksteg omger du den inom citattecken. Du kan också skicka en sökväg till denna cmdlet.

Type:String[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

-Qualifier

Anger att denna cmdlet endast returnerar kvalificeraren för den angivna sökvägen. För Filsystem eller registerprovidrar är kvalificeraren enheten för providersökvägen, till exempel C: eller HKCU:.

Type:SwitchParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Resolve

Anger att denna cmdlet visar de objekt som refereras av den resulterande delade sökvägen i stället för att visa sökvägselementen.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Indata

String

Du kan skicka en sträng som innehåller en sökväg till denna cmdlet.

Utdata

System.String, System.Boolean

Split-Path returnerar textsträngar. När du anger parametern Split-PathResolve returnerar en sträng som beskriver platsen för objekten. Den returnerar inte objekt som representerar objekten, till exempel ett FileInfo- eller RegistryKey-objekt.

När du anger parametern Split-PathIsAbsolute returneras ett booleskt värde.

Kommentarer

  • Parametrarna för delad plats (Qualifier, Parent, Extension, Leaf, LeafBase och NoQualifier) är exklusiva. Du kan bara använda ett i varje kommando.

  • De cmdletar som innehåller path-substantivet (cmdletar för sökväg) fungerar med sökvägsnamn och returnerar namnen i ett kortfattat format som alla PowerShell-leverantörer kan tolka. De är utformade för användning i program och skript där du vill visa hela eller delar av ett sökvägsnamn i ett visst format. Använd dem på det sätt som du använder Dirname, Normpath, Realpath, Join eller andra sökvägsmanipulatörer.

  • Du kan använda path-cmdletarna tillsammans med flera providers. Dessa inkluderar filsystems-, register- och certifikatprovidrar.

  • Split-Path är utformad för att fungera med data som exponeras av alla leverantörer. Om du vill visa en lista över de providrar som är tillgängliga i sessionen skriver du Get-PSProvider. Mer information finns i about_Providers.