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>
    [-Resolve]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [<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 používá Join-Path ke kombinování cesty s podřízenou cestou.

Vzhledem k tomu, že příkaz se provádí zprostředkovatele FileSystem, 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 spojení 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 se vynechá Path a ChildPath volitelné názvy 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 registru HKLM\System, který obsahuje ControlSet.

Parametr Resolve se pokusí přeložit připojenou cestu, včetně zástupných znaků z aktuální cesty poskytovatele 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 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 cestou Subdir.

Tento příkaz používá rutinu Get-PSDrive k získání jednotek PowerShellu, které podporuje zprostředkovatel FileSystem. Příkaz ForEach-Object vybere pouze kořenovou vlastnost PSDriveInfo objektů a zkombinuje ho se zadanou podřízenou cestou.

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

Parametry

-ChildPath

Určuje prvky, které se mají připojit k hodnotě Path parametru. 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 oprávnění 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

-UseTransaction

Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace najdete v tématu about_Transactions.

Typ:SwitchParameter
Aliasy:usetx
Position:Named
Default value:False
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, Normpath, Realpath, Join nebo jiné manipulátory cest.

Rutiny cesty můžete použít s několika poskytovateli, včetně 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 naleznete v tématu about_Providers.