Compartilhar via


Declaração de atributo ValidateSet

O atributo ValidateSetAttribute especifica um conjunto de valores possíveis para um argumento de parâmetro cmdlet. Esse atributo também pode ser usado por funções do Windows PowerShell.

Quando esse atributo é especificado, o runtime do Windows PowerShell determina se o argumento fornecido para o parâmetro cmdlet corresponde a um elemento no conjunto de elementos fornecido. O cmdlet será executado somente se o argumento de parâmetro corresponder a um elemento no conjunto. Se nenhuma correspondência for encontrada, um erro será gerado pelo runtime do Windows PowerShell.

Sintaxe

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

Parâmetros

ValidValues (System.String) Obrigatório. Especifica os valores de elemento de parâmetro válidos. O exemplo a seguir mostra como especificar um elemento ou vários elementos.

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

IgnoreCase (System.Boolean) Parâmetro nomeado opcional. O valor padrão de true indica que o caso é ignorado. Um valor de false diferencia maiúsculas de minúsculas do cmdlet.

Observações

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

  • Se o valor do parâmetro for uma matriz, cada elemento da matriz deverá corresponder a um elemento do conjunto de atributos.

  • O atributo ValidateSetAttribute é definido pela classe System.Management.Automation.ValidateSetAttribute.

Consulte Também

System.Management.Automation.ValidateSetAttribute

gravando um cmdlet do Windows PowerShell