Compartilhar via


Declaração de atributo ValidatePattern

O atributo ValidatePattern especifica um padrão de expressão regular que valida o argumento de um parâmetro cmdlet. Esse atributo também pode ser usado por funções do Windows PowerShell.

Quando ValidatePattern é invocado dentro de um cmdlet, o runtime do Windows PowerShell converte o argumento do parâmetro cmdlet em uma cadeia de caracteres e compara essa cadeia de caracteres com o padrão fornecido pelo atributo ValidatePattern. O cmdlet será executado somente se a representação de cadeia de caracteres convertida do argumento e o padrão fornecido corresponderem. Se eles não corresponderem, um erro será gerado pelo runtime do Windows PowerShell.

Sintaxe

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

Parâmetros

RegexString (System.String) Obrigatório. Especifica uma expressão regular que valida o argumento de parâmetro.

Opções (System.Text.RegularExpressions.RegexOptions) Parâmetro nomeado opcional. Especifica uma combinação bit a bit de System.Text.RegularExpressions.RegexOptions sinalizadores que especificam opções de expressão regular.

Observações

  • Esse atributo pode ser usado apenas uma vez por parâmetro.

  • Você pode usar o parâmetro Option do atributo para definir ainda mais o padrão. Por exemplo, você pode diferenciar o padrão de maiúsculas e minúsculas.

  • Se esse atributo for aplicado a uma coleção, cada elemento da coleção deverá corresponder ao padrão.

  • O atributo ValidatePattern é definido pela classe System.Management.Automation.ValidatePatternAttribute.

Consulte Também

System.Management.Automation.ValidatePatternAttribute

gravando um cmdlet do Windows PowerShell