Join-Path
Kombinuje cestu a podcestu do jedné cesty.
Syntax
Default (Výchozí)
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[[-AdditionalChildPath] <String[]>]
[-Resolve]
[-Credential <PSCredential>]
[<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
Stávající oddělovače adresářů \ jsou zpracovávány, takže mezi Path a ChildPath je pouze jeden oddělovač.
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ím cesty C:\Win\* a podcesty 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 vlastnost Root objektů PSDriveInfo a zkombinuje ji se zadanou podřízenou cestou.
Výstup ukazuje, že jednotky PowerShellu v počítači obsahovaly jednotku namapovanou na adresář 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 spojit neomezený počet cest.
V tomto příkladu se nepoužívají žádné názvy parametrů, a proto se "a" sváže s Path, "b" k ChildPath a "c-g" k 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 zadán pomocí vlastnosti ValueFromRemainingArguments, která umožňuje spojit neomezený počet cest.
Tento parametr byl přidán v PowerShellu 6.0.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 2 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-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 |
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, Joinnebo 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.