Split-Path

Modul:

Microsoft.PowerShell.Management Module

Az elérési út megadott részét adja vissza.

Syntax

ParentSet (Alapértelmezett)

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

A felosztott elérési út parancsmag csak az elérési út megadott részét adja vissza, például a szülőmappát, az almappát vagy a fájlnevet. A felosztási útvonal által hivatkozott elemeket is lekérheti, és megállapíthatja, hogy az elérési út relatív vagy abszolút-e.

Ezzel a parancsmaggal az elérési útnak csak egy kijelölt részét szerezheti be vagy küldheti el.

Példák

1. példa: Útvonal jellemzőjének lekérése

PS C:\> Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:

Ez a parancs csak az elérési út minősítőjét adja vissza. A minősítő a hajtóerő.

2. példa: Fájlnevek megjelenítése

PS C:\> Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve
Pass1.log
Pass2.log
...

Ez a parancs megjeleníti azokat a fájlokat, amelyekre a felosztási útvonal hivatkozik. Mivel ez az elérési út az utolsó elemre( más néven levélre) van felosztva, a parancs csak a fájlneveket jeleníti meg.

A Feloldás paraméter azt jelzi felosztási útvonal, hogy a felosztott elérési út helyett azokat az elemeket jelenítse meg, amelyekre az osztott elérési út hivatkozik.

Mint minden osztott elérési út parancs, ez a parancs sztringeket ad vissza. Nem ad vissza FileInfo objektumokat, amelyek a fájlokat képviselik.

3. példa: A szülőtároló lekérése

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

Ez a parancs csak az elérési út szülőtárolóit adja vissza. Mivel nem tartalmaz paramétereket a felosztás megadásához, felosztási útvonal az alapértelmezett felosztási helyet használja, amely a szülő.

4. példa: Meghatározza, hogy egy elérési út abszolút-e

PS C:\> Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute
False

Ez a parancs határozza meg, hogy az elérési út relatív vagy abszolút-e. Ebben az esetben, mivel az elérési út az aktuális mappához képest van, amelyet pont (.) jelöl, $False ad vissza.

5. példa: Hely módosítása megadott elérési útra

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

Ez a parancs a PowerShell-profilt tartalmazó mappára módosítja a helyet.

A zárójelben lévő parancs felosztott elérési út használatával csak a beépített $Profile változóban tárolt elérési út szülőét adja vissza. A Szülő paraméter az alapértelmezett felosztási hely paraméter. Ezért kihagyhatja a parancsból. A zárójelek a PowerShellt a parancs első futtatására irányítják. Ez egy hasznos mód annak, hogy belépjen egy olyan mappába, amelynek hosszú az elérési útja.

6. példa: Útvonal felosztása a folyamat használatával

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

Ez a parancs egy folyamatoperátort (|) használ az elérési út felosztási útvonal. Az elérési út idézőjelek közé van zárva, hogy azt jelezze, hogy egyetlen jogkivonatról van szó.

Paraméterek

-Credential

Megjegyzés:

Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják. Ha egy másik felhasználó szerepében szeretne fellépni, vagy emelni szeretné hitelesítő adatait a parancsmag futtatásakor, használja a Invoke-Command.

Paramétertulajdonságok

Típus:	PSCredential
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-IsAbsolute

Azt jelzi, hogy ez a parancsmag $True ad vissza, ha az elérési út abszolút, és $False, ha relatív. Az abszolút elérési út hossza nullánál nagyobb, és nem használ pont (.) értéket az aktuális elérési út jelzésére.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

IsAbsoluteSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Leaf

Azt jelzi, hogy ez a parancsmag csak az elérési út utolsó elemét vagy tárolóit adja vissza. A C:\Test\Logs\Pass1.logelérési úton például csak Pass1.log ad vissza.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

LeafSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-LiteralPath

Megadja a felosztandó útvonalakat. A Path-tal ellentétben a LiteralPath értéke pontosan a beíráskor lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	PSPath

Paraméterkészletek

LiteralPathSet

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-NoQualifier

Azt jelzi, hogy ez a parancsmag a minősítő nélkül adja vissza az elérési utat. A Fájlrendszer- vagy beállításjegyzék-szolgáltatók esetében a minősítő a szolgáltató elérési útjának meghajtója, például C: vagy HKCU:. A C:\Test\Logs\Pass1.logelérési úton például csak a \Test\Logs\Pass1.log értéket adja vissza.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

NoQualifierSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Parent

Azt jelzi, hogy ez a parancsmag csak az elem vagy az elérési út által megadott tároló szülőtárolóit adja vissza. A C:\Test\Logs\Pass1.logelérési úton például a C:\Test\Logs értéket adja vissza. A Szülő paraméter az alapértelmezett felosztási hely paraméter.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ParentSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Path

Megadja a felosztandó útvonalakat. A helyettesítő karakterek használata engedélyezett. Ha az elérési út szóközöket tartalmaz, tegye idézőjelek közé. A parancsmagnek elérési utat is csatolhat.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

ParentSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

NoQualifierSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

LeafSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

QualifierSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

IsAbsoluteSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Qualifier

Az jelzi, hogy ez a parancsmag csak a megadott elérési út minősítőjét adja vissza. A Fájlrendszer- vagy beállításjegyzék-szolgáltatók esetében a minősítő a szolgáltató elérési útjának meghajtója, például C: vagy HKCU:.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

QualifierSet

Position:	1
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Resolve

Azt jelzi, hogy ez a parancsmag az eredményként kapott felosztási útvonal által hivatkozott elemeket jeleníti meg az elérésiút-elemek megjelenítése helyett.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-UseTransaction

Tartalmazza a parancsot az aktív tranzakcióban. Ez a paraméter csak akkor érvényes, ha egy tranzakció folyamatban van. További információ: about_Transactions.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	usetx

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

Egy elérési utat tartalmazó karakterláncot küldhet tovább ehhez a cmdlethez.

Kimenetek

System.String, System.Boolean

felosztott elérési út szöveges sztringeket ad vissza. A Feloldás paraméter megadásakor felosztott elérési út az elemek helyét leíró sztringet ad vissza; nem ad vissza olyan objektumokat, amelyek az elemeket jelölik, például egy FileInfo vagy RegistryKey objektumot.

Az IsAbsolute paraméter megadásakor felosztott elérési út egy logikai értéket ad vissza.

Jegyzetek

• A felosztott hely paraméterei (Minősítő, Szülő, Levélés NoQualifier) kizárólagosak. Minden parancsban csak egyet használhat.

  A Elérési út főnevét (az Elérési út parancsmagokat) tartalmazó parancsmagok az elérési utak neveivel dolgoznak, és a neveket tömör formátumban adja vissza, amelyet az összes PowerShell-szolgáltató értelmezni tud. Olyan programokban és szkriptekben való használatra készültek, amelyekben az elérési út nevének egy részét vagy egészét egy adott formátumban szeretné megjeleníteni. Használja őket úgy, ahogyan Dirname, Normpath, Realpath, Joinvagy más elérésiút-manipulátorokat használna.

  A Path parancsmagokat több szolgáltatóval együtt használhatja. Ezek közé tartoznak a fájlrendszer, a beállításjegyzék és a tanúsítványszolgáltatók.

  osztott útvonalú úgy tervezték, hogy bármely szolgáltató által közzétett adatokkal működjön együtt. A munkamenetben elérhető szolgáltatók listájához írja be a Get-PSProvider. További információ: about_Providers.

Kapcsolódó hivatkozások

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