about_Parameter_Binding

Kısa açıklama

Parametre bağlama, PowerShell'in hangi parametre kümesinin kullanıldığını belirlemek ve değerleri komutun parametreleriyle ilişkilendirmek (bağlamak) için kullandığı işlemdir. Bu değerler komut satırından ve işlem hattından gelebilir.

Uzun açıklama

Parametre bağlama işlemi, komut satırı bağımsız değişkenlerini bağlayarak başlar.

1. Adlandırılmış parametreleri bağlama

   Kısa çizgiyle başlayan komut satırında sıralanmamış belirteçleri bulun. Belirteç iki nokta üst üste ile biterse bir bağımsız değişken gerekir. İki nokta üst üste yoksa parametrenin türüne bakın ve bir bağımsız değişkenin gerekli olup olmadığına bakın. Bir değer gerekiyorsa, bağımsız değişken türünü parametresinin gerektirdiği türe dönüştürmeyi denerseniz ve dönüştürme başarılı olursa parametreyi bağlayın.

2. Konumsal parametreleri bağlama

   Kullanılmayan komut satırı bağımsız değişkenleri varsa, konumsal parametreleri alıp bağlamaya çalışan ilişkisiz parametreleri arayın.

Komut satırı bağımsız değişkenlerini bağladıktan sonra PowerShell herhangi bir işlem hattı girişini bağlamaya çalışır. Değerlerin işlem hattından bağlanmasının iki yolu vardır. İşlem hattı girişini kabul eden parametreler aşağıdaki özniteliklerden birine veya her ikisine de sahiptir:

• ValueFromPipeline - İşlem hattındaki değer türüne göre parametreye bağlıdır. Bağımsız değişkenin türü parametrenin türüyle eşleşmelidir.
• ValueFromPipelineByPropertyName - İşlem hattındaki değer, adına göre parametresine bağlıdır. İşlem hattındaki nesne, parametrenin adıyla veya diğer adlarından biriyle eşleşen bir özelliğe sahip olmalıdır. Özelliğin türü parametresinin türüyle eşleşmeli veya dönüştürülebilir olmalıdır.

PowerShell, işlem hattı girişini aşağıdaki sırayla bağlamaya çalışır:

1. Tür dönüştürmesi olmadan ValueFromPipeline parametreleri bağlamayı deneyin:

   İşlem hattından tam tür eşleşmesi ile değere göre bağlama. Komutun işlem hattı girişi varsa ve hala ilişkisiz parametreler varsa, türüyle tam olarak eşleşen bir parametreye bağlanmayı deneyin.

2. Tür dönüştürmesi olmadan ValueFromPipelineByPropertyName parametreleri bağlamayı deneyin:

   Değer eşleşmesi bulunmazsa, işlem hattından tam eşleşme ile ada göre bağlayın. Giriş nesnesinde parametrenin adıyla veya diğer adlarından biriyle eşleşen bir özellik arayın. Türler tam olarak eşleşiyorsa parametresini bağlayın.

3. İşlem hattı girişi bağlanmadıysa, tür dönüştürme ile ValueFromPipeline parametreleri bağlamayı deneyin:

   İşlem hattı girişini gerekli türe dönüştürmeyi deneme. Dönüştürme başarısız olursa, parametre bağlı değildir.

4. İşlem hattı girişi bağlanmadıysa, tür dönüştürme ile ValueFromPipelineByPropertyName parametreleri bağlamayı deneyin:

   Özelliğin adı parametrenin adıyla veya diğer adlarından biriyle eşleşmelidir. Giriş türü eşleşmiyorsa, girişi eşleşen türe dönüştürmeyi deneme. Dönüştürme başarısız olursa, parametre bağlı değildir.

Parametre bağlamayı görselleştirme

Parametre bağlama sorunlarını gidermek zor olabilir. Parametre bağlama işlemini görselleştirmek için Trace-Command cmdlet'ini kullanabilirsiniz. Aşağıdaki örnekte, basit bir işlem hattı için parametre bağlamasını izleme işlemi gösterilmektedir.

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

Çıktı, İfadeiçindeki komutlar için parametre bağlama işleminin her adımını gösterir. Çıkış ayrıntılı olabilir, ancak bir parametrenin neden beklendiği gibi bağlanmadığını anlamanıza yardımcı olabilir. Tam bir örnek için parametre bağlamasını görselleştirme makalesine bakın.