tentang_Pemautan_Paramater

Deskripsi singkat

Pengikatan parameter adalah proses yang digunakan PowerShell untuk menentukan kumpulan parameter mana yang digunakan dan untuk mengaitkan nilai (mengikat) ke parameter perintah. Nilai-nilai ini dapat berasal dari baris perintah dan alur.

Deskripsi panjang

Proses pengikatan parameter dimulai dengan mengikat argumen baris perintah.

1. Mengikat parameter bernama

   Temukan token yang tidak dikutip pada baris perintah yang dimulai dengan tanda hubung. Jika token berakhir dengan titik dua, maka diperlukan argumen. Jika tidak ada titik dua, lihat jenis parameter dan lihat apakah argumen diperlukan. Jika nilai diperlukan, coba konversi jenis argumen ke jenis yang diperlukan oleh parameter, dan konversi berhasil, ikat parameter.

2. Mengikat parameter posisi

   Jika ada argumen baris perintah yang tidak digunakan, cari parameter tidak terikat yang mengambil parameter posisi dan coba ikat.

Setelah mengikat argumen baris perintah, PowerShell lalu mencoba mengikat input dari pipeline. Ada dua cara agar nilai terikat dari alur. Parameter yang menerima input alur memiliki satu atau kedua atribut berikut:

• ValueFromPipeline - Nilai dari alur terikat ke parameter berdasarkan jenisnya. Jenis argumen harus cocok dengan jenis parameter.
• ValueFromPipelineByPropertyName - Nilai dari alur terikat ke parameter berdasarkan namanya. Objek dalam alur harus memiliki properti yang cocok dengan nama parameter atau salah satu aliasnya. Jenis properti harus cocok atau dapat dikonversi ke jenis parameter.

PowerShell mencoba mengikat input alur dalam urutan berikut:

1. Cobalah untuk mengikat parameter ValueFromPipeline tanpa konversi jenis:

   Ikat dari alur menurut nilai dengan kecocokan jenis yang tepat. Jika perintah memiliki input alur dan masih ada parameter yang tidak terikat, coba ikat ke parameter yang cocok dengan jenis dengan tepat.

2. Cobalah untuk mengikat parameter ValueFromPipelineByPropertyName tanpa konversi jenis:

   Jika tidak ada kecocokan nilai yang ditemukan, maka ikat dari alur berdasarkan nama dengan kecocokan yang tepat. Cari properti pada objek input yang cocok dengan nama parameter atau salah satu aliasnya. Jika jenisnya sama persis, ikat parameter .

3. Jika input alur belum terikat, coba ikat parameter ValueFromPipeline dengan konversi jenis:

   Cobalah mengonversi input jalur pemrosesan ke tipe yang diperlukan. Jika konversi gagal, parameter tidak terikat.

4. Jika input alur belum terikat, coba ikat parameter ValueFromPipelineByPropertyName dengan konversi jenis:

   Nama properti harus cocok dengan nama parameter atau salah satu aliasnya. Jika jenis input tidak cocok, coba konversi input ke jenis yang cocok. Jika konversi gagal, parameter tidak terikat.

Memvisualisasikan pengikatan parameter

Pemecahan masalah pengikatan parameter bisa menjadi tantangan. Anda dapat menggunakan cmdlet Trace-Command untuk memvisualisasikan proses pengikatan parameter. Contoh berikut menunjukkan cara melacak pengikatan parameter untuk alur sederhana.

Trace-Command -PSHost -Name ParameterBinding -Expression {
    Get-Item *.txt | Remove-Item
}

Output menunjukkan setiap langkah dari proses pengikatan parameter untuk perintah-perintah dalam Ekspresi . Outputnya bisa verbose, tetapi dapat membantu Anda memahami mengapa parameter tidak terikat seperti yang diharapkan. Untuk contoh lengkapnya, lihat artikel Visualisasi pengikatan parameter.