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>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-NoQualifier]
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-Leaf]
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-Qualifier]
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-Resolve]
     [-IsAbsolute]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     -LiteralPath <String[]>
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<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.

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

PS C:\> Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:

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

Exempel 2: Visa filnamn

PS C:\> Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve
Pass1.log
Pass2.log
...

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

Parametern Resolve instruerar 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 kommandon för delad sökväg returnerar det här kommandot strängar. Den returnerar inte FileInfo objekt som representerar filerna.

Exempel 3: Hämta den överordnade containern

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

Det här kommandot returnerar endast de överordnade containrarna i sökvägen. Eftersom den inte innehåller några parametrar för att ange delningen använder Delad sökväg standardinställningen delad plats, som är Överordnad.

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

PS C:\> 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 den $False.

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 parenteser använder för att returnera endast 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.

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

PS C:\> '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 . Sökvägen omges av citattecken för att indikera att det är en enda token.

Parametrar

-Credential

Not

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

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

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

-LiteralPath

Anger sökvägarna som ska delas. Till skillnad från Pathanvänds värdet för LiteralPath precis 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
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 kvalificeringen enheten för providersökvägen, till exempel C: eller HKCU:. I sökvägen C:\Test\Logs\Pass1.logreturnerar den till exempel endast \Test\Logs\Pass1.log.

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

-Parent

Anger att den här cmdleten endast returnerar de överordnade containrarna för objektet eller containern som anges av sökvägen. I sökvägen C:\Test\Logs\Pass1.logreturnerar den till exempel C:\Test\Logs. Parametern Parent är standardparametern för delad plats.

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 kvalificeringen enheten för providersökvägen, till exempel C: eller HKCU:.

Typ:SwitchParameter
Position:1
Standardvärde:None
Obligatorisk:False
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

-UseTransaction

Innehåller kommandot i den aktiva transaktionen. Den här parametern är endast giltig när en transaktion pågår. Mer information finns i about_Transactions.

Typ:SwitchParameter
Alias:usetx
Position:Named
Standardvärde:False
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

System.String, System.Boolean

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

När du anger parametern IsAbsolute returnerar booleskt värde.

Kommentarer

  • Parametrarna för delad plats (Qualifier, Parent, Leafoch 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.

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