Split-Path
Az elérési út megadott részét adja vissza.
Syntax
ParentSet (Alapértelmezett)
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
A Split-Path parancsmag csak az elérési út megadott részét adja vissza, például a szülőmappát, egy almappát vagy egy 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
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: Megjelenített fájlnevek
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 Resolve paraméter azt mondja Split-Path , hogy a felosztott elérési út helyett azokat az elemeket jelenítse meg, amelyekre az osztott elérési út hivatkozik.
Mint minden Split-Path parancs, ez a parancs is sztringeket ad vissza. Nem adja vissza a fájlokat képviselő FileInfo objektumokat.
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 a felosztási hely alapértelmezett értékét használja, 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 képest van, amelyet pont (.) jelöl, $Falsead 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 a Split-Path-t használja arra, hogy csak a beépített $Profile változóban tárolt elérési út szülő mappájá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 pipeline 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 folyamatkezelőt (|) használ a Split-Pathelérési út küldéséhez. Az elérési út idézőjelek közé van zárva, jelezve, hogy egyetlen jelrő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 |
-Extension
Azt jelzi, hogy ez a parancsmag csak a levél kiterjesztését adja vissza. Például a C:\Test\Logs\Pass1.logelérési úton csak .log-et ad vissza.
Ezt a paramétert a PowerShell 6.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
ExtensionSet
| 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 |
-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 pontot (.) 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ő: | True |
| 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. Például a C:\Test\Logs\Pass1.logelérési úton csak Pass1.log-et 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ő: | 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 |
-LeafBase
Azt jelzi, hogy ez a parancsmag csak a levél alapnevét adja vissza. Például a C:\Test\Logs\Pass1.logelérési úton csak Pass1-et ad vissza.
Ezt a paramétert a PowerShell 6.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
LeafBaseSet
| 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 |
-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, LP |
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ói útvonal meghajtója, például C: vagy HKCU:. Például a C:\Test\Logs\Pass1.logelérési úton csak \Test\Logs\Pass1.log-et 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
NoQualifierSet
| 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 |
-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. Például az elérési úton C:\Test\Logs\Pass1.loga .C:\Test\Logs
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 |
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 |
LeafBaseSet
| 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 |
ExtensionSet
| 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 |
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 |
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ói útvonal 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ő: | 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 |
-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 |
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
String
Ez a parancsmag szöveges sztringeket ad vissza. Amikor megadja a Resolve paramétert, az egy sztringet ad vissza, amely leírja az elemek helyét. Nem ad vissza olyan objektumokat, amelyek az elemeket jelölik, például egy FileInfo vagy RegistryKey objektumot.
Boolean
Az IsAbsolute paraméter megadásakor ez a parancsmag egy logikai értéket ad vissza.
Jegyzetek
A felosztott hely paraméterei (Minősítő, Szülő, Bővítmény, Leaf, LeafBaseé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 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 ú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.
Split-Pathú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 aGet-PSProvider. További információért lásd a about_Providerscímű részt.