Sdílet prostřednictvím

Split-Path

  • Reference
Modul:
Microsoft.PowerShell.Management

Vrátí zadanou část cesty.

Syntaxe

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í. Pokud cestu rozdělíte bez zadání dalších parametrů, Split-Path vrátí nadřazenou část zadané cesty.

Příkaz Split-Path vrátí řetězce. Nevrací FileInfo ani jiné objekty položek, jako jsou příkazy *-Item .

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í části názvu souboru cesty

Při použití parametru Split-Path Leaf vrátí pouze poslední položku v zadaném řetězci cesty bez ohledu na to, zda je tato položka souborem nebo adresářem.

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

*.txt

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

file1.txt
file2.txt

Když použijete parametr Resolve , Split-Path přeloží zadaný řetězec cesty a vrátí položky odkazované cestou.

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

Při použití parametru Split-Path Parent vrátí pouze část nadřazeného kontejneru zadaného řetězce cesty. Pokud řetězec cesty neobsahuje nadřazený kontejner, Split-Path vrátí prázdný řetězec.

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

.\folder1

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

D:\temp\test\folder1

Při použití parametru Split-Path Resolve přeloží zadaný řetězec cesty a vrátí úplnou cestu nadřazeného kontejneru.

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

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

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

False

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

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

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

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 z příkazu vynechat. 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, která má dlouhý název cesty.

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

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

C:\Users\User01\My Documents

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

Parametry

-Credential

Poznámka:

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

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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 představen v PowerShellu 6.0.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-IsAbsolute

Označuje, že tato rutina vrátí $True , pokud je cesta absolutní a $False jestli je relativní. Ve Windows musí absolutní řetězec cesty začínat specifikátorem jednotky poskytovatele, například C: nebo HKCU:. Relativní cesta začíná tečkou (.) nebo tečkou (..).

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Leaf

Při použití parametru Split-Path Leaf vrátí pouze poslední položku v zadaném řetězci cesty bez ohledu na to, zda je tato položka souborem nebo adresářem.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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 představen v PowerShellu 6.0.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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, aby nepřekládaly žádné znaky jako řídicí sekvence.

Typ:String[]
Aliasy:PSPath, LP
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NoQualifier

Označuje, že tato rutina vrátí cestu bez kvalifikátoru. U zprostředkovatelů 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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Parent

Split-Path vrátí pouze nadřazenou část kontejneru zadaného řetězce cesty. Pokud řetězec cesty neobsahuje nadřazený kontejner, Split-Path vrátí prázdný řetězec.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-Qualifier

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

Typ:SwitchParameter
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Resolve

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

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

Výstupy

String

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

Boolean

Když zadáte parametr IsAbsolute, vrátí tato rutina logickou hodnotu.

Poznámky

  • Parametry rozděleného umístění (Kvalifikátor, Parent, Extension, LeafBase a NoQualifier) jsou exkluzivní. V každém příkazu můžete použít jenom jeden.

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

  • Rutiny Path můžete použít společně s několika poskytovateli. Patří sem zprostředkovatelé systému souborů, registru a certifikátů.

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