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
Anda dapat menyalurkan string yang berisi jalur ke cmdlet ini.
Output
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.