Cómo declarar los conjuntos de parámetros

En este ejemplo se muestra cómo definir dos conjuntos de parámetros al declarar los parámetros de un cmdlet. Cada conjunto de parámetros tiene un parámetro único y un parámetro compartido que usan ambos conjuntos de parámetros. Para obtener más información sobre los conjuntos de parámetros, incluido cómo especificar el conjunto de parámetros predeterminado, vea Cmdlet Parameter Sets.

Importante

Siempre que sea posible, defina el parámetro único de un conjunto de parámetros como un parámetro necesario. Sin embargo, si desea que el cmdlet se ejecute sin especificar ningún parámetro, el parámetro único puede ser un parámetro opcional. Por ejemplo, el parámetro único del Get-Command cmdlet es opcional.

Definición de dos conjuntos de parámetros

1. Agregue la ParameterSet palabra clave al atributo Parameter para el parámetro único del primer conjunto de parámetros.

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

2. Agregue la ParameterSet palabra clave al atributo Parameter para el parámetro único del segundo conjunto de parámetros.

   [Parameter(Position = 0, Mandatory = true,
              ParameterSetName = "Test02")]
   public string ComputerName
   {
     get { return computerName; }
     set { computerName = value; }
   }
   private string computerName;
   

3. Para el parámetro que pertenece a ambos conjuntos de parámetros, agregue un atributo Parameter para cada conjunto de parámetros y, a continuación, agregue la ParameterSet palabra clave a cada conjunto. En cada atributo Parameter, puede especificar cómo se define ese parámetro. Un parámetro puede ser opcional en un conjunto y obligatorio en otro.

   [Parameter(Mandatory= true, ParameterSetName = "Test01")]
   [Parameter(ParameterSetName = "Test02")]
   public string SharedParam
   {
       get { return sharedParam; }
       set { sharedParam = value; }
   }
   private string sharedParam;
   

Consulte también

Conjuntos de parámetros del cmdlet

Escribir un cmdlet de Windows PowerShell