Compartilhar via

Declaração de atributo ValidateSet

  • Artigo

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 Windows PowerShell funções.

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

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 torna o cmdlet sensível a minúsculas.

Comentários

  • 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

Writing a Windows PowerShell Cmdlet (Escrevendo um Cmdlet do Windows PowerShell)