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

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 till av den delade sökvägen och avgöra om sökvägen är relativ eller absolut. Om du delar en sökväg utan att ange några andra parametrar returnerar Split-Path den överordnade delen av sökvägen.

Kommandot Split-Path returnerar strängar. Den returnerar inte FileInfo- eller andra objektobjekt som *-Item kommandona gör.

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

HKCU:

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

När du använder parametern Leaf returnerar Split-Path endast det sista objektet i sökvägssträngen som angetts, oavsett om objektet är en fil eller en katalog.

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

*.txt

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

file1.txt
file2.txt

När du använder parametern Resolve löser Split-Path sökvägssträngen och returnerar de objekt som sökvägen refererar till.

När du använder parametern Parent returnerar Split-Path endast den överordnade containerdelen av sökvägssträngen. Om Path-strängen inte innehåller en överordnad container returnerar Split-Path en tom sträng.

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

.\folder1

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

D:\temp\test\folder1

När du använder parametern Resolve löser Split-Path sökvägssträngen och returnerar den överordnade containerns fullständiga sökväg.

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

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

False

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

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

Kommandot inom parenteser använder Split-Path för att endast returnera den överordnade sökvägen som lagras i den inbyggda $PROFILE variabeln. Parametern Parent är standardparametern för delad plats. Därför kan du utelämna det från kommandot . Parenteserna dirigerar PowerShell för 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.

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

C:\Users\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.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka en sträng som innehåller en sökväg till den här cmdleten.

Den här cmdleten returnerar textsträngar. När du anger parametern Resolve returneras en sträng som beskriver objektens plats. Den returnerar inte objekt som representerar objekten, till exempel ett FileInfo- eller RegistryKey--objekt.

När du anger parametern IsAbsolute returnerar den här cmdleten ett booleskt värde.

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

• Cmdletarna som innehåller Path substantiv (cmdletarna Path) 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 en del av ett sökvägsnamn i ett visst format. Använd dem på det sätt som du använder Dirname, Normpath, Realpath, Joineller andra sökvägsmanipulatörer.

• Du kan använda cmdletarna Path tillsammans med flera leverantörer. Dessa inkluderar Filsystem, Register och Certifikatproviders.

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