Delen via

Join-Path

  • Referentie
Module:
Microsoft.PowerShell.Management

Combineert een pad en een onderliggend pad in één pad.

Syntaxis

Join-Path
    [-Path] <String[]>
    [-ChildPath] <String>
    [[-AdditionalChildPath] <String[]>]
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Description

De cmdlet Join-Path combineert een pad en een onderliggend pad in één pad. De provider levert de padscheidingstekens.

Voorbeelden

Voorbeeld 1: Een pad combineren met een onderliggend pad

Join-Path -Path "path" -ChildPath "childpath"

path\childpath

Met deze opdracht wordt Join-Path gebruikt om een pad te combineren met een onderliggend pad.

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 lid te worden van het C:\Win\* pad en het System\* onderliggende pad. 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 onderliggend pad

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.

Notitie

De stations die zijn opgegeven door pad moeten bestaan of de join van die vermelding mislukt.

Voorbeeld 6: De wortels van een bestandssysteemstation combineren met een onderliggend pad

Get-PSDrive -PSProvider FileSystem |
    ForEach-Object {$_.Root} |
    Join-Path -ChildPath "Subdir"

C:\Subdir
D:\Subdir

Met deze opdracht worden de hoofdmappen van elk PowerShell-bestandssysteemstation in de console gecombineerd met het Subdir onderliggende 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 eigenschap Root 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 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.

Type:String[]
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ChildPath

Hiermee geeft u de elementen op die moeten worden toegevoegd aan de waarde van de parameter Path. Jokertekens zijn toegestaan.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-Credential

Notitie

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-.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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. Jokertekens zijn toegestaan.

Type:String[]
Aliassen:PSPath
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-Resolve

Geeft aan dat deze cmdlet moet proberen het gekoppelde 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.
Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een tekenreeks met een pad naar deze cmdlet doorsluisen.

Uitvoerwaarden

String

Met deze cmdlet wordt een tekenreeks geretourneerd 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 FileSystem, Registryen Certificate providers.

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.