Bagikan melalui


Join-Path

Menggabungkan jalur utama dan jalur anak menjadi satu jalur.

Sintaks

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

Deskripsi

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

Contoh

Contoh 1: Menggabungkan jalur dengan jalur anak

Join-Path -Path "path" -ChildPath "childpath"

path\childpath

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

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

Contoh 2: Menggabungkan jalur yang sudah berisi pemisah direktori

Join-Path -Path "path\" -ChildPath "\childpath"

path\childpath

Pemisah direktori yang ada \ 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 menggabungkan jalur C:\Win\* dan jalur turunan System\*. Program ini menampilkan file dan folder yang sama dengan Get-ChildItem, tetapi menampilkan jalur lengkap untuk setiap item. Dalam perintah ini, nama parameter opsional Path 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 subkunci registri HKLM\System yang menyertakan ControlSet.

Parameter Resolve mencoba mengatasi jalur yang digabungkan, termasuk wildcard 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.

Nota

Drive yang ditentukan oleh Path harus ada, jika tidak, 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 direktori root setiap drive sistem file PowerShell di konsol dengan jalur subdirektori Subdir.

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

Output menunjukkan bahwa drive PowerShell di 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 Path, "b" ke ChildPath dan "c-g" untuk AdditionalChildPath

Parameter

-AdditionalChildPath

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

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

Parameter ini ditambahkan di PowerShell 6.0.

Jenis:String[]
Position:2
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ChildPath

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

Jenis:String
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:True

-Credential

Nota

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.

Jenis:PSCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Path

Menentukan jalur utama (atau jalur-jalur) ke mana jalur anak digabungkan. Karakter pengganti diizinkan.

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

Jenis:String[]
Alias:PSPath
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:True

-Resolve

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

  • Jika wildcard digunakan, cmdlet akan mengembalikan semua jalur yang sesuai dengan jalur yang digabungkan.
  • Jika tidak ada wildcard yang digunakan, cmdlet akan memunculkan kesalahan jika jalur tidak ada.
Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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 untuk jalur dengan beberapa penyedia, termasuk penyedia FileSystem, Registry, dan Certificate.

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