Validação de entrada de parâmetro

O PowerShell pode validar os argumentos passados para parâmetros de cmdlet de várias maneiras. O PowerShell pode validar o comprimento, o intervalo e o padrão dos caracteres do argumento. Ele pode validar o número de argumentos disponíveis (a contagem). Essas regras de validação são definidas por atributos de validação que são declarados com o atributo Parameter em propriedades públicas da classe de cmdlet.

Para validar um argumento de parâmetro, o runtime do PowerShell usa as informações fornecidas pelos atributos de validação para confirmar o valor do parâmetro antes que o cmdlet seja executado. Se a entrada do parâmetro não for válida, o usuário receberá uma mensagem de erro. Cada parâmetro de validação define uma regra de validação que é imposta pelo PowerShell.

O PowerShell impõe as regras de validação com base nos atributos a seguir.

ValidateCount

Especifica o número mínimo e máximo de argumentos que um parâmetro pode aceitar. Para obter mais informações, consulte Declaração de atributo ValidateCount.

ValidateLength

Especifica o número mínimo e máximo de caracteres no argumento de parâmetro. Para obter mais informações, consulte Declaração de atributo ValidateLength.

ValidatePattern

Especifica uma expressão regular que valida o argumento de parâmetro. Para obter mais informações, consulte ValidatePattern Attribute Declaration.

ValidateRange

Especifica os valores mínimo e máximo do argumento de parâmetro. Para obter mais informações, consulte ValidateRange Attribute Declaration.

ValidateScript

Especifica os valores válidos para o argumento de parâmetro. Para obter mais informações, consulte ValidateScript Attribute Declaration.

ValidateSet

Especifica os valores válidos para o argumento de parâmetro. Para obter mais informações, consulte ValidateSet Attribute Declaration.

Consulte Também

Como validar a entrada de parâmetro

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