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>]
[-Extension <String>]
[<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
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 parancs a FileSystem-szolgáltatótól van végrehajtva, a \ elválasztójelet biztosítja az elérési utakhoz való csatlakozáshoz.
2. példa: A címtárelválasztókat már tartalmazó elérési utak egyesítése
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ó Elérési út és ChildPathközött.
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 Elérési út és ChildPath választható paraméternevek kimaradnak.
4. példa: Join-Path használata a PowerShell-beállításjegyzék-szolgáltató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 Feloldja paramétert, megkísérli 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 Elérési út által megadott meghajtóknak létezniük kell, vagy a bejegyzés összekapcsolása 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
Az AdditionalChildPath paraméter korlátlan számú elérési út összekapcsolását teszi lehetővé.
Ebben a példában nem használ paraméterneveket, így az "a" Path, "b" és ChildPath, a "c-g" pedig az AdditionalChildPath .
8. példa: Korlátlan számú elérési út egyesítése
A ChildPath paraméter lehetővé teszi az elérési utak tömbjének összekapcsolását.
Join-Path -Path a -ChildPath b, c, d, e, f, g
a\b\c\d\e\f\g
9. példa: Bővítmény hozzáadása fájlhoz bővítmény nélkül
Join-Path C:\Temp myfile -Extension txt
C:\Temp\myfile.txt
10. példa: Meglévő bővítmény módosítása
Join-Path C:\Temp myfile.txt -Extension .log
C:\Temp\myfile.log
11. példa: Bevezető pont nélküli bővítmény
Join-Path C:\Temp file.txt -Extension log
C:\Temp\file.log
12. példa: Bővítmény eltávolítása üres sztringgel
Join-Path C:\Temp file.txt -Extension ""
C:\Temp\file
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 PowerShell 7.6-preview.4-től kezdődően ez a paraméter sztringek tömböt fogad el. Ez lehetővé teszi több gyermekútvonal megadását a fő elérési úthoz való csatlakozáshoz. Ezt a paramétert a AdditionalChildPath paraméter helyett használhatja.
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 |
-Extension
Megadja az eredményként kapott elérési úthoz használni kívánt bővítményt. Ha nincs megadva, az eredeti bővítmény megmarad. A bővítmény első pontjának megadása nem kötelező. Ha nincs megadva, a parancs automatikusan hozzáadja.
- Ha az elérési út már rendelkezik egy meglévő kiterjesztéssel, akkor a megadott kiterjesztés lesz lecserélve.
- Ha az elérési út nem rendelkezik kiterjesztéssel, a rendszer hozzáadja a megadott bővítményt.
- Ha üres sztringet ad meg, a meglévő bővítmény el lesz távolítva.
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: | 0 |
| 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 |
-Path
Megadja azokat a fő elérési utakat (vagy elérési utakat), amelyekhez a gyermekútvonal hozzá van fűzve. A Elérési út é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. Helyettesítő karakterek használata engedélyezett.
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.
- Ha helyettesítő karaktereket használ, a parancsmag az összes olyan elérési utat visszaadja, amely megfelel az összekapcsolt elérési útnak.
- Ha nem használ helyettesítő karaktereket, a parancsmag hibát ad vissza, 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őnévvel rendelkező 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ó képes értelmezni. Úgy vannak kialakítva, hogy ott használják, ahol egy adott formátumban szeretné megjeleníteni az elérési út egy részét vagy egészét. 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.
