Join-Path

Kombinuje cestu a podřízenou cestu do jedné cesty.

Syntax

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

Description

Rutina Join-Path kombinuje cestu a podřízenou cestu do jedné cesty. Poskytovatel poskytuje oddělovače cest.

Příklady

Příklad 1: Kombinování cesty s podřízenou cestou

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

path\childpath

Tento příkaz používá Join-Path ke kombinování cesty s podřízenou cestou.

Vzhledem k tomu, že se příkaz spustí od FileSystem zprostředkovatele, poskytuje \ oddělovač pro spojení cest.

Příklad 2: Kombinování cest, které již obsahují oddělovače adresářů

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

path\childpath

Existující oddělovače adresářů a zpracovávané \ tak, aby mezi Path a ChildPath

Příklad 3: Zobrazení souborů a složek připojením cesty k podřízené cestě

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

Tento příkaz zobrazí soubory a složky, na které odkazuje připojení cesty C:\Win* a podřízené cesty System*. Zobrazí stejné soubory a složky jako Get-ChildItem, ale zobrazí plně kvalifikovanou cestu ke každé položce. V tomto příkazu Path jsou vynechány názvy volitelných ChildPath parametrů.

Příklad 4: Použití Join-Path s poskytovatelem registru PowerShellu

PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve

HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet

Tento příkaz zobrazí klíče registru v podklíči HKLM\System registru, který zahrnuje ControlSet.

Parametr Resolve se pokusí přeložit připojenou cestu, včetně zástupných znaků z aktuální cesty zprostředkovatele. HKLM:\

Příklad 5: Kombinování více kořenových cest s podřízenou cestou

Join-Path -Path C:, D:, E:, F: -ChildPath New

C:\New
D:\New
E:\New
F:\New

Tento příkaz používá Join-Path ke kombinování více kořenových cest s podřízenou cestou.

Poznámka

Jednotky zadané musí Path existovat nebo spojení této položky selže.

Příklad 6: Kombinování kořenů jednotky systému souborů s podřízenou cestou

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

C:\Subdir
D:\Subdir

Tento příkaz kombinuje kořeny jednotlivých jednotek systému souborů PowerShellu v konzole s podřízenou cestou Subdir.

Příkaz používá rutinu Get-PSDrive k získání jednotek PowerShellu podporovaných poskytovatelem FileSystem. Příkaz ForEach-Object vybere pouze kořenovou vlastnost PSDriveInfo objektů a zkombinuje ji se zadanou podřízenou cestou.

Výstup ukazuje, že jednotky PowerShellu v počítači obsahovaly jednotku namapovanou do adresáře C:\Program Files.

Příklad 7: Kombinování neomezeného počtu cest

Join-Path a b c d e f g

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

Parametr AdditionalChildPath umožňuje spojení neomezeného počtu cest.

V tomto příkladu se nepoužívají žádné názvy parametrů, tedy "a" s vazbou na Path, "b" a "c-g" k ChildPathAdditionalChildPath

Parametry

-AdditionalChildPath

Určuje další prvky, které se mají připojit k hodnotě parametru Path . Parametr ChildPath je stále povinný a musí být také zadán.

Tento parametr je zadán s ValueFromRemainingArguments vlastností, která umožňuje spojit neomezený počet cest.

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

-ChildPath

Určuje prvky, které se mají připojit k hodnotě parametru Path . Jsou povoleny zástupné cardy. Parametr ChildPath je povinný, i když je název parametru (ChildPath) volitelný.

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

-Credential

Poznámka

Tento parametr nepodporuje žádné poskytovatele nainstalované v PowerShellu. Pokud chcete zosobnit jiného uživatele nebo zvýšit úroveň svých přihlašovacích údajů při spuštění této rutiny, použijte Invoke-Command.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Path

Určuje hlavní cestu (nebo cesty), ke které je připojena podřízená cesta. Jsou povoleny zástupné cardy.

Hodnota Path určuje, který zprostředkovatel spojuje cesty a přidá oddělovače cest. Parametr Path je povinný, i když je název parametru ("Cesta") volitelný.

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

-Resolve

Označuje, že by se tato rutina měla pokusit přeložit připojenou cestu od aktuálního poskytovatele.

  • Pokud se používají zástupné cardy, vrátí rutina všechny cesty, které odpovídají připojené cestě.
  • Pokud se nepoužívají žádné zástupné cardy, rutina dojde k chybě, pokud cesta neexistuje.
Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

String

Řetězec, který obsahuje cestu k této rutině, můžete převést.

Výstupy

String

Tato rutina vrátí řetězec, který obsahuje výslednou cestu.

Poznámky

Rutiny obsahující jmenné jméno cesty (rutiny cesty) manipulují s názvy cest a vracejí názvy ve stručné podobě, které můžou interpretovat všichni poskytovatelé PowerShellu. Jsou navržené pro použití v programech a skriptech, kde chcete zobrazit celý název cesty nebo jeho část v určitém formátu. Použijte je, jako byste použili Dirname, Normpath, Realpath, Join nebo jiné manipulátory cest.

Rutiny cesty můžete použít s několika poskytovateli, včetně operátoru FileSystem, Registrya Certificate zprostředkovatelů.

Tato rutina je navržená tak, aby fungovala s daty vystavenými libovolným poskytovatelem. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PSProvider. Další informace najdete v tématu about_Providers.