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>
[[-AdditionalChildPath] <String[]>]
[-Resolve]
[-Credential <PSCredential>]
[<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ókat \ kezeli a rendszer, í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 hivatkozott fájlokat és mappákat a C:\Win\* elérési úthoz és a System\* gyermekútvonalhoz való csatlakozással. 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 minden PowerShell-fájlrendszer-meghajtójának 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ér tulajdonságát választja ki, és egyesíti 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.
7. példa: Korlátlan számú elérési út egyesítése
Join-Path a b c d e f g
a\b\c\d\e\f\g
A AdditionalChildPath paraméter korlátlan számú elérési út összekapcsolását teszi lehetővé.
Ebben a példában nem használunk paraméterneveket, így az "a" a Path-hoz, a "b" a ChildPath-hez, a "c-g" pedig a AdditionalChildPath-höz kötődik.
Paraméterek
-AdditionalChildPath
A Elérési út paraméter értékéhez hozzáfűzendő további elemeket ad meg. A ChildPath paraméter továbbra is kötelező, és meg kell adni is.
Ez a paraméter a ValueFromRemainingArguments tulajdonsággal van megadva, amely korlátlan számú elérési út csatlakoztatását teszi lehetővé.
Ez a paraméter a PowerShell 6.0-ban lett hozzáadva.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 2 |
| 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 |
-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 |
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, mintha Dirname, Normpath, Realpath, Joinvagy más útvonal-manipulátort használna.
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.