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>
    [-Resolve]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [<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

PS C:\> 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

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 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 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 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. Jokertekens zijn toegestaan. De parameter ChildPath is vereist, hoewel de parameternaam (ChildPath) optioneel is.

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. Jokertekens zijn toegestaan.

De waarde van Path bepaalt welke provider lid wordt van de paden en voegt de padscheidingstekens toe. De parameter Path is vereist, hoewel de parameternaam ('Pad') optioneel is.

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 jokertekens worden gebruikt, retourneert de cmdlet alle paden die overeenkomen met het gekoppelde pad.
  • Als geen jokertekens worden gebruikt, wordt er een foutbericht weergegeven als het pad niet bestaat.
Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UseTransaction

Bevat de opdracht in de actieve transactie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie about_Transactionsvoor meer informatie.

Type:SwitchParameter
Aliassen:usetx
Position:Named
Default value:False
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 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 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.