Join-Path

  • Başvuru
Modül:
Microsoft.PowerShell.Management

Bir yolu ve alt yolu tek bir yol halinde birleştirir.

Syntax

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

Description

Cmdlet bir Join-Path yolu ve alt yolu tek bir yolda 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 kullanır Join-Path .

Komut sağlayıcıdan FileSystem yürütülürken yolları birleştirmek için 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 ve arasında Path yalnızca bir ayırıcı vardır ChildPath

Ö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, yolu ve alt yolu birleştirerek C:\Win\* başvuruda bulunan dosya ve System\* klasörleri görüntüler. ile aynı dosya ve klasörleri Get-ChildItemgö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, içeren ControlSetkayıt defteri alt anahtarında HKLM\System 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ışırHKLM:\

Örnek 5: Birden çok yol köklerini alt yol 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 bir alt yol ile birleştirmek için kullanır Join-Path .

Not

tarafından Path belirtilen Sürücülerin mevcut olması gerekir, aksi takdirde bu girdinin birleşimi başarısız olur.

Örnek 6: Dosya sistemi sürücüsünün köklerini alt yol ile 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 alt yol ile Subdir birleştirir.

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

Çıktı, bilgisayardaki PowerShell sürücülerinin dizine eşlenmiş bir sürücü içerdiğini C:\Program Files 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

parametresi sınırsız AdditionalChildPath sayıda yolun birleştirilmesine izin verir.

Bu örnekte parametre adı kullanılmaz, bu nedenle "a" için , "b" yerine ChildPath ve "c-g" öğesine bağlanır PathAdditionalChildPath

Parametreler

-AdditionalChildPath

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

Bu parametre, süresiz sayıda yolu birleştirmeyi sağlayan özelliğiyle ValueFromRemainingArguments belirtilir.

Bu parametre PowerShell 6.0'a eklendi.

Type:String[]
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ChildPath

parametresinin değerine Path eklenecek öğeleri belirtir. Joker karakterlere izin verilir. ChildPath Parametre adı ("ChildPath") isteğe bağlı olsa da parametresi gereklidir.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Credential

Not

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-Command kullanın.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

değeri Path , hangi sağlayıcının yolları birleştirdiğini belirler ve yol sınırlayıcılarını ekler. Path Parametre adı ("Yol") isteğe bağlı olsa da parametre gereklidir.

Type:String[]
Aliases:PSPath
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-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, yol yoksa cmdlet hata alır.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

String

Bu cmdlet'in yolunu içeren bir dizeyi kanala 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ı , , Normpath, Realpath, Joinveya diğer yol manipülatörleri gibi kullanınDirname.

Yol cmdlet'lerini , Registryve Certificate sağlayıcıları dahil olmak üzere FileSystemç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 yazın Get-PSProvider. Daha fazla bilgi için bkz . about_Providers.