Split-Path
Vrátí zadanou část cesty.
Syntaxe
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
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 cesta rozdělení. Vzhledem k tomu, že tato cesta je rozdělená na poslední položku, označovanou také jako list, zobrazí příkaz pouze názvy souborů.
Parametr Resolve říká Split-Path
, aby zobrazoval položky, 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 -Parent "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í, což je Parent.
Příklad 4: Určuje, zda 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í vzhledem 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 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:\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ř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 |
-IsAbsolute
Označuje, že tato rutina vrátí $True
, pokud je cesta absolutní a $False
jestli je relativní. Absolutní cesta má délku větší než nula a k označení aktuální cesty nepoužívá tečku (.
).
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Leaf
Označuje, že tato rutina vrací pouze poslední položku nebo kontejner v cestě. Například v cestě C:\Test\Logs\Pass1.log
vrátí pouze Pass1.log
.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
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 |
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.log
vrátí pouze \Test\Logs\Pass1.log
.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-Parent
Označuje, že tato rutina vrací pouze nadřazené kontejnery položky nebo kontejneru určené cestou. Například v cestě C:\Test\Logs\Pass1.log
vrátí C:\Test\Logs
.
Nadřazený parametr je výchozí parametr rozdělení umístění.
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: | False |
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 |
-UseTransaction
Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace najdete v tématu about_Transactions.
Typ: | SwitchParameter |
Aliasy: | usetx |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
Řetězec, který obsahuje cestu k této rutině, můžete převést.
Výstupy
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.
Když zadáte parametr IsAbsolute, vrátí tato rutina logickou hodnotu.
Poznámky
Parametry rozděleného umístění (kvalifikátor, parent, list 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, zadejteGet-PSProvider
. Další informace najdete v tématu about_Providers.