Join-Path
Combineert een pad en een onderliggend pad in één pad.
Syntax
Default (Standaard)
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<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
PS C:\> 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, levert deze het \ scheidingsteken om de paden te koppelen.
Voorbeeld 2: Paden combineren die al adreslijstscheidingstekens bevatten
PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"
path\childpath
Bestaande adreslijstscheidingstekens \ en verwerkt, zodat er slechts één scheidingsteken is tussen Path 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 en het onderliggende systeem*-pad toe te voegen.
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 Resolve 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 opgegeven door Path moeten bestaan, anders zal de samenvoeging van die invoer mislukken.
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 in de console gecombineerd met het onderliggende subdir-pad.
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 hoofdeigenschap van de PSDriveInfo-objecten en combineert deze met het opgegeven onderliggende pad.
In de uitvoer ziet u dat de PowerShell-stations op de computer een station bevatten dat is toegewezen aan de map C:\Program Files.
Parameters
-ChildPath
Hiermee geeft u de elementen op die moeten worden toegevoegd aan de waarde van de parameter Path.
Wildcards zijn toegestaan.
De parameter ChildPath is vereist, hoewel de parameternaam (ChildPath) optioneel is.
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. Wildcards zijn toegestaan.
De waarde van Path bepaalt welke provider de paden verbindt en de padscheidingstekens toevoegt.
De parameter Path is vereist, hoewel de parameternaam ('Pad') optioneel is.
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 wildcards worden gebruikt, retourneert de cmdlet alle paden die overeenkomen met het samengevoegde pad.
- Als geen jokertekens worden gebruikt, zal de cmdlet een fout geven 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 |
-UseTransaction
Bevat de opdracht in de actieve transactie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie about_Transactionsvoor meer informatie.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | usetx |
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 die het naamwoord Path (de Pad-cmdlets) bevatten, manipuleren padnamen en retourneren de namen in een beknopte indeling die alle PowerShell-providers kunnen interpreteren. Ze zijn ontworpen voor gebruik in programma's en scripts waarin u alle of een deel van een padnaam in een bepaalde indeling wilt weergeven. Gebruik ze zoals u Dirname, Normpath, Realpath, Join of 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.