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 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
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
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 ad vissza FileInfo objektumokat, amelyek a fájlokat képviselik.
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 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 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 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, 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 |
-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 akkor ad vissza $True , 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. 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ő: | 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
System.String, System.Boolean
Split-Path Szöveges karakterláncokat ad vissza. A Resolve paraméter megadásakor az elemek helyét leíró karakterláncot ad vissza, Split-Path de nem ad vissza az elemeket képviselő objektumokat, például a FileInfo vagy a RegistryKey objektumot.
Az IsAbsolute paraméter Split-Path megadásakor 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 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.
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.