Join-Path
Kombinerar en sökväg med en underordnad sökväg till en enda sökväg.
Syntax
Default (Standard)
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[[-AdditionalChildPath] <String[]>]
[-Resolve]
[-Credential <PSCredential>]
[<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
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 underordnad sökväg.
Eftersom kommandot körs från providern FileSystem tillhandahåller det \ avgränsare för att ansluta sökvägarna.
Exempel 2: Kombinera sökvägar som redan innehåller katalogavgränsare
Join-Path -Path "path\" -ChildPath "\childpath"
path\childpath
Befintliga katalogavgränsare \ hanteras så det finns bara en avgränsare mellan Path och ChildPath.
Exempel 3: Visa filer och mappar genom att ansluta 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 kombinera sökvägen C:\Win\* med den underordnade sökvägen System\*. Den visar samma filer och mappar som Get-ChildItem, men visar den fullständigt kvalificerade sökvägen till varje objekt. I det här kommandot utelämnas Path och ChildPath valfria parameternamn.
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 HKLM\System registerundernyckeln 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.
Anmärkning
De enheter som anges av Sökväg 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-filsystemdriv i konsolen med Subdir-undervägen.
Kommandot använder cmdleten Get-PSDrive för att hämta PowerShell-enheter som stöds av FileSystem-providern.
ForEach-Object-instruktionen väljer endast egenskapen Root för PSDriveInfo objekt 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.
Exempel 7: Kombinera ett obegränsat antal sökvägar
Join-Path a b c d e f g
a\b\c\d\e\f\g
Parametern AdditionalChildPath tillåter sammanfogning av ett obegränsat antal sökvägar.
I det här exemplet används inga parameternamn, vilket innebär att "a" binder till Path, "b" to ChildPath och "c-g" to AdditionalChildPath.
Parametrar
-AdditionalChildPath
Anger ytterligare element som ska läggas till i värdet för parametern Path. Parametern ChildPath är fortfarande obligatorisk och måste också anges. Den här parametern anges med egenskapen ValueFromRemainingArguments, vilket gör det möjligt att ansluta till ett obegränsat antal sökvägar.
Den här parametern lades till i PowerShell 6.0.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 2 |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-ChildPath
Anger de element som ska läggas till i värdet för parametern Path. Jokertecken tillåts.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 1 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Credential
Anmärkning
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.
Parameteregenskaper
| Typ: | PSCredential |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Path
Anger den huvudsökväg (eller sökvägar) som den underordnade sökvägen läggs till i. Värdet för Path avgör vilken provider som ansluter sökvägarna och lägger till sökvägsavgränsarna. Jokertecken tillåts.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
| Alias: | PSPath |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Resolve
Indikerar att denna cmdlet ska försöka lösa upp den anslutna sökvägen från den aktuella leverantören.
- Om du använder jokertecken returnerar cmdleten alla sökvägar som matchar den anslutna sökvägen.
- Om du inte använder jokertecken returnerar cmdleten ett fel om sökvägen inte finns.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
String
Du kan skicka en sträng som innehåller en sökväg till den här cmdleten.
Utdata
String
Den här cmdleten returnerar en sträng som innehåller den resulterande sökvägen.
Kommentarer
Cmdletarna som innehåller path-substantivet manipulerar sökvägsnamnen och returnerar namnen i ett kortfattat format som alla PowerShell-leverantörer kan tolka. De är utformade för att användas där du vill visa hela eller en del av en sökväg i ett visst format. Använd dem som du skulle använda Dirname, Normpath, Realpath, Joineller andra sökvägsmanipulatörer.
Du kan använda sökvägcmdletar med flera leverantörer, inklusive FileSystem, Registryoch Certificate.
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 tillgängliga leverantörer i sessionen skriver du Get-PSProvider. Mer information finns i om_Leverantörer.
