ValidateSet Attribute Declaration (Declaração do Atributo ValidateSet)

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

Quando esse atributo é especificado, o tempo de execução 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 parameter corresponder a um elemento no conjunto. Se nenhuma correspondência for encontrada, um erro será gerado pelo tempo de execução do Windows PowerShell.

Sintaxe

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

Parâmetros

ValidValues (System.String) Obrigatório. Especifica os valores válidos do elemento de parâmetro. 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 maiúsculas e minúsculas é ignorada. Um valor de false torna o cmdlet sensível a maiúsculas e minúsculas.

Observações

• Este 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.

Ver também

System.Management.Automation.ValidateSetAttribute

Escrevendo um cmdlet do Windows PowerShell