Sdílet prostřednictvím

Join-Path

  • Reference
Modul:
Microsoft.PowerShell.Management

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

Syntaxe

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. Zprostředkovatel 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 slouží Join-Path ke kombinování cesty s podřízenou cestou.

Vzhledem k tomu, že se příkaz provádí 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ářů \ se zpracovávají, takže mezi Path a mezi nimi je pouze jeden oddělovač. 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 spojení C:\Win\* cesty a System\* podřízené cesty. 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í cesty spojení 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ý obsahuje 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 slouží Join-Path ke kombinování více kořenových cest s podřízenou cestou.

Poznámka:

Jednotky určené Path musí 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 Subdir cestou.

Příkaz pomocí rutiny Get-PSDrive získá jednotky PowerShellu podporované poskytovatelem systému souborů. Příkaz ForEach-Object vybere pouze kořenovou vlastnost objektů PSDriveInfo a zkombinuje ji se zadanou podřízenou cestou.

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

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 spojit neomezený počet cest.

V tomto příkladu se nepoužívají žádné názvy parametrů, a proto se "a" sváže Paths , "b" a ChildPath "c-g" na AdditionalChildPath

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 určen vlastností ValueFromRemainingArguments , která umožňuje spojit neomezený počet cest.

Tento parametr byl přidán v PowerShellu 6.0.

Typ:String[]
Position:2
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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ý.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-Credential

Poznámka:

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

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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 spojí cesty a přidá oddělovače cest. Parametr Path je povinný, i když je název parametru ("Cesta") volitelný.

Typ:String[]
Aliasy:PSPath
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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žijí zástupné cardy, vrátí rutina všechny cesty, které odpovídají spojené cestě.
  • Pokud se nepoužívají žádné zástupné cardy, rutina se zobrazí chyba, pokud cesta neexistuje.
Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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í podstatná jména cesty (rutiny Path) manipulují s názvy cest a vracejí názvy ve stručné podobě, které můžou interpretovat všichni poskytovatelé PowerShellu. Jsou určené pro použití v programech a skriptech, ve kterých chcete zobrazit název cesty v určitém formátu nebo jeho část. Použijte je, jako byste použili Dirname, , NormpathRealpath, Join, nebo jiné manipulátory cest.

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

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