Split-Path
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.
Típus: | PSCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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 .log
a visszaadott értéket C:\Test\Logs\Pass1.log
adja vissza.
Ezt a paramétert a PowerShell 6.0-ban vezettük be.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.log
a visszaadott értéket C:\Test\Logs\Pass1.log
adja vissza.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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 Pass1
a visszaadott értéket C:\Test\Logs\Pass1.log
adja vissza.
Ezt a paramétert a PowerShell 6.0-ban vezettük be.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String[] |
Aliasok: | PSPath, LP |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.log
a visszaadott értéket C:\Test\Logs\Pass1.log
adja vissza.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.log
C:\Test\Logs
.
A Szülő paraméter az alapértelmezett felosztási hely paraméter.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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:
.
Típus: | SwitchParameter |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
A parancsmag elérési útját tartalmazó sztringet csövezheti.
Kimenetek
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.
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őtGet-PSProvider
: További információ: about_Providers.