パラメーター入力を検証する

PowerShell では、コマンドレット パラメーターに渡される引数をいくつかの方法で検証できます。 PowerShell では、引数の文字の長さ、範囲、およびパターンを検証できます。 使用可能な引数の数 (カウント) を検証できます。 これらの検証規則は、コマンドレット クラスのパブリック プロパティの Parameter 属性で宣言された検証属性によって定義されます。

パラメーター引数を検証するために、PowerShell ランタイムは検証属性によって提供される情報を使用して、コマンドレットを実行する前にパラメーターの値を確認します。 パラメーターの入力が無効な場合、ユーザーはエラー メッセージを受け取ります。 各検証パラメーターは、PowerShell によって適用される検証規則を定義します。

PowerShell では、次の属性に基づいて検証規則が適用されます。

ValidateCount

パラメーターが受け入れ可能な引数の最小数と最大数を指定します。 詳細については 、「ValidateCount 属性宣言」を参照してください。

ValidateLength

パラメーター引数の最小文字数と最大文字数を指定します。 詳細については 、「ValidateLength 属性宣言」を参照してください。

ValidatePattern

パラメーター引数を検証する正規表現を指定します。 詳細については 、「ValidatePattern 属性宣言」を参照してください。

ValidateRange

パラメーター引数の最小値と最大値を指定します。 詳細については 、「ValidateRange 属性宣言」を参照してください。

ValidateScript

パラメーター引数の有効な値を指定します。 詳細については 、「ValidateScript 属性宣言」を参照してください。

ValidateSet

パラメーター引数の有効な値を指定します。 詳細については 、「ValidateSet 属性宣言」を参照してください。

参照

パラメーター入力を検証する方法

Windows PowerShell コマンドレットの記述