Join-Path
Bir yolu ve alt yolu tek bir yol halinde birleştirir.
Syntax
Default (Varsayılan)
Join-Path
[-Path] <String[]>
[-ChildPath] <String>
[[-AdditionalChildPath] <String[]>]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
Join-Path cmdlet bir yol ve alt yolu tek bir yol olarak birleştirir.
Sağlayıcı yol sınırlayıcılarını sağlar.
Örnekler
Örnek 1: Yolu alt yol ile birleştirme
PS C:\> Join-Path -Path "path" -ChildPath "childpath"
path\childpath
Bu komut, bir yolu alt yol ile birleştirmek için Join-Path kullanır.
Komut, FileSystem sağlayıcısından yürütüldüğü için, yolları birleştirmek amacıyla \ sınırlayıcıyı sağlar.
Örnek 2: Zaten dizin ayırıcıları içeren yolları birleştirme
PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"
path\childpath
Mevcut dizin ayırıcıları \ işlenir, bu nedenle Path ile ChildPath arasında yalnızca bir ayırıcı vardır
Örnek 3: Bir yolu alt yol ile birleştirerek dosya ve klasörleri görüntüleme
Join-Path "C:\win*" "System*" -Resolve
Bu komut, C:\Win\* yolunu ve System\* alt yolunu birleştirerek başvuruda bulunan dosya ve klasörleri görüntüler.
Get-ChildItemile aynı dosya ve klasörleri görüntüler, ancak her öğenin tam yolunu görüntüler. Bu komutta, Path ve ChildPath isteğe bağlı parametre adları atlanır.
Örnek 4: PowerShell kayıt defteri sağlayıcısıyla Join-Path kullanma
PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve
HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet
Bu komut, HKLM\Systemiçeren ControlSet kayıt defteri alt anahtarında kayıt defteri anahtarlarını görüntüler.
Resolve parametresi, geçerli sağlayıcı yolundaki joker karakterler de dahil olmak üzere birleştirilmiş yolu çözümlemeye çalışır HKLM:\
Örnek 5: Birden çok dizin kökünü bir alt dizin yolu ile birleştirme
Join-Path -Path C:, D:, E:, F: -ChildPath New
C:\New
D:\New
E:\New
F:\New
Bu komut, birden çok yol köklerini alt yol ile birleştirmek için Join-Path kullanır.
Uyarı
Path tarafından belirtilen Sürücüler mevcut olmalıdır, aksi takdirde bu girdinin birleşimi başarısız olur.
Örnek 6: Dosya sistemi sürücüsünün kök dizinlerini bir alt yolla birleştirme
Get-PSDrive -PSProvider filesystem | ForEach-Object {$_.root} | Join-Path -ChildPath "Subdir"
C:\Subdir
D:\Subdir
Bu komut, konsoldaki her PowerShell dosya sistemi sürücüsünün köklerini Subdir alt yol ile birleştirir.
Komutu, FileSystem sağlayıcısı tarafından desteklenen PowerShell sürücülerini almak için Get-PSDrive cmdlet'ini kullanır.
ForEach-Object deyimi, PSDriveInfo nesnelerinin yalnızca Root özelliğini seçer ve bunu belirtilen alt yol ile birleştirir.
Çıktı, bilgisayardaki PowerShell sürücülerinin C:\Program Files dizinine eşlenmiş bir sürücü içerdiğini gösterir.
Örnek 7: Belirsiz sayıda yolu birleştirme
Join-Path a b c d e f g
a\b\c\d\e\f\g
AdditionalChildPath parametresi sınırsız sayıda yolun birleştirilmesine olanak tanır.
Bu örnekte, parametre adları kullanılmadığından "a" Path, "b" ChildPath ve "c-g" AdditionalChildPath ile ilişkilendirilir.
Parametreler
-AdditionalChildPath
Path parametresinin değerine eklenecek ek öğeleri belirtir.
ChildPath parametresi hala zorunludur ve ayrıca belirtilmelidir.
Bu parametre, belirsiz sayıda yolu birleştirmeyi sağlayan ValueFromRemainingArguments özelliğiyle belirtilir.
Bu parametre PowerShell 6.0'a eklendi.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 2 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ChildPath
Path parametresinin değerine eklenecek öğeleri belirtir. Joker karakterlere izin verilir. parametre adı ("ChildPath") isteğe bağlı olsa da ChildPath parametresi gereklidir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Credential
Uyarı
Bu parametre, PowerShell ile yüklenen hiçbir sağlayıcı tarafından desteklenmez. Başka bir kullanıcının kimliğine bürünmek veya bu cmdlet'i çalıştırırken kimlik bilgilerinizi yükseltmek için Invoke-Commandkullanın.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Path
Alt yolun eklendiği ana yolu (veya yolları) belirtir. Joker karakterlere izin verilir.
Path değeri, hangi sağlayıcının yolları birleştirdiğini belirler ve yol sınırlayıcılarını ekler.
parametre adı ("Yol") isteğe bağlı olsa da Path parametresi gereklidir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
| Diğer adlar: | PSPath |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Resolve
Bu cmdlet'in geçerli sağlayıcıdan gelen birleştirilmiş yolu çözümlemeyi denemesi gerektiğini gösterir.
- Joker karakterler kullanılırsa, cmdlet birleştirilen yolla eşleşen tüm yolları döndürür.
- joker karakter kullanılmazsa ve yol mevcut değilse, cmdlet hata verir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
String
Bu cmdlet'e bir yolu içeren bir dizeyi aktarabilirsiniz.
Çıkışlar
String
Bu cmdlet, sonuçta elde edilen yolu içeren bir dize döndürür.
Notlar
Yol adını (Yol cmdlet'leri) içeren cmdlet'ler yol adlarını işleyip tüm PowerShell sağlayıcılarının yorumlayabildiği kısa bir biçimde döndürür. Bir yol adının tamamını veya bir bölümünü belirli bir biçimde görüntülemek istediğiniz programlarda ve betiklerde kullanılmak üzere tasarlanmıştır.
bunları Dirname, Normpath, Realpath, Joinveya diğer yol manipülatörleri gibi kullanın.
yol cmdlet'lerini FileSystem, Registryve Certificate sağlayıcıları dahil olmak üzere çeşitli sağlayıcılarla kullanabilirsiniz.
Bu cmdlet, herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için Get-PSProvideryazın. Daha fazla bilgi için bkz. about_Providers.