Feedback

Join-Path

  • Referentie
Module:
Microsoft.PowerShell.Management

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

Syntax

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

Description

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

Voorbeelden

Voorbeeld 1: Een pad combineren met een onderliggend pad

PS C:\> Join-Path -Path "path" -ChildPath "childpath"

path\childpath

Met deze opdracht wordt Join-Path een pad gecombineerd 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

PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"

path\childpath

Bestaande adreslijstscheidingstekens \ en verwerkt, zodat er slechts één scheidingsteken 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 deel te nemen aan het pad C:\Win* en het onderliggende pad System*. Er worden dezelfde bestanden en mappen 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 zijn opgenomen ControlSet.

De Resolve parameter 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 Join-Path kunt u meerdere padwortels combineren met een onderliggend pad.

Notitie

De stations die zijn opgegeven door Path 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 wortels van elk PowerShell-bestandssysteemstation in de console gecombineerd met het subdir-onderliggende pad.

De opdracht gebruikt de Get-PSDrive cmdlet om de PowerShell-stations op te halen die worden ondersteund door de FileSystem-provider. De ForEach-Object instructie 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.

Voorbeeld 7: Een onbeperkt aantal paden combineren

Join-Path a b c d e f g

a\b\c\d\e\f\g

Met AdditionalChildPath de parameter kan een onbeperkt aantal paden worden toegevoegd.

In dit voorbeeld worden geen parameternamen gebruikt, dus "a" bindt aan Path, "b" aan ChildPath en "c-g" aan AdditionalChildPath

Parameters

-AdditionalChildPath

Hiermee geeft u aanvullende elementen op die moeten worden toegevoegd aan de waarde van de parameter Path . De ChildPath parameter is nog steeds verplicht en moet ook worden opgegeven.

Deze parameter wordt opgegeven met de ValueFromRemainingArguments eigenschap waarmee een onbeperkt aantal paden kan worden toegevoegd.

Type:String[]
Position:2
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-ChildPath

Hiermee geeft u de elementen op die moeten worden toegevoegd aan de waarde van de Path parameter. Jokertekens zijn toegestaan. De ChildPath parameter is vereist, hoewel de parameternaam ("ChildPath") optioneel is.

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:True
Accept wildcard characters:False
-Path

Hiermee geeft u het hoofdpad (of paden) waaraan het onderliggende pad wordt toegevoegd. Jokertekens zijn toegestaan.

De waarde van Path bepaalt welke provider de paden koppelt en het padscheidingstekens toevoegt. De Path parameter is vereist, hoewel de parameternaam ("Path") optioneel is.

Type:String[]
Aliases:PSPath
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:True
-Resolve

Geeft aan dat met deze cmdlet moet worden geprobeerd het gekoppelde pad van de huidige provider op te lossen.

  • Als jokertekens worden gebruikt, retourneert de cmdlet alle paden die overeenkomen met het gekoppelde pad.
  • Als er geen jokertekens worden gebruikt, wordt de cmdlet weergegeven als het pad niet bestaat.
Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 Pad (de Pad-cmdlets) 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 waar 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 FileSystemRegistry, en 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_Providers voor meer informatie.