Özellikleri Parametre Olarak Bildirme

Bu konu, bir cmdlet'in parametrelerini bildirmeden önce anlamanız gereken temel bilgileri sağlar.

Cmdlet sınıfınız içindeki bir cmdlet'in parametrelerini bildirmek için, her parametreyi temsil eden ortak özellikleri tanımlayın ve ardından her özelliğe bir veya daha fazla Parametre niteliği ekleyin. Windows PowerShell çalışma zamanı, özelliği bir cmdlet parametresi olarak tanımlamak için Parametre özniteliklerini kullanır. Parametre niteliğini bildirmenin temel sözdizimi [Parameter()] şeklindedir.

Burada gerekli parametre olarak tanımlanan bir özelliğin örneği verilmiştir.

[Parameter(Position = 0, Mandatory = true)]
public string UserName
{
  get { return userName; }
  set { userName = value; }
}
private string userName;

Parametreler hakkında hatırlamanız gereken bazı şeyler var.

  • Bir parametre açıkça genel olarak işaretlenmelidir. Genel varsayılan olarak dahili olarak işaretlenmeyen ve Windows PowerShell çalışma zamanı tarafından bulunmayacak parametreler.

  • Daha iyi parametre doğrulaması sağlamak için parametreler Microsoft .NET Framework türleri olarak tanımlanmalıdır. Örneğin, bir değer kümesinden bir değerle sınırlandırılan parametreler, numaralandırma türü olarak tanımlanmalıdır. Tekdüzen Kaynak Tanımlayıcısı (URI) değeri alan parametreler System.Uri türünde olmalıdır.

  • Serbest biçimli metin özellikleri dışındaki tüm özellikler için temel dize parametrelerinden kaçının.

  • İstediğiniz sayıda parametre setine bir parametre ekleyebilirsiniz. Parametre kümeleri hakkında daha fazla bilgi için bkz. Cmdlet Parametre Kümeleri.

Windows PowerShell ayrıca her cmdlet'in otomatik olarak kullanabileceği bir dizi ortak parametre sağlar. Bu parametreler ve takma adları hakkında daha fazla bilgi için bkz. Cmdlet Ortak Parametreleri.

Ayrıca Bakınız

Cmdlet Ortak Parametreleri

Cmdlet Parametresi Türleri

Windows PowerShell Cmdlet'i Yazma

İlgili makaleler