Compartir a través de


Declaración de atributo ValidateSet

El atributo ValidateSetAttribute especifica un conjunto de valores posibles para un argumento de parámetro de cmdlet. Las funciones de Windows PowerShell también pueden usar este atributo.

Cuando se especifica este atributo, el entorno de ejecución de Windows PowerShell determina si el argumento proporcionado para el parámetro del cmdlet coincide con un elemento del conjunto de elementos proporcionado. El cmdlet solo se ejecuta si el argumento de parámetro coincide con un elemento del conjunto. Si no se encuentra ninguna coincidencia, el tiempo de ejecución de Windows PowerShell produce un error.

Sintaxis

[ValidateSetAttribute(params string[] validValues)]
[ValidateSetAttribute(params string[] validValues, Named Parameters)]

Parámetros

ValidValues (System.String) Requerido. Especifica los valores de elemento de parámetro válidos. En el ejemplo siguiente se muestra cómo especificar un elemento o varios elementos.

[ValidateSetAttribute("Steve")]
[ValidateSetAttribute("Steve","Mary")]

IgnoreCase (System.Boolean) Parámetro con nombre opcional. El valor predeterminado de true indica que se omite ese caso. Un valor de false hace que el cmdlet distingue mayúsculas de minúsculas.

Observaciones

  • Este atributo solo se puede usar una vez por parámetro.

  • Si el valor del parámetro es una matriz, cada elemento de la matriz debe coincidir con un elemento del conjunto de atributos.

  • El atributo ValidateSetAttribute se define mediante la clase System.Management.Automation.ValidateSetAttribute.

Véase también

System.Management.Automation.ValidateSetAttribute

escribir un cmdlet de Windows PowerShell