UseApprovedVerbs

重症度レベル:警告

デフォルト状態:常に有効

Description

このルールは、名前に未承認の動詞を使用しているコマンドレットを検出します。 すべてのコマンドレットは承認された動詞を使用しなければなりません。 承認された動詞は Get-Verb コマンドを実行することで見つけられます。 コマンドレットが未承認動詞を使っている場合は、承認された代替動詞に変更してください。

一部の未承認動詞は、承認動詞ページに推奨される代替動詞とともに記録されています。 使っている動詞を検索して、その承認された形を探してみてください。 例えば、 Read、 Open、 Search は Getに置き換えるべきです。

詳細については、「 PowerShellコマンドの承認動詞」をご覧ください。

例

非準拠

function Change-Item {
    ...
}

対応

function Update-Item {
    ...
}

ルールの設定

このルールは常に有効で、設定はできません。 このルールを避けるために、以下のいずれかの方法を用いてください。

  • 欲しいルールだけを含めるか、不要なルールを除外するカスタムルール設定ファイルを作成しましょう。
  • 特定のコードブロックに対してルール抑制を抑制するために、適切なルール抑制属性をコードに追加してください。 詳細については、PSScriptAnalyzerの使用に関する「抑制ルール」セクションをご覧ください。