Join-Path
Bir yolu ve alt yolu tek bir yol halinde bir araya getirir.
Sözdizimi
Default EnterprisePublishing
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
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ülürken, yolları birleştirmek için \ sınırlayıcısını sağlar.
Örnek 2: Zaten dizin ayırıcıları içeren yolları birleştirme
Join-Path -Path "path\" -ChildPath "\childpath"
path\childpath
Varolan dizin ayırıcıları \ işlenir, bu nedenle Yol ile ChildPatharasında tek 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, Yol 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.
Çözümle parametresi, geçerli sağlayıcı yolundan gelen joker karakterler de dahil olmak üzere birleştirilmiş yolu çözümlemeyi dener 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ı
Yolu 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 adı kullanılmaz; bu nedenle "a" Path, "b" ChildPath ve "c-g" ile AdditionalChildPathbağlar.
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 ö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 sağlayıcılar 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. Path değeri, hangi sağlayıcının yolları birleştirdiğini belirler ve yol sınırlayıcılarını ekler. Joker karakterlere izin verilir.
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ırsanız, cmdlet birleştirilen yolla eşleşen tüm yolları döndürür.
- Joker karakter kullanmıyorsanız, yol yoksa cmdlet bir hata döndürür.
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ı içeren cmdlet'ler yol adlarını işleyip adları tüm PowerShell sağlayıcılarının yorumlayabildiği kısa bir biçimde döndürür. Bir yolun tamamını veya bir bölümünü belirli bir biçimde görüntülemek istediğiniz yerde kullanılacak şekilde 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.
