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>]
[-UseTransaction]
[<CommonParameters>]
NoQualifierSet
Split-Path
[-Path] <String[]>
[-NoQualifier]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LeafSet
Split-Path
[-Path] <String[]>
[-Leaf]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
QualifierSet
Split-Path
[-Path] <String[]>
[-Qualifier]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
IsAbsoluteSet
Split-Path
[-Path] <String[]>
[-Resolve]
[-IsAbsolute]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LiteralPathSet
Split-Path
-LiteralPath <String[]>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<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: Az elérési út fájlnév részének megjelenítése
A Leaf paraméter használatakor Split-Path csak a megadott elérésiút-sztring utolsó elemét adja vissza, függetlenül attól, hogy az elem fájl vagy könyvtár.
Split-Path -Path .\folder1\*.txt -Leaf
*.txt
Split-Path -Path .\folder1\*.txt -Leaf -Resolve
file1.txt
file2.txt
A Resolve paraméter használatakor Split-Path feloldja a megadott elérési út sztringet, és visszaadja az elérési út által hivatkozott elemeket.
3. példa: A szülőtároló lekérése
A Szülő paraméter használatakor Split-Path csak a megadott elérési út szülőtároló részét adja vissza. Ha a elérési út karakterlánc nem tartalmaz szülőtárolót, Split-Path üres karakterláncot ad eredményül.
Split-Path -Path .\folder1\file1.txt -Parent
.\folder1
Split-Path -Path .\folder1\file1.txt -Parent -Resolve
D:\temp\test\folder1
A Resolve paraméter használatakor Split-Path feloldja a megadott elérési utat, és visszaadja a szülőtároló teljes elérési útját.
4. példa: Meghatározza, hogy egy elérési út abszolút-e
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.
Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute
False
5. példa: Hely módosítása megadott elérési útra
Ez a parancs a PowerShell-profilt tartalmazó mappára módosítja a helyet.
PS C:\> Set-Location (Split-Path -Path $PROFILE)
PS C:\Users\User01\Documents\PowerShell>
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:\Users\User01\My Documents\My Pictures' | Split-Path
C:\Users\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 |
-IsAbsolute
Azt jelzi, hogy ez a parancsmag $true ad vissza, ha az elérési út abszolút, és $false, ha relatív. Windows rendszeren az abszolút elérési út sztringének egy szolgáltatói meghajtó-megjelölővel kell kezdődnie, például C: vagy HKCU:. A relatív elérési út ponttal (.) vagy pont-ponttal (..) kezdődik.
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ő: | 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 |
-Leaf
A Leaf paraméter használatakor Split-Path csak a megadott elérésiút-sztring utolsó elemét adja vissza, függetlenül attól, hogy az elem fájl vagy könyvtár.
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ő: | 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 |
-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 |
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ő: | 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 |
-Parent
Split-Path csak a megadott elérésiút-sztring szülőtároló-részét visszaadja. Ha a elérési út karakterlánc nem tartalmaz szülőtárolót, Split-Path üres karakterláncot ad eredményül.
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 |
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 |
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 |
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 |
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ő: | 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 |
-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 |
-UseTransaction
Tartalmazza a parancsot az aktív tranzakcióban. Ez a paraméter csak akkor érvényes, ha egy tranzakció folyamatban van. További információ: about_Transactions.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | usetx |
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ő, Levélé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.
