Join-Path
Combineert een pad en een deelpad in één enkel pad.
Syntaxis
Default (Standaard)
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[[-AdditionalChildPath] <String[]>]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
De cmdlet Join-Path combineert een pad en een kindpad tot één enkel pad.
De provider levert de padscheidingstekens.
Voorbeelden
Voorbeeld 1: Een pad combineren met een subpad
Join-Path -Path "path" -ChildPath "childpath"
path\childpath
Met deze opdracht wordt Join-Path gebruikt om een pad te combineren met een subpad.
Omdat de opdracht wordt uitgevoerd vanuit de FileSystem-provider, biedt deze het \ scheidingsteken om de paden te koppelen.
Voorbeeld 2: Paden combineren die al adreslijstscheidingstekens bevatten
Join-Path -Path "path\" -ChildPath "\childpath"
path\childpath
Bestaande adreslijstscheidingstekens \ worden verwerkt, zodat er slechts één scheidingsteken is tussen Pad en ChildPath-.
Voorbeeld 3: Bestanden en mappen weergeven door een pad te koppelen aan een onderliggend pad
Join-Path "C:\win*" "System*" -Resolve
Met deze opdracht worden de bestanden en mappen weergegeven waarnaar wordt verwezen door het C:\Win\* pad te combineren met het System\* subpad. Dezelfde bestanden en mappen worden weergegeven als Get-ChildItem, maar het volledig gekwalificeerde pad naar elk item wordt weergegeven. In deze opdracht worden de Path en ChildPath optionele parameternamen weggelaten.
Voorbeeld 4: Join-Path gebruiken met de PowerShell-registerprovider
PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve
HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet
Met deze opdracht worden de registersleutels weergegeven in de HKLM\System registersubsleutel die ControlSetbevatten.
De parameter oplossen, probeert het gekoppelde pad op te lossen, inclusief jokertekens van het huidige providerpad HKLM:\
Voorbeeld 5: Meerdere padwortels combineren met een subpad
Join-Path -Path C:, D:, E:, F: -ChildPath New
C:\New
D:\New
E:\New
F:\New
Met deze opdracht wordt Join-Path gebruikt om meerdere padwortels te combineren met een onderliggend pad.
Opmerking
De stations die zijn opgegeven door pad moeten bestaan of de join van die vermelding mislukt.
Voorbeeld 6: De rootmappen van een bestandssysteemstation combineren met een subpad
Get-PSDrive -PSProvider FileSystem |
ForEach-Object {$_.Root} |
Join-Path -ChildPath "Subdir"
C:\Subdir
D:\Subdir
Met deze opdracht worden de wortels van elk PowerShell-bestandssysteemstation gecombineerd met het Subdir-kinderpad in de console.
De opdracht maakt gebruik van de Get-PSDrive cmdlet om de PowerShell-stations op te halen die worden ondersteund door de FileSystem-provider. De instructie ForEach-Object selecteert alleen de eigenschap Root van de PSDriveInfo objecten en combineert het met het opgegeven onderliggend pad.
De uitvoer geeft aan dat de PowerShell-stations op de computer een station bevatten dat is gekoppeld aan de C:\Program Files-map.
Voorbeeld 7: Een onbeperkt aantal paden combineren
Join-Path a b c d e f g
a\b\c\d\e\f\g
Met de parameter AdditionalChildPath kunt u een onbeperkt aantal paden samenvoegen.
In dit voorbeeld worden er geen parameternamen gebruikt, dus 'a' bindt aan Pad, 'b' aan ChildPath- en 'c-g' om AdditionalChildPath te.
Parameters
-AdditionalChildPath
Hiermee geeft u aanvullende elementen op die moeten worden toegevoegd aan de waarde van de parameter Path. De parameter ChildPath is nog steeds verplicht en moet ook worden opgegeven. Deze parameter wordt opgegeven met de eigenschap ValueFromRemainingArguments, waarmee een onbeperkt aantal paden kan worden toegevoegd.
Deze parameter is toegevoegd in PowerShell 6.0.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 2 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-ChildPath
Hiermee geeft u de elementen op die moeten worden toegevoegd aan de waarde van de parameter Path. Wildcards zijn toegestaan.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
Parametersets
(All)
| Position: | 1 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Credential
Opmerking
Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met PowerShell. Als u een andere gebruiker wilt imiteren of uw referenties wilt verhogen bij het uitvoeren van deze cmdlet, gebruikt u Invoke-Command-.
Parametereigenschappen
| Type: | PSCredential |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Path
Hiermee geeft u het hoofdpad (of paden) waaraan het onderliggende pad wordt toegevoegd. De waarde van Pad bepaalt welke provider de paden koppelt en de padscheidingstekens toevoegt. Wildcards zijn toegestaan.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | True |
| DontShow: | False |
| Aliassen: | PSPath |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Resolve
Geeft aan dat deze cmdlet moet proberen het samengevoegde pad van de huidige provider op te lossen.
- Als u jokertekens gebruikt, retourneert de cmdlet alle paden die overeenkomen met het gekoppelde pad.
- Als u geen jokertekens gebruikt, retourneert de cmdlet een fout als het pad niet bestaat.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
String
U kunt een tekenreeks die een pad naar deze cmdlet bevat, doorgeven.
Uitvoerwaarden
String
Deze cmdlet retourneert een tekenreeks die het resulterende pad bevat.
Notities
De cmdlets met het naamwoord Path manipuleren padnamen en retourneren de namen in een beknopte indeling die alle PowerShell-providers kunnen interpreteren. Ze zijn ontworpen om te worden gebruikt waar u alle of een deel van een pad in een bepaalde indeling wilt weergeven. Gebruik ze zoals u Dirname, Normpath, Realpath, Joinof andere pad manipulators zou gebruiken.
U kunt de pad-cmdlets gebruiken met verschillende providers, waaronder de providers FileSystem, Registryen Certificate.
Deze cmdlet is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PSProvider. Zie about_Providersvoor meer informatie.
