Join-Path
Kombinerar en sökväg och en underordnad sökväg till en enda sökväg.
Syntax
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Description
Cmdleten Join-Path
kombinerar en sökväg och en underordnad sökväg till en enda sökväg.
Providern tillhandahåller sökvägsavgränsarna.
Exempel
Exempel 1: Kombinera en sökväg med en underordnad sökväg
PS C:\> Join-Path -Path "path" -ChildPath "childpath"
path\childpath
Det här kommandot använder Join-Path
för att kombinera en sökväg med en underordnade sökväg.
Eftersom kommandot körs från providern FileSystem
tillhandahåller \
det avgränsaren för att ansluta till sökvägarna.
Exempel 2: Kombinera sökvägar som redan innehåller katalogavgränsare
PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"
path\childpath
Befintliga katalogavgränsare \
och hanteras så att det bara finns en avgränsare mellan Path
och ChildPath
Exempel 3: Visa filer och mappar genom att koppla en sökväg till en underordnad sökväg
Join-Path "C:\win*" "System*" -Resolve
Det här kommandot visar de filer och mappar som refereras genom att ansluta till sökvägen C:\Win* och den underordnade sökvägen System*.
Den visar samma filer och mappar som Get-ChildItem
, men den visar den fullständigt kvalificerade sökvägen till varje objekt.
I det här kommandot utelämnas de valfria parameternamnen Path
och ChildPath
.
Exempel 4: Använd Join-Path med PowerShell-registerprovidern
PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve
HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet
Det här kommandot visar registernycklarna i registerundernyckeln HKLM\System
som innehåller ControlSet
.
Parametern Resolve
försöker matcha den anslutna sökvägen, inklusive jokertecken från den aktuella providersökvägen HKLM:\
Exempel 5: Kombinera flera sökvägsrötter med en underordnad sökväg
Join-Path -Path C:, D:, E:, F: -ChildPath New
C:\New
D:\New
E:\New
F:\New
Det här kommandot använder Join-Path
för att kombinera flera sökvägsrötter med en underordnad sökväg.
Anteckning
De enheter som anges av Path
måste finnas, annars misslyckas anslutningen till posten.
Exempel 6: Kombinera rötterna för en filsystemenhet med en underordnad sökväg
Get-PSDrive -PSProvider filesystem | ForEach-Object {$_.root} | Join-Path -ChildPath "Subdir"
C:\Subdir
D:\Subdir
Det här kommandot kombinerar rötterna för varje PowerShell-filsystemenhet i konsolen med den underordnade Sökvägen Subdir.
Kommandot använder cmdleten Get-PSDrive
för att hämta PowerShell-enheter som stöds av FileSystem-providern.
Instruktionen ForEach-Object
väljer endast rotegenskapen för objekten PSDriveInfo
och kombinerar den med den angivna underordnade sökvägen.
Utdata visar att PowerShell-enheterna på datorn inkluderade en enhet som mappats till katalogen C:\Program Files.
Parametrar
-ChildPath
Anger de element som ska läggas till i värdet för parametern Path
.
Jokertecken tillåts.
Parametern ChildPath
krävs, även om parameternamnet ("ChildPath") är valfritt.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Credential
Anteckning
Den här parametern stöds inte av några leverantörer som är installerade med PowerShell. Om du vill personifiera en annan användare eller höja dina autentiseringsuppgifter när du kör den här cmdleten använder du Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Anger den huvudsökväg (eller sökvägar) som den underordnade sökvägen läggs till i. Jokertecken tillåts.
Värdet för Path
avgör vilken provider som ansluter sökvägarna och lägger till sökvägsavgränsarna.
Parametern Path
krävs, även om parameternamnet ("Sökväg") är valfritt.
Type: | String[] |
Aliases: | PSPath |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Resolve
Anger att den här cmdleten ska försöka matcha den anslutna sökvägen från den aktuella providern.
- Om jokertecken används returnerar cmdleten alla sökvägar som matchar den anslutna sökvägen.
- Om inga jokertecken används får cmdleten fel om sökvägen inte finns.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseTransaction
Inkluderar kommandot i den aktiva transaktionen. Den här parametern är bara giltig medan en transaktion pågår. Mer information finns i about_Transactions.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
Du kan skicka en sträng som innehåller en sökväg till den här cmdleten.
Utdata
Den här cmdleten returnerar en sträng som innehåller den resulterande sökvägen.
Kommentarer
Cmdletarna som innehåller path-substantivet (cmdletarna Path) ändrar sökvägsnamnen och returnerar namnen i ett koncist format som alla PowerShell-leverantörer kan tolka. De är utformade för användning i program och skript där du vill visa hela eller delar av ett sökvägsnamn i ett visst format. Använd dem som om du skulle använda Dirname, Normpath, Realpath, Join eller andra sökvägsmanipulatörer.
Du kan använda sökvägs-cmdletar med flera providers, inklusive FileSystem
, Registry
och Certificate
providers.
Den här cmdleten är utformad för att fungera med data som exponeras av alla leverantörer.
Om du vill visa en lista över de leverantörer som är tillgängliga i sessionen skriver du Get-PSProvider
.
Mer information finns i about_Providers.