Parametre Takma Adları

Cmdlet parametrelerinin takma adları da olabilir. Bir komutta parametreyi yazarken veya belirtirken parametre adları yerine takma adları kullanabilirsiniz.

Takma Ad Kullanmanın Yararları

Parametrelere takma adlar eklemek aşağıdaki faydaları sağlar.

  • Kullanıcının cmdlet çağrıldığında parametre adının tamamını kullanmasına gerek kalmaması için bir kısayol sağlayabilirsiniz. Örneğin, "BilgisayarAdı" parametre adı yerine "CN" takma adını kullanabilirsiniz.

  • Aynı parametre için farklı adlar vermek istiyorsanız birden fazla takma ad tanımlayabilirsiniz. Aynı verilere farklı şekillerde başvuran birden çok kullanıcı grubuyla çalışmanız gerekiyorsa birden çok takma ad tanımlamak isteyebilirsiniz.

  • Bir parametrenin adının değişmesi durumunda mevcut komut dosyaları için geriye dönük uyumluluk sağlayabilirsiniz.

  • Alias özniteliğini ValueFromPipelineByName özniteliğiyle birlikte kullanarak, cmdlet'inizin farklı nesne türlerine bağlanmasına olanak tanıyan bir parametre tanımlayabilirsiniz. Örneğin, farklı türde iki nesneniz olduğunu ve ilk nesnenin bir yazar özelliğine, ikinci nesnenin ise bir editör özelliğine sahip olduğunu varsayalım. Cmdlet'iniz yazar ve düzenleyici takma adlarına sahip bir parametreye sahipse ve cmdlet, özellik adlarına dayalı olarak boru hattı girişini kabul ediyorsa, cmdlet'iniz iki parametre takma adını kullanarak her iki nesneye de bağlanabilir.

Belirli parametrelerle kullanılabilecek takma adlar hakkında daha fazla bilgi için bkz. Ortak Parametre Adları.

Parametre Takma Adlarını Tanımlama

Bir parametreye takma ad tanımlamak için aşağıdaki parametre bildiriminde gösterildiği gibi Alias niteliğini bildirin. Bu örnekte aynı parametre için birden fazla takma ad tanımlanmıştır. (Daha fazla bilgi için bkz. Cmdlet Parametreleri Nasıl Bildirilir.)

[Alias("UN","Writer","Editor")]
[Parameter()]
public string UserName
{
  get { return userName; }
  set { userName = value; }
}
private string userName;

Ayrıca Bakınız

Ortak Parametre Adları

Cmdlet Parametreleri Nasıl Bildirilir

Windows PowerShell Cmdlet'i Yazma

İlgili makaleler