Join-Path
Egy elérési utat és egy gyermek elérési utat egyesít egyetlen elérési úton.
Syntax
Default (Alapértelmezett)
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Description
A Join-Path parancsmag egy mappát és egy alútvonalat egyesít egyetlen elérési útba.
A szolgáltató biztosítja az elérésiút-elválasztókat.
Példák
1. példa: Elérési út kombinálása gyermekútvonallal
PS C:\> Join-Path -Path "path" -ChildPath "childpath"
path\childpath
Ez a parancs a Join-Path-t használja egy elérési út és egy alútvonal kombinálására.
Mivel a parancsot a FileSystem szolgáltatótól hajtják végre, biztosítja a \ elválasztójelet az elérési utak összekapcsolásához.
2. példa: A címtárelválasztókat már tartalmazó elérési utak egyesítése
PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"
path\childpath
A meglévő címtárelválasztók \ és kezelve vannak, így csak egy elválasztó található Path és ChildPath
3. példa: Fájlok és mappák megjelenítése egy elérési út gyermekútvonallal való összekapcsolásával
Join-Path "C:\win*" "System*" -Resolve
Ez a parancs megjeleníti a C:\Win* elérési úthoz és a System* gyermekútvonalhoz való csatlakozással hivatkozott fájlokat és mappákat.
Ugyanazokat a fájlokat és mappákat jeleníti meg, mint Get-ChildItem, de megjeleníti az egyes elemek teljes elérési útját.
Ebben a parancsban a Path és ChildPath választható paraméternevek nem lesznek megadva.
4. példa: Join-Path használata a PowerShell beállításjegyzék-szolgáltatójával
PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve
HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet
Ez a parancs megjeleníti a beállításkulcsokat a HKLM\System beállításjegyzék alkulcsában, amely tartalmazza a ControlSet.
A Resolve paraméter megpróbálja feloldani az összekapcsolt elérési utat, beleértve az aktuális szolgáltatói útvonal helyettesítő karaktereit is HKLM:\
5. példa: Több elérési út gyökerének kombinálása gyermekútvonallal
Join-Path -Path C:, D:, E:, F: -ChildPath New
C:\New
D:\New
E:\New
F:\New
Ez a parancs a Join-Path-t használja több útvonalgyökér gyermekútvonallal való kombinálásához.
Megjegyzés:
A Path által megadott meghajtóknak létezniük kell, vagy a bejegyzés illesztése sikertelen lesz.
6. példa: Fájlrendszer-meghajtó gyökerének kombinálása gyermekútvonallal
Get-PSDrive -PSProvider filesystem | ForEach-Object {$_.root} | Join-Path -ChildPath "Subdir"
C:\Subdir
D:\Subdir
Ez a parancs egyesíti a konzol egyes PowerShell-fájlrendszer-meghajtóinak gyökerét a subdir gyermekútvonallal.
A parancs a Get-PSDrive parancsmaggal szerzi be a Fájlrendszer szolgáltató által támogatott PowerShell-meghajtókat.
A ForEach-Object utasítás csak a PSDriveInfo objektumok gyökértulajdonságát választja ki, és egyesíti azt a megadott gyermekútvonallal.
A kimenet azt mutatja, hogy a számítógépen lévő PowerShell-meghajtók tartalmazták a C:\Program Files könyvtárra leképezett meghajtót.
Paraméterek
-ChildPath
Megadja a Path paraméter értékéhez hozzáfűzendő elemeket.
Helyettesítő karakterek használata engedélyezett.
A ChildPath paraméter megadása kötelező, bár a paraméter neve ("ChildPath") nem kötelező.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| 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 |
-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 |
-Path
Megadja azokat a fő elérési utakat (vagy elérési utakat), amelyekhez a gyermekútvonal hozzá van fűzve. Helyettesítő karakterek használata engedélyezett.
A Path értéke határozza meg, hogy melyik szolgáltató csatlakozik az elérési utakhoz, és hozzáadja az elérési utak elválasztóit.
A Path paraméter megadása kötelező, bár a paraméter neve ("Elérési út") megadása nem kötelező.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
| Aliasok: | PSPath |
Paraméterkészletek
(All)
| 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 |
-Resolve
Azt jelzi, hogy ennek a parancsmagnak meg kell kísérelnie feloldani az aktuális szolgáltatóhoz csatlakoztatott elérési utat.
- Helyettesítő karakterek használata esetén a parancsmag az összekapcsolt elérési útnak megfelelő összes elérési utat adja vissza.
- Ha nem használ helyettesítő karaktereket, a parancsmag hibaüzenetet ad, ha az elérési út nem létezik.
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 egy sztringet ad vissza, amely az eredményül kapott elérési utat tartalmazza.
Jegyzetek
Az Elérési út főnevét (elérésiút-parancsmagokat) tartalmazó parancsmagok módosítják az elérési utak nevét, é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 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, mint a Dirname, a Normpath, a Realpath, a Join vagy más útvonal-manipulátorok.
Az elérésiút-parancsmagokat több szolgáltatóval is használhatja, beleértve a FileSystem, Registryés Certificate szolgáltatókat.
Ez a parancsmag ú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 Get-PSProvider.
További információért lásd a about_Providerscímű részt.