Join-Path (Microsoft.PowerShell.Management)

Join-Path

Modül:

Microsoft.PowerShell.Management

Bir yolu ve alt yolu tek bir yolda birleştirir.

Sözdizimi

Join-Path
    [-Path] <String[]>
    [-ChildPath] <String>
    [[-AdditionalChildPath] <String[]>]
    [-Resolve]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Tanım

Join-Path cmdlet'i, yolu ve alt yolu tek bir yolda birleştirir. Sağlayıcı yol sınırlayıcıları sağlar.

Örnekler

Örnek 1: Bir yolu alt yolla birleştirme

PS C:\> Join-Path -Path "path" -ChildPath "childpath"

path\childpath

Bu komut, bir yolu bir alt yolla birleştirmek için Join-Path'i kullanır.

Komut FileSystem sağlayıcısından yürütüldüğünden, 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

PS C:\> Join-Path -Path "path\" -ChildPath "\childpath"

path\childpath

Mevcut dizin ayırıcıları \ işlendiğinden, Path ve ChildPath arasında yalnızca bir ayırıcı bulunur

Örnek 3: Bir yolu bir alt yolla birleştirerek dosya ve klasörleri görüntüleyin

Join-Path "C:\win*" "System*" -Resolve

Bu komut, C:\Win\* yolunu ve System\* alt yolunu birleştirerek başvurulan dosya ve klasörleri görüntüler. Get-ChildItem ile 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 sağlayıcısıyla join-Path'i kullanma

PS HKLM:\> Join-Path -Path System -ChildPath *ControlSet* -Resolve

HKLM:\System\ControlSet001
HKLM:\System\CurrentControlSet

Bu komut, ControlSet'i içeren HKLM\System kayıt defteri alt anahtarındaki kayıt defteri anahtarlarını görüntüler.

Resolve parametresi, geçerli HKLM:\ sağlayıcı yolundaki joker karakterler de dahil olmak üzere birleştirilmiş yolu çözümlemeye çalışır.

Örnek 5: Birden çok yol kökünü bir alt yolla 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ökünü bir alt yolla birleştirmek için Birleştirme Yolu'nu kullanır.

Örnek 6: Bir dosya sistemi sürücüsünün köklerini bir alt yolla birleştirin

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 yoluyla birleştirir.

Komut, FileSystem sağlayıcısı tarafından desteklenen PowerShell sürücülerini almak için Get-PSDrive cmdlet'ini kullanır. ForEach-Object ifadesi, PSDriveInfo nesnelerinin yalnızca Root özelliğini seçer ve bunu belirtilen alt yolla birleştirir.

Çıktı, bilgisayardaki PowerShell sürücülerinin C:\Program Files dizinine eşlenen 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 hiçbir parametre adı kullanılmaz, dolayısıyla "a" Path'e, "b" ChildPath'e ve "c-g" AdditionalChildPath'e bağlanır

Parametreler

-AdditionalChildPath

Path parametresinin değerine eklenecek ek öğeleri belirtir. ChildPath parametresi hala zorunludur ve ayrıca belirtilmelidir.

Bu parametre, sınırsız sayıda yolun birleştirilmesini sağlayan ValueFromRemainingArguments özelliğiyle belirtilir.

Bu parametre PowerShell 6,0'a eklenmiştir.

Tip :

String[]

Konum:

2

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-ChildPath

Path parametresinin değerine eklenecek öğeleri belirtir. Joker karakterlere izin verilir. ChildPath parametresi gereklidir, ancak parametre adı ("ChildPath") isteğe bağlıdır.

Tip :

String

Konum:

1

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

True

-Credential

Tip :

PSC kimlik bilgisi

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-Path

Alt yolun eklendiği ana yolu (veya yolları) belirtir. Joker karakterlere izin verilir.

Yol değeri, hangi sağlayıcının yollara katılacağını ve yol sınırlayıcılarını ekleyeceğini belirler. Path parametresi gereklidir, ancak parametre adı ("Path") isteğe bağlıdır.

Tip :

String[]

Takma adlar:

PSPath

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

True

-Resolve

Bu cmdlet'in geçerli sağlayıcıdan gelen birleştirilmiş yolu çözümlemeye çalışması gerektiğini belirtir.

• Joker karakterler kullanılırsa cmdlet, birleştirilen yolla eşleşen tüm yolları döndürür.
• Hiçbir joker karakter kullanılmazsa, yol yoksa cmdlet hata verecektir.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

Dize

Bu cmdlet'in yolunu içeren bir dizeyi yönlendirebilirsiniz.

Çıkışlar

Dize

Bu cmdlet, sonuçtaki yolu içeren bir dize döndürür.

Notlar

Yol adını içeren cmdlet'ler (Yol cmdlet'leri) yol adlarını yönetir ve adları tüm PowerShell sağlayıcılarının yorumlayabileceği kısa bir biçimde döndürür. Yol adının tamamını veya bir kısmını belirli bir biçimde görüntülemek istediğiniz programlarda ve komut dosyalarında kullanılmak üzere tasarlanmıştır. Bunları, Dizname, Normpath, Realpath, Join veya diğer yol düzenleyicileri kullandığınız gibi kullanın.

Yol cmdlet'lerini FileSystem, Registry ve Certificate sağlayıcıları da dahil olmak üzere çeşitli sağlayıcılarla kullanabilirsiniz.

Bu cmdlet, herhangi bir sağlayıcının açığa çıkardığı verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda mevcut olan sağlayıcıları listelemek için Get-PSProvider yazın. Daha fazla bilgi için bkz. about_Providers.