Split-Path
Vrátí zadanou část cesty.
Syntax
ParentSet (Výchozí)
Split-Path
[-Path] <String[]>
[-Parent]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
NoQualifierSet
Split-Path
[-Path] <String[]>
[-NoQualifier]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LeafSet
Split-Path
[-Path] <String[]>
[-Leaf]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
QualifierSet
Split-Path
[-Path] <String[]>
[-Qualifier]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
IsAbsoluteSet
Split-Path
[-Path] <String[]>
[-Resolve]
[-IsAbsolute]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LiteralPathSet
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í části názvu souboru cesty
Při použití parametru Leaf vrátí Split-Path 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
Pokud 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 Parent vrátí Split-Path pouze část nadřazeného kontejneru zadaného řetězce cesty. Pokud řetězec Cesta 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
Pokud použijete parametr Resolve, Split-Path 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 používá Split-Path k vrácení pouze nadřazené cesty uložené v předdefinované $PROFILE proměnné. Parametr Parent je výchozím parametrem rozděleného 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 k 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 oprávnění při spuštění této rutiny, použijte Invoke-Command.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-IsAbsolute
Označuje, že tato rutina vrátí $true, pokud je cesta absolutní a $false, pokud je relativní. Ve Windows musí řetězec absolutní cesty začínat specifikátorem jednotky zprostředkovatele, například C: nebo HKCU:. Relativní cesta začíná tečkou (.) nebo tečkou (..).
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
IsAbsoluteSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Leaf
Při použití parametru Leaf vrátí Split-Path pouze poslední položku v zadaném řetězci cesty bez ohledu na to, zda je tato položka souborem nebo adresářem.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
LeafSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-LiteralPath
Určuje cesty, které se mají rozdělit. Na rozdíl od cestyse hodnota LiteralPath používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje únikové znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby žádné znaky neinterpretoval jako únikové sekvence.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Sady parametrů
LiteralPathSet
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-NoQualifier
Označuje, že tato rutina vrátí cestu bez kvalifikátoru. U zprostředkovatelů fileSystem nebo registru je kvalifikátor jednotkou cesty zprostředkovatele, například C: nebo HKCU:. Například v cestě C:\Test\Logs\Pass1.logvrátí pouze \Test\Logs\Pass1.log.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NoQualifierSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Parent
Split-Path vrátí pouze nadřazenou část kontejneru zadaného řetězce cesty. Pokud řetězec Cesta neobsahuje nadřazený kontejner, Split-Path vrátí prázdný řetězec.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ParentSet
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
ParentSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
NoQualifierSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
LeafSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
QualifierSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
IsAbsoluteSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Qualifier
Označuje, že tato rutina vrátí pouze kvalifikátor zadané cesty. Pro zprostředkovatele FileSystem nebo Registry je kvalifikátor jednotkou cesty zprostředkovatele, například C: nebo HKCU:.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
QualifierSet
| Position: | 1 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Resolve
Označuje, že tato rutina zobrazuje položky, na které odkazuje výsledná rozdělená cesta místo zobrazení prvků cesty.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | usetx |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
Řetězec, který obsahuje cestu, můžete předat tomuto cmdletu.
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, například FileInfo nebo RegistryKey objektu.
Boolean
Když zadáte parametr IsAbsolute, vrátí tato rutina logickou hodnotu.
Poznámky
Parametry rozděleného umístění (kvalifikátor, nadřazené, list a NoQualifier) jsou exkluzivní. V každém příkazu můžete použít jenom jeden.
Rutiny, které obsahují Cestu podstatné jméno (rutiny Cesta), pracují s názvy cest a vracejí názvy ve stručné podobě, které můžou 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žívejte je způsobem, jakým byste použili Dirname, normpath, realpath, Joinnebo 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-Pathje navržená tak, aby fungovala s daty vystavenými libovolným poskytovatelem. Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napišteGet-PSProvider. Pro více informací viz about_Providers.
