UseToExportFieldsInManifest

重症度レベル:警告

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

説明

このルールは、エクスポートフィールドでモジュールマニフェストがワイルドカード('*')またはnull($null)を使用しているかを検出します。 モジュールの自動発見性能を向上させるために、モジュールマニフェストは以下の項目でワイルドカードやnullを使わないようにすべきです。

  • AliasesToExport
  • CmdletsToExport
  • FunctionsToExport
  • VariablesToExport

ワイルドカードやnullを使うと、PowerShellはオートディスカバリー中にモジュールの高価な解析を行います。 代わりに、エクスポートする項目の明示的なリストを使いましょう。 エクスポートするアイテムがない場合は、nullやワイルドカードの代わりに空の配列(@())を使いましょう。

Example

非準拠

FunctionsToExport = $null

対応

FunctionsToExport = @()

ルールの設定

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

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