Dela via

Split-Path

  • Referens
Modul:
Microsoft.PowerShell.Management

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 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 Split-Path returnerar den överordnade delen av den angivna sökvägen.

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

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

Exempel 2: Visa filnamnsdelen av sökvägen

När du använder leaf-parametern Split-Path returnerar 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 Split-Path Lös löser du sökvägssträngen och returnerar de objekt som sökvägen refererar till.

Exempel 3: Hämta den överordnade containern

När du använder parametern Split-Path Överordnad returnerar endast den överordnade containerdelen av sökvägssträngen som angetts. Om sökvägssträngen inte innehåller en överordnad container Split-Path returnerar 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 Split-Path Lös löser du sökvägssträngen som angetts och returnerar den överordnade containerns fullständiga sökväg.

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

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 .

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

False

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

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. Den överordnade parametern ä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.

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

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

Parametrar

-Credential

Kommentar

Den här parametern stöds inte av några leverantörer 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.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Extension

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

Den här parametern introducerades i PowerShell 6.0.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-IsAbsolute

Anger att denna cmdlet returnerar $True om sökvägen är absolut och $False om den är relativ. I Windows måste en absolut sökvägssträng börja med en providerenhetsspecificerare, t.ex C: . eller HKCU:. En relativ sökväg börjar med en punkt (.) eller en punkt-punkt (..).

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Leaf

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-LeafBase

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

Den här parametern introducerades i PowerShell 6.0.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-LiteralPath

Anger sökvägarna 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 gör att PowerShell inte tolkar några tecken som escape-sekvenser.

Typ:String[]
Alias:PSPath, LP
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NoQualifier

Anger att denna cmdlet returnerar sökvägen utan kvalificeraren. För FileSystem 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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Parent

Split-Path returnerar endast den överordnade containerdelen av sökvägssträngen som angetts. Om sökvägssträngen inte innehåller en överordnad container Split-Path returnerar en tom sträng.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Path

Anger sökvägarna 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 den här cmdleten.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-Qualifier

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

Typ:SwitchParameter
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Resolve

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

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

Utdata

String

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

Boolean

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

Kommentarer

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

  • Cmdletarna som innehåller path-substantivet (path-cmdletarna ) 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, Join eller andra sökvägsmanipulatörer.

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

  • Split-Path är utformad 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 about_Providers.