Join-Path

  • Referensi
Modul:
Microsoft.PowerShell.Management

Menggabungkan jalur dan jalur anak ke dalam satu jalur.

Sintaks

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

Deskripsi

Join-Path Cmdlet menggabungkan jalur dan jalur turunan 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. jalurnya.

Contoh 2: Menggabungkan jalur yang sudah berisi pemisah direktori

PS C:\> 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 C:\Win\* jalur dan System\* jalur anak. 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 gabungan, 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 Subdir jalur anak.

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

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

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.

Parameter ini ditambahkan di PowerShell 6.0.

Type:String[]
Position:2
Default value:None
Required:False
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
Required:True
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
Required:False
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 pemisah jalur. Parameter Path diperlukan, meskipun nama parameter ("Jalur") bersifat opsional.

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

-Resolve

Menunjukkan bahwa cmdlet ini harus mencoba menyelesaikan jalur gabungan 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
Required:False
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, , NormpathRealpath, 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.