Join-Path

Menggabungkan jalur dan jalur anak ke dalam satu jalur.

Sintaks

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

Deskripsi

Cmdlet Join-Path menggabungkan jalur dan jalur anak ke dalam satu jalur. Penyedia menyediakan pemisah jalur.

Contoh

Contoh 1: Menggabungkan jalur dengan jalur anak

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

path\childpath

Perintah ini menggunakan Join-Path untuk menggabungkan jalur dengan childpath.

Karena perintah dijalankan dari FileSystem penyedia, perintah menyediakan pemisah \ untuk bergabung dengan jalur.

Contoh 2: Menggabungkan jalur yang sudah berisi pemisah direktori

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

path\childpath

Pemisah \ direktori yang ada dan ditangani sehingga hanya ada satu pemisah antara Path dan ChildPath

Contoh 3: Menampilkan file dan folder dengan menggabungkan jalur dengan jalur anak

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

Perintah ini menampilkan file dan folder yang dirujuk dengan bergabung dengan jalur C:\Win* dan jalur anak Sistem*. Ini menampilkan file dan folder yang sama dengan Get-ChildItem, tetapi menampilkan jalur yang sepenuhnya memenuhi syarat untuk setiap item. Dalam perintah ini, Path nama parameter opsional dan ChildPath dihilangkan.

Contoh 4: Gunakan Join-Path dengan penyedia registri PowerShell

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

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

Perintah ini menampilkan kunci registri di HKLM\System subkunci registri yang menyertakan ControlSet.

Parameter Resolve , mencoba menyelesaikan jalur yang digabungkan, termasuk kartubebas dari jalur penyedia saat ini HKLM:\

Contoh 5: Menggabungkan beberapa akar jalur dengan jalur anak

Join-Path -Path C:, D:, E:, F: -ChildPath New

C:\New
D:\New
E:\New
F:\New

Perintah ini menggunakan Join-Path untuk menggabungkan beberapa akar jalur dengan jalur anak.

Catatan

Drive yang ditentukan oleh Path harus ada atau gabungan entri tersebut akan gagal.

Contoh 6: Menggabungkan akar drive sistem file dengan jalur anak

Get-PSDrive -PSProvider filesystem | ForEach-Object {$_.root} | Join-Path -ChildPath "Subdir"

C:\Subdir
D:\Subdir

Perintah ini menggabungkan akar setiap drive sistem file PowerShell di konsol dengan jalur anak Subdir.

Perintah menggunakan Get-PSDrive cmdlet untuk mendapatkan drive PowerShell yang didukung oleh penyedia FileSystem. Pernyataan ForEach-Object hanya memilih properti Akar objek PSDriveInfo dan menggabungkannya dengan jalur anak yang ditentukan.

Output menunjukkan bahwa drive PowerShell pada komputer menyertakan drive yang dipetakan ke direktori C:\Program Files.

Contoh 7: Menggabungkan jumlah jalur yang tidak terbatas

Join-Path a b c d e f g

a\b\c\d\e\f\g

Parameter AdditionalChildPath memungkinkan bergabungnya sejumlah jalur yang tidak terbatas.

Dalam contoh ini, tidak ada nama parameter yang digunakan, sehingga "a" mengikat ke Path, "b" ke ChildPath dan "c-g" ke AdditionalChildPath

Parameter

-AdditionalChildPath

Menentukan elemen tambahan untuk ditambahkan ke nilai parameter Jalur . Parameter ChildPath masih wajib dan harus ditentukan juga.

Parameter ini ditentukan dengan ValueFromRemainingArguments properti yang memungkinkan bergabung dengan jumlah jalur yang tidak terbatas.

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

-ChildPath

Menentukan elemen yang akan ditambahkan ke nilai Path parameter. Kartubebas diizinkan. Parameter ChildPath diperlukan, meskipun nama parameter ("ChildPath") bersifat opsional.

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

-Credential

Catatan

Parameter ini tidak didukung oleh penyedia apa pun yang diinstal dengan PowerShell. Untuk meniru pengguna lain, atau meningkatkan kredensial Anda saat menjalankan cmdlet ini, gunakan Invoke-Command.

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

-Path

Menentukan jalur utama (atau jalur) tempat jalur anak ditambahkan. Kartubebas diizinkan.

Nilai Path menentukan penyedia mana yang bergabung dengan jalur dan menambahkan pembatas jalur. Parameter Path diperlukan, meskipun nama parameter ("Jalur") bersifat opsional.

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

-Resolve

Menunjukkan bahwa cmdlet ini harus mencoba menyelesaikan jalur yang digabungkan dari penyedia saat ini.

  • Jika kartubebas digunakan, cmdlet mengembalikan semua jalur yang cocok dengan jalur yang digabungkan.
  • Jika tidak ada kartubebas yang digunakan, cmdlet akan mengalami kesalahan jika jalur tidak ada.
Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Input

String

Anda dapat menyalurkan string yang berisi jalur ke cmdlet ini.

Output

String

Cmdlet ini mengembalikan string yang berisi jalur yang dihasilkan.

Catatan

Cmdlet yang berisi kata benda Jalur (cmdlet Jalur) memanipulasi nama jalur dan mengembalikan nama dalam format ringkas yang dapat ditafsirkan oleh semua penyedia PowerShell. Mereka dirancang untuk digunakan dalam program dan skrip di mana Anda ingin menampilkan semua atau sebagian dari nama jalur dalam format tertentu. Gunakan seperti Anda akan menggunakan Dirname, Normpath, Realpath, Join, atau manipulator jalur lainnya.

Anda dapat menggunakan cmdlet jalur dengan beberapa penyedia, termasuk FileSystempenyedia , Registry, dan Certificate .

Cmdlet ini dirancang untuk bekerja dengan data yang diekspos oleh penyedia mana pun. Untuk mencantumkan penyedia yang tersedia di sesi Anda, ketik Get-PSProvider. Untuk informasi selengkapnya, lihat about_Providers.