Share via

Join-Path

  • Referentie
Module:
Microsoft.PowerShell.Management

Combineert een pad en een onderliggend pad tot éé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 de padscheidingstekens.

Voorbeelden

Voorbeeld 1: Een pad combineren met een onderliggend pad

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

path\childpath

Deze opdracht gebruikt Join-Path 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 samen te voegen.

Voorbeeld 2: paden combineren die al mapscheidingstekens bevatten

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

path\childpath

Bestaande scheidingstekens \ voor mappen en verwerkt, zodat er slechts één scheidingsteken is tussen Path en ChildPath

Voorbeeld 3: bestanden en mappen weergeven door een pad samen te voegen met een onderliggend pad

Join-Path "C:\win*" "System*" -Resolve

Met deze opdracht worden de bestanden en mappen weergegeven waarnaar wordt verwezen door het pad C:\Win* en het onderliggende pad System* samen te voegen. 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 optionele parameternamen en ChildPath 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 in de HKLM\System registersubsleutel weergegeven, waaronder ControlSet.

De Resolve parameter probeert het gekoppelde pad om 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 gebruikt Join-Path om meerdere padwortels te combineren met een onderliggend pad.

Notitie

De stations die zijn opgegeven door Path moeten bestaan, anders mislukt de koppeling van die vermelding.

Voorbeeld 6: De hoofdmappen 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 subpad Subdir.

De opdracht maakt gebruik van de Get-PSDrive cmdlet om de PowerShell-stations op te halen die worden ondersteund door de bestandssysteemprovider. De ForEach-Object instructie selecteert alleen de eigenschap Root van de PSDriveInfo objecten en combineert deze met het opgegeven onderliggende pad.

De uitvoer toont 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 kunt u een onbeperkt aantal paden samenvoegen.

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 extra elementen toe te voegen aan de waarde van de path parameter . 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 gekoppeld.

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

-ChildPath

Hiermee geeft u de elementen aan 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
Required:True
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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

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

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

-Resolve

Geeft aan dat deze cmdlet moet proberen 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, krijgt de cmdlet een foutmelding als het pad niet bestaat.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

U kunt een tekenreeks doorsnijden die een pad naar deze cmdlet bevat.

Uitvoerwaarden

String

Deze cmdlet retourneert een tekenreeks die het resulterende pad bevat.

Notities

De cmdlets die het naamwoord Pad (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 waarbij u een padnaam geheel of gedeeltelijk 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 FileSystemproviders , 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_Providers voor meer informatie.