Cmdlet Parametrelerini Bildirme

Bu örnekler adlandırılmış, konumsal, gerekli, isteğe bağlı ve [switch] parametrelerin nasıl bildireceğini gösterir. Bu örneklerde parametre diğer adının nasıl tanımlanacağı da gösterilmektedir.

Adlandırılmış Parametre Bildirme

  • Aşağıdaki kodda gösterildiği gibi bir ortak özellik tanımlayın. Parameter özniteliğini eklediğinizde, özniteliğinden Position anahtar sözcüğünü atlarsınız.

    [Parameter()]
    public string UserName
    {
      get { return userName; }
      set { userName = value; }
    }
    private string userName;
    

Parameter özniteliği hakkında daha fazla bilgi için bkz. Parametre Özniteliği Bildirimi.

Konumsal Parametre Bildirme

  • Aşağıdaki kodda gösterildiği gibi bir ortak özellik tanımlayın. Parameter özniteliğini eklediğinizde, anahtar sözcüğünü bağımsız değişken konumuna ayarlayın Position . 0 değeri ilk konumu gösterir.

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

Parameter özniteliği hakkında daha fazla bilgi için bkz. Parametre Özniteliği Bildirimi.

Zorunlu Parametre Bildirme

  • Aşağıdaki kodda gösterildiği gibi bir ortak özellik tanımlayın. Parameter özniteliğini eklediğinizde anahtar sözcüğünü Mandatory olarak trueayarlayın.

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

Parameter özniteliği hakkında daha fazla bilgi için bkz. Parametre Özniteliği Bildirimi.

İsteğe Bağlı Parametre Bildirme

  • Aşağıdaki kodda gösterildiği gibi bir ortak özellik tanımlayın. Parameter özniteliğini eklediğinizde anahtar sözcüğünü atlarsınız Mandatory .

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

Parametre bildirme [switch]

  • Bir ortak özelliği System.Management.Automation.SwitchParameter türü olarak tanımlayın ve parametre özniteliğini bildirin.

    [Parameter(Position = 1)]
    public SwitchParameter GoodBye
    {
      get { return goodbye; }
      set { goodbye = value; }
    }
    private bool goodbye;
    

Parameter özniteliği hakkında daha fazla bilgi için bkz. Parametre Özniteliği Bildirimi.

Diğer Adlarla Parametre Bildirme

  • Aşağıdaki kodda gösterildiği gibi bir ortak özellik tanımlayın. parametresinin diğer adlarını listeleyen bir Alias özniteliği ekleyin. Bu örnekte, aynı parametre için üç diğer ad tanımlanmıştır. İlk diğer ad bir kısayol sağlar. İkinci ve üçüncü diğer adlar, farklı senaryolar için kullanabileceğiniz adlar sağlar.

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

Diğer Ad özniteliği hakkında daha fazla bilgi için bkz. Diğer Ad Öznitelik Bildirimi.

Ayrıca Bkz.

System.Management.Automation.SwitchParameter

Parametre Öznitelik Bildirimi

Diğer Ad Öznitelik Bildirimi

Windows PowerShell Cmdlet'ini yazma