Validating Parameter Input (Validar a Entrada de Parâmetros)

  • Artigo

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

Para validar um argumento de parâmetro, o tempo de execução powerShell utiliza as informações fornecidas pelos atributos de validação para confirmar o valor do parâmetro antes da execução do cmdlet. Se a entrada do parâmetro não for válida, o utilizador recebe uma mensagem de erro. Cada parâmetro de validação define uma regra de validação que é aplicada pela PowerShell.

A PowerShell aplica as regras de validação com base nos seguintes atributos.

Validar o Contador

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

ValidarLength

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

ValidarPattern

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

ValidarRange

Especifica os valores mínimos e máximos do argumento do parâmetro. Para mais informações, consulte a Declaração de Atributo ValidateRange.

ValidarScript

Especifica os valores válidos para o argumento do parâmetro. Para obter mais informações, consulte a Declaração de Atributos ValidateScript.

Validar Conjunto

Especifica os valores válidos para o argumento do parâmetro. Para obter mais informações, consulte a Declaração de Atributos ValidateSet.

Consulte também

How to Validate Parameter Input (Como Validar Entradas de Parâmetros)

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