Split-Path

  • Referencia
Modul:
Microsoft.PowerShell.Management

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

Syntax

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

A Split-Path 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 minősítőjének lekérése

Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier

HKCU:

Ez a parancs csak az elérési út minősítőjének felel meg. A minősítő a meghajtó.

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

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 Split-Path , hogy a felosztott elérési út által hivatkozott elemek jelenjenek meg a felosztási útvonal megjelenítése helyett.

Mint minden Split-Path parancs, ez a parancs sztringeket ad vissza. Nem a fájlokat képviselő FileInfo-objektumokat adja vissza.

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

Split-Path -Parent "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, Split-Path használja az alapértelmezett felosztási helyet, amely a szülő.

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

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 viszonyítva jelenik meg, amelyet pont (.) jelöl, visszaadja $False.

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 csak a beépített $Profile változóban tárolt elérési út szülőjének visszaadását használjaSplit-Path. 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ódja annak, hogy olyan mappába lépjen, amelynek hosszú elérési útja van.

6. példa: Útvonal felosztása a folyamattal

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

C:\Documents and Settings\User01\My Documents

Ez a parancs egy folyamatkezelőt (|) használ az elérési út elküldéséhez Split-Path. 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

Feljegyzés

Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják. Ha megszemélyesíteni szeretne egy másik felhasználót, vagy a parancsmag futtatásakor emeli a hitelesítő adatait, használja az Invoke-Command parancsot.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Extension

Azt jelzi, hogy ez a parancsmag csak a levél kiterjesztését adja vissza. Az elérési úton például csak .loga visszaadott értéket C:\Test\Logs\Pass1.logadja vissza.

Ezt a paramétert a PowerShell 6.0-ban vezettük be.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-IsAbsolute

Azt jelzi, hogy ez a parancsmag akkor ad vissza, $True ha az elérési út abszolút, és $False 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Leaf

Azt jelzi, hogy ez a parancsmag csak az elérési út utolsó elemét vagy tárolóit adja vissza. Az elérési úton például csak Pass1.loga visszaadott értéket C:\Test\Logs\Pass1.logadja vissza.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LeafBase

Azt jelzi, hogy ez a parancsmag csak a levél alapnevét adja vissza. Az elérési úton például csak Pass1a visszaadott értéket C:\Test\Logs\Pass1.logadja vissza.

Ezt a paramétert a PowerShell 6.0-ban vezettük be.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LiteralPath

Megadja a felosztandó útvonalakat. Az elérési úttal ellentétben a LiteralPath értéke pontosan a beírt módon lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz escape karaktereket, csatolja egy idézőjelek közé. Az idézőjelek azt mondják a PowerShellnek, hogy ne értelmezzen karaktereket feloldósorozatként.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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:. Az elérési úton például csak \Test\Logs\Pass1.loga visszaadott értéket C:\Test\Logs\Pass1.logadja vissza.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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. Az elérési úton például az eredményC:\Test\Logs\Pass1.logC:\Test\Logs. A Szülő paraméter az alapértelmezett felosztási hely paraméter.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 parancsmag elérési útját is becsúszthatja.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Qualifier

Azt jelzi, hogy ez a parancsmag csak a megadott elérési út minősítőjének felel meg. 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:.

Type:SwitchParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

String

A parancsmag elérési útját tartalmazó sztringet csövezheti.

Kimenetek

String

Ez a parancsmag szöveges sztringeket ad vissza. A Feloldás paraméter megadásakor egy sztringet ad vissza, amely leírja az elemek helyét. Nem ad vissza olyan objektumokat, amelyek az elemeket jelölik, például a FileInfo vagy a RegistryKey objektumot.

Boolean

Az IsAbsolute paraméter megadásakor ez a parancsmag logikai értéket ad vissza.

Jegyzetek

  • Az osztott hely paraméterei (Minősítő, Szülő, Bővítmény, Levél, LeafBase és NoQualifier) kizárólagosak. Minden parancsban csak egyet használhat.

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

  • Az Elérési út 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.

  • Split-Path úgy lett kialakítva, 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 következőt Get-PSProvider: További információ: about_Providers.