Join-Path

  • Referencia
Modul:
Microsoft.PowerShell.Management

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.

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-ChildItemaz elemek teljes elérési útját. Ebben a parancsban a PathChildPath 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átvá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.

Type:String[]
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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ő.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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ő.

Type:String[]
Aliases:PSPath
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

String

A parancsmag elérési útját tartalmazó sztringet csövezheti.

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, ahogy ön használnáDirname, Normpathvagy RealpathJoinmá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.