Compartir vía


Cómo declarar los parámetros del cmdlet

En estos ejemplos se muestra cómo declarar parámetros con nombre, posicionales, obligatorios, opcionales y modificadores. En estos ejemplos también se muestra cómo definir un alias de parámetro.

Cómo declarar un parámetro con nombre

  • Defina una propiedad pública como se muestra en el código siguiente. Al agregar el atributo Parameter, omita la Position palabra clave del atributo .

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

Para obtener más información sobre el atributo Parameter, vea Declaración de atributo de parámetro.

Cómo declarar un parámetro posicional

  • Defina una propiedad pública como se muestra en el código siguiente. Al agregar el atributo Parameter, establezca la palabra Position clave en la posición del argumento. Un valor de 0 indica la primera posición.

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

Para obtener más información sobre el atributo Parameter, vea Declaración de atributo de parámetro.

Cómo declarar un parámetro obligatorio

  • Defina una propiedad pública como se muestra en el código siguiente. Al agregar el atributo Parameter, establezca la Mandatory palabra clave en true .

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

Para obtener más información sobre el atributo Parameter, vea Declaración de atributo de parámetro.

Cómo declarar un parámetro opcional

  • Defina una propiedad pública como se muestra en el código siguiente. Al agregar el atributo Parameter, omita la palabra Mandatory clave .

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

Cómo declarar un parámetro Switch

  • Defina una propiedad pública como de tipo System.Management.Automation.SwitchParametery, a continuación, declare el atributo Parameter.

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

Para obtener más información sobre el atributo Parameter, vea Declaración de atributo de parámetro.

Cómo declarar un parámetro con alias

  • Defina una propiedad pública como se muestra en el código siguiente. Agregue un atributo Alias que enumera los alias del parámetro. En este ejemplo, se definen tres alias para el mismo parámetro. El primer alias proporciona un acceso directo. El segundo y el tercer alias proporcionan nombres que puede usar para distintos escenarios.

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

Para obtener más información sobre el atributo Alias, vea Declaración de atributo de alias.

Consulte también

System.Management.Automation.SwitchParameter

Declaración de atributo de parámetro

Declaración de atributo de alias

Escribir un cmdlet de Windows PowerShell