Split-Path

Egy 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 felosztott ú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 lekérheti vagy elküldheti az elérési útnak csak egy kijelölt részét.

Példák

1. példa: Elérési út 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őit adja vissza. 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 osztva, a parancs csak a fájlneveket jeleníti meg.

A Feloldás paraméter arra utasítja Split-Path , hogy a felosztott elérési út hivatkozását tartalmazó elemeket jelenítse meg a felosztási útvonal megjelenítése helyett.

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

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

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

4. példa: Meghatározza, hogy az 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 van viszonyítva, amelyet egy pont (.) jelöl, a visszaadott $Falseérték.

5. példa: Hely módosítása egy 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 Helyet a PowerShell-profilt tartalmazó mappára módosítja.

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 Parancs futtatására utasítják a PowerShellt. Ez hasznos módja annak, hogy egy hosszú elérési úttal rendelkező mappába lépjen.

6. példa: Elérési út felosztása a folyamat használatával

'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 elküldéséhez Split-Path. Az elérési út idézőjelek közé van zárva, ami azt jelzi, 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ót szeretne megszemélyesíteni, vagy a parancsmag futtatásakor megemeli a hitelesítő adatait, használja az Invoke-Command parancsot.

Type:PSCredential
Position:Named
Default value:None
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 C:\Test\Logs\Pass1.logpéldául csak .loga visszaadott értéket adja vissza.

Ez a paraméter a PowerShell 6.0-ban lett bevezetve.

Type:SwitchParameter
Position:Named
Default value:None
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
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 C:\Test\Logs\Pass1.logpéldául csak a Pass1.log értéket adja vissza.

Type:SwitchParameter
Position:Named
Default value:None
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 C:\Test\Logs\Pass1.logpéldául csak Pass1a visszaadott értéket adja vissza.

Ez a paraméter a PowerShell 6.0-ban lett bevezetve.

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

-LiteralPath

Megadja a felosztandó elérési utakat. Az Elérési úttól eltérően a LiterálPath értéke pontosan a begépelt módon van használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési út tartalmaz feloldókaraktereket, tegye idézőjelek közé. Az egyszeres idézőjelek arra utasítják a PowerShellt, hogy ne értelmezze feloldókarakterekként a karaktereket.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
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 C:\Test\Logs\Pass1.logpéldául csak \Test\Logs\Pass1.loga visszaadott értéket adja vissza.

Type:SwitchParameter
Position:Named
Default value:None
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 a visszaadott C:\Test\Logsérték C:\Test\Logs\Pass1.log. A szülőparaméter az alapértelmezett felosztási hely paraméter.

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

-Path

Megadja a felosztandó elérési utakat. 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 átirányíthatja.

Type:String[]
Position:0
Default value:None
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őit 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:.

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

Bevitelek

String

Átadhatja a parancsmag elérési útját tartalmazó sztringet.

Kimenetek

System.String, System.Boolean

Split-Path szöveges sztringeket ad vissza. A Feloldás paraméter Split-Path megadásakor az elemek helyét leíró sztringet ad vissza; nem ad vissza az elemeket képviselő objektumokat, például FileInfo vagy RegistryKey objektumot.

Az IsAbsolute paraméter Split-Path megadásakor logikai értéket ad vissza.

Jegyzetek

  • A felosztási hely paraméterei (Qualifier, Parent, Extension, Leaf, 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 működnek, és a neveket tömör formátumban adják vissza, amelyet az összes PowerShell-szolgáltató értelmezni tud. Olyan programokban és parancsfájlokban használhatók, ahol 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, Normpath, Realpath, Join vagy más elérésiút-manipulátorok használatával.

  • A Path parancsmagokat több szolgáltatóval együtt használhatja. Ezek közé tartozik a Fájlrendszer, a Beállításjegyzék és a Tanúsítványszolgáltatók.

  • Split-Path A úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön. A munkamenetben elérhető szolgáltatók listázásához írja be a következőt Get-PSProvider: . További információ: about_Providers.