Join-Path
Egy elérési utat és egy gyermek elérési utat egyesít egyetlen elérési úton.
Syntax
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[[-AdditionalChildPath] <String[]>]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
A Join-Path
parancsmag egyetlen elérési útba egyesíti az elérési utat és a gyermek elérési utat.
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 egy elérési út gyermekútvonallal való kombinálására használható Join-Path
.
Mivel a parancsot a FileSystem
szolgáltatótól hajtja végre, az \
elválasztójelet biztosítja az útvonalakhoz való csatlakozáshoz.
az elérési utakat.
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 \
kezelése úgy történik, hogy csak egy elválasztó Path
legyen a 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 az elérési út és a gyermek elérési út összekapcsolásával C:\Win\*
hivatkozott fájlokat és System\*
mappákat. Ugyanazokat a fájlokat és mappákat jeleníti meg, mint Get-ChildItem
az elemek teljes elérési útját. Ebben a parancsban a Path
ChildPath
választható paraméternevek nem lesznek megadva.
4. példa: A 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 beállításjegyzék alkulcsában, amely tartalmazza a HKLM\System
következőt ControlSet
: .
A Resolve
paraméter megpróbálja feloldani az összekapcsolt elérési utat, beleértve az aktuális szolgáltatói elérési út 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 Join-Path
több elérési út gyökerét kombinálja egy gyermekútvonallal.
Feljegyzés
A megadott Path
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 FileSystem szolgáltató által támogatott PowerShell-meghajtókat. Az ForEach-Object
utasítás csak a PSDriveInfo-objektumok gyökértulajdonsá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 könyvtárra leképezett meghajtót C:\Program Files
.
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ál paraméterneveket, így az "a" a "b" és a "c-g" ChildPath
értékhez kötődikPath
.AdditionalChildPath
Paraméterek
-AdditionalChildPath
Az 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 lehetővé teszi a korlátlan számú elérési úthoz való csatlakozást.
Ez a paraméter a PowerShell 6.0-ban lett hozzáadva.
Típus: | String[] |
Position: | 2 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-ChildPath
Megadja a paraméter értékéhez Path
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ő.
Típus: | String |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | True |
-Credential
Feljegyzés
Ezt a paramétert a PowerShell-lel telepített szolgáltatók nem támogatják. Ha megszemélyesíteni szeretne egy másik felhasználót, vagy a parancsmag futtatásakor emeli a hitelesítő adatait, használja az Invoke-Command parancsot.
Típus: | PSCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Az érték Path
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ő.
Típus: | String[] |
Aliasok: | PSPath |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | True |
-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 hibás lesz, ha az elérési út nem létezik.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
A parancsmag elérési útját tartalmazó sztringet csövezheti.
Kimenetek
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, ahogy ön használnáDirname
, Normpath
vagy Realpath
Join
más elérésiút-manipulátorokat.
Az elérésiút-parancsmagokat több szolgáltatóval is használhatja, beleértve a FileSystem
, Registry
és Certificate
a szolgáltatókat is.
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 következőt Get-PSProvider
: További információ: about_Providers.