Join-Path
Kombinuje cestu a podřízenou cestu do jedné cesty.
Syntax
Default (Výchozí)
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Description
Cmdlet Join-Path kombinuje cestu a podřízenou cestu do jedné cesty.
Zprostředkovatel poskytuje oddělovače cest.
Příklady
Příklad 1: Spojení 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.
Protože je příkaz vykonáván poskytovatelem 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é pomocí Path musí existovat, jinak propojení této položky selže.
Příklad 6: Kombinování kořenového adresáře disku s podadresářem
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é symboly.
Parametr ChildPath je povinný, i když je název parametru (ChildPath) volitelný.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-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.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Path
Určuje hlavní cestu (nebo cesty), ke které je připojena podřízená cesta. Jsou povoleny zástupné symboly.
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ý.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
| Aliasy: | PSPath |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Resolve
Označuje, že by se tato rutina měla pokusit vyhodnotit sloučenou cestu od aktuálního poskytovatele.
- Pokud se použijí zástupné znaky, vrátí rutina všechny cesty, které odpovídají sloučené cestě.
- Pokud se nepoužívají žádné zástupné cardy, rutina se zobrazí chyba, pokud cesta neexistuje.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | usetx |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
Řetězec, který obsahuje cestu, můžete předat tomuto cmdletu.
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 poskytovatele.
Tato rutina je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem.
Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište Get-PSProvider.
Pro více informací viz about_Providers.