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

Voorbeeld 2: Paden combineren die al adreslijstscheidingstekens bevatten

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

path\childpath

Bestaande adreslijstscheidingstekens \ worden 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 het C:\Win\* pad en het System\* onderliggende pad te koppelen. 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 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 kunt Join-Path 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 hoofdmappen 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 Bestandssysteemprovider. 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 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 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 toe te voegen 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.

Deze parameter is toegevoegd in PowerShell 6.0.

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

-ChildPath

Hiermee geeft u de elementen 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 paden) waaraan het onderliggende pad wordt toegevoegd. Jokertekens zijn toegestaan.

De waarde van bepaalt welke provider lid wordt van Path de paden en voegt de padscheidingstekens toe. 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, wordt met de cmdlet een foutmelding weergegeven 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 met een pad naar deze cmdlet doorsluisen.

Uitvoerwaarden

String

Met deze cmdlet wordt een tekenreeks geretourneerd 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 zou gebruiken Dirname, Normpath, Realpath, of Joinandere pad manipulators.

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 Get-PSProvideru . Zie about_Providers voor meer informatie.