AvoidNullOrEmptyHelpMessageAttribute

重症度レベル:警告

Description

このルールは、null 値、空文字列、または値割り当てがない HelpMessage 属性を検出します。 HelpMessage属性は意味のある空でない文字列値を含む必要があります。 この値を完全に省略すると、構文解析時の構文エラーが生じます。

空の文字列やnull値を使うと、PowerShellは実行時にエラーを発生させます。 パラメータの目的とユーザーに期待される入力を説明した説明的なヘルプメッセージを必ず提供してください。

例

非準拠

Function BadFuncEmptyHelpMessageEmpty
{
    Param(
        [Parameter(HelpMessage='')]
        [String]
        $Param
    )

    $Param
}

Function BadFuncEmptyHelpMessageNull
{
    Param(
        [Parameter(HelpMessage=$null)]
        [String]
        $Param
    )

    $Param
}

Function BadFuncEmptyHelpMessageNoAssignment
{
    Param(
        [Parameter(HelpMessage)]
        [String]
        $Param
    )

    $Param
}

対応

Function GoodFuncHelpMessage
{
    Param(
        [Parameter(HelpMessage='This is helpful')]
        [String]
        $Param
    )

    $Param
}