Búsqueda de sitios web

Cómo declarar conjuntos de parámetros

Este ejemplo 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 utilizan 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, consulte Conjuntos de parámetros de cmdlet.

es importante

Siempre que sea posible, defina el parámetro único de un conjunto de parámetros como parámetro obligatorio. Sin embargo, si desea que su 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 cmdlet Get-Command es opcional.

Cómo definir dos conjuntos de parámetros

  1. Agregue la palabra clave ParameterSet 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 palabra clave ParameterSet 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 de parámetro para cada conjunto de parámetros y luego agregue la palabra clave ParameterSet a cada conjunto. En cada atributo de parámetro, 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;

Ver también

Conjuntos de parámetros de cmdlet

Escribir un cmdlet de Windows PowerShell

Artículos relacionados