Split-Path

Modul:

Microsoft.PowerShell.Management Module

Vrátí zadanou část cesty.

Syntax

ParentSet (Výchozí)

Split-Path
    [-Path] <String[]>
    [-Parent]
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

LeafSet

Split-Path
    [-Path] <String[]>
    -Leaf
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

LeafBaseSet

Split-Path
    [-Path] <String[]>
    -LeafBase
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

ExtensionSet

Split-Path
    [-Path] <String[]>
    -Extension
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

QualifierSet

Split-Path
    [-Path] <String[]>
    -Qualifier
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

NoQualifierSet

Split-Path
    [-Path] <String[]>
    -NoQualifier
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

IsAbsoluteSet

Split-Path
    [-Path] <String[]>
    -IsAbsolute
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

LiteralPathSet

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 cesta rozdělení. Protože je tato cesta rozdělena na poslední položku, známou také jako list, příkaz zobrazí pouze názvy souborů.

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

Stejně jako všechny Split-Path příkazy vrací i 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. Protože neobsahuje žádné parametry pro určení rozdělení, použije se výchozí umístění rozdělení, Split-Path které je Nadřazené.

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 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:\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 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

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

ExtensionSet

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

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

IsAbsoluteSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

LeafSet

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

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

LeafBaseSet

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

-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, PO

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é:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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.logvrátí C:\Test\Logs. Parametr Parent je výchozím parametrem rozděleného umístění.

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

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

LeafBaseSet

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

ExtensionSet

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

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

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. U zprostředkovatelů fileSystem nebo registru 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é:	True
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

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é, rozšíření, listové, ListBase 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-Path je navržená tak, aby fungovala s daty vystavenými libovolným poskytovatelem. Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište Get-PSProvider. Pro více informací viz about_Providers.

Související odkazy

• Convert-Path
• Join-Path
• Resolve-Path
• Test-Path