Split-Path

Vrátí zadanou část cesty.

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

Rutina Split-Path vrátí jenom zadanou část cesty, například nadřazenou složku, podsložku nebo název souboru. Může také získat položky, na které odkazuje rozdělená cesta, a zjistit, jestli je cesta relativní nebo absolutní.

Pomocí této rutiny můžete získat nebo odeslat jenom vybranou část cesty.

Příklady

Příklad 1: Získání kvalifikátoru cesty

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

HKCU:

Tento příkaz vrátí pouze kvalifikátor cesty. Kvalifikátorem je jednotka.

Příklad 2: Zobrazení názvů souborů

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

Pass1.log
Pass2.log
...

Tento příkaz zobrazí soubory, na které odkazuje rozdělená cesta. Vzhledem k tomu, že tato cesta je rozdělená na poslední položku, označovanou také jako list, příkaz zobrazí jenom názvy souborů.

Parametr Resolve říká Split-Path zobrazení položek, na které odkazuje rozdělená cesta místo zobrazení rozdělené cesty.

Stejně jako všechny Split-Path příkazy vrátí tento příkaz řetězce. Nevrací objekty FileInfo , které představují soubory.

Příklad 3: Získání nadřazeného kontejneru

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

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

Tento příkaz vrátí pouze nadřazené kontejnery cesty. Vzhledem k tomu, že neobsahuje žádné parametry k určení rozdělení, Split-Path použije výchozí umístění rozdělení, které je nadřazené.

Příklad 4: Určuje, jestli je cesta absolutní.

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

False

Tento příkaz určuje, jestli je cesta relativní nebo absolutní. V tomto případě, protože cesta je relativní k aktuální složce, která je reprezentována tečkou (.), vrátí $False.

Příklad 5: Změna umístění na zadanou cestu

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

Tento příkaz změní umístění do složky, která obsahuje profil PowerShellu.

Příkaz v závorkách slouží Split-Path k vrácení pouze nadřazené cesty uložené v předdefinované $Profile proměnné. Nadřazený parametr je výchozí parametr rozdělení umístění. Proto ho můžete vynechat z příkazu. Závorky nasměrují PowerShell k prvnímu spuštění příkazu. To je užitečný způsob, jak přejít do složky s dlouhým názvem cesty.

Příklad 6: Rozdělení cesty pomocí kanálu

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

C:\Documents and Settings\User01\My Documents

Tento příkaz používá operátor kanálu (|) k odeslání cesty do Split-Path. Cesta je uzavřena do uvozovek, aby značila, že se jedná o jeden token.

Parametry

-Credential

Poznámka

Tento parametr nepodporuje žádné poskytovatele nainstalované v PowerShellu. Pokud chcete zosobnit jiného uživatele nebo zvýšit úroveň svých přihlašovacích údajů při spuštění této rutiny, použijte Invoke-Command.

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

-Extension

Označuje, že tato rutina vrací pouze rozšíření listu. Například v cestě C:\Test\Logs\Pass1.logvrátí pouze .log.

Tento parametr byl zaveden v PowerShellu 6.0.

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

-IsAbsolute

Označuje, že tato rutina vrátí $True , pokud je cesta absolutní a $False pokud je relativní. Absolutní cesta má délku větší než nula a nepoužívá tečku (.) k označení aktuální cesty.

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

-Leaf

Označuje, že tato rutina vrací pouze poslední položku nebo kontejner v cestě. Například v cestě C:\Test\Logs\Pass1.logvrátí pouze Pass1.log.

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

-LeafBase

Označuje, že tato rutina vrací pouze základní název listu. Například v cestě C:\Test\Logs\Pass1.logvrátí pouze Pass1.

Tento parametr byl zaveden v PowerShellu 6.0.

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

-LiteralPath

Určuje cesty, které se mají rozdělit. Na rozdíl od cesty se hodnota LiteralPath používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, že nemají interpretovat žádné znaky jako řídicí sekvence.

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

-NoQualifier

Označuje, že tato rutina vrátí cestu bez kvalifikátoru. Pro poskytovatele systému souborů nebo registru je kvalifikátor jednotkou cesty poskytovatele, například C: nebo HKCU:. Například v cestě C:\Test\Logs\Pass1.logvrátí pouze \Test\Logs\Pass1.log.

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

-Parent

Označuje, že tato rutina vrací pouze nadřazené kontejnery položky nebo kontejneru určeného cestou. Například v cestě C:\Test\Logs\Pass1.logvrátí C:\Test\Logs. Nadřazený parametr je výchozí parametr rozdělení umístění.

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

-Path

Určuje cesty, které se mají rozdělit. Jsou povoleny zástupné znaky. Pokud cesta obsahuje mezery, uzavřete ji do uvozovek. Cestu k této rutině můžete také převést.

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

-Qualifier

Označuje, že tato rutina vrátí pouze kvalifikátor zadané cesty. Pro poskytovatele systému souborů nebo registru je kvalifikátor jednotkou cesty poskytovatele, například C: nebo HKCU:.

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

-Resolve

Označuje, že tato rutina zobrazuje položky, na které odkazuje výsledná rozdělená cesta místo zobrazení prvků cesty.

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

Vstupy

String

Řetězec, který obsahuje cestu k této rutině, můžete převést.

Výstupy

System.String, System.Boolean

Split-Path vrátí textové řetězce. Když zadáte parametr Resolve , Split-Path vrátí řetězec, který popisuje umístění položek; nevrací objekty, které představují položky, jako je FileInfo nebo RegistryKey objekt.

Když zadáte parametr IsAbsolute , Split-Path vrátí logickou hodnotu.

Poznámky

  • Parametry rozděleného umístění (kvalifikátor, parent, extension, list, ListBase a NoQualifier) jsou exkluzivní. V každém příkazu můžete použít jenom jeden.

  • Rutiny obsahující jmenné jméno cesty (rutiny cesty ) pracují s názvy cest a vrací názvy ve stručné podobě, které můžou interpretovat všichni poskytovatelé PowerShellu. Jsou navržené pro použití v programech a skriptech, kde chcete zobrazit celý název cesty nebo jeho část v určitém formátu. Použijte je tak, jak byste použili Dirname, Normpath, Realpath, Join nebo jiné manipulátory cest.

  • Rutiny Path můžete použít společně s několika poskytovateli. Patří mezi ně zprostředkovatele FileSystem, Registry a Certificate.

  • Split-Path je navržen tak, aby fungoval s daty vystavenými libovolným poskytovatelem. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PSProvider. Další informace najdete v tématu about_Providers.