Compartir a través de


Declaración de atributo ValidatePattern

El atributo ValidatePattern especifica un patrón de expresión regular que valida el argumento de un parámetro de cmdlet. Las funciones de Windows PowerShell también pueden usar este atributo.

Cuando se invoca ValidatePattern dentro de un cmdlet, el tiempo de ejecución de Windows PowerShell convierte el argumento del parámetro de cmdlet en una cadena y, a continuación, compara esa cadena con el patrón proporcionado por el atributo ValidatePattern. El cmdlet solo se ejecuta si la representación de cadena convertida del argumento y la coincidencia de patrón proporcionada. Si no coinciden, el tiempo de ejecución de Windows PowerShell produce un error.

Sintaxis

[ValidatePattern(string regexString)]
[ValidatePattern(string regexString, Named Parameters)]

Parámetros

RegexString (System.String) Requerido. Especifica una expresión regular que valida el argumento de parámetro.

Options (System.Text.RegularExpressions.RegexOptions) Parámetro con nombre opcional. Especifica una combinación bit a bit de System.Text.RegularExpressions.RegexOptions marcas que especifican opciones de expresión regular.

Observaciones

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

  • Puede usar el parámetro Option del atributo para definir aún más el patrón. Por ejemplo, puede distinguir entre mayúsculas y minúsculas del patrón.

  • Si este atributo se aplica a una colección, cada elemento de la colección debe coincidir con el patrón.

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

Véase también

System.Management.Automation.ValidatePatternAttribute

escribir un cmdlet de Windows PowerShell