CAB ファイルを作成してアップロードする方法

このトピックでは、更新可能なヘルプ CAB ファイルを作成し、それらを更新可能なヘルプ コマンドレットが検索できる場所にアップロードする方法について説明します。

更新可能なヘルプ CAB ファイルアップロード作成および更新する方法

更新可能なヘルプ機能を使用すると、複数の言語とカルチャでモジュールの新しいヘルプ ファイルまたは更新されたヘルプ ファイルを配信できます。 モジュールの更新可能なヘルプ パッケージは、1 つの HelpInfo XML ファイルと 1 つ以上のキャビネット ( ) ファイルで .CAB 構成されます。 各 CAB ファイルには、1 つの UI カルチャ内のモジュールのヘルプ ファイルが含まれている。 更新可能なヘルプ用の CAB ファイルを作成するには、次の手順に従います。

  1. UI カルチャ別にモジュールのヘルプ ファイルを整理します。 更新可能な各ヘルプ CAB ファイルには、1 つの UI カルチャ内の 1 つのモジュールのヘルプ ファイルが含まれている。 モジュールに対して複数のヘルプ CAB ファイルを提供し、それぞれ異なる UI カルチャに対して配信できます。

  2. ヘルプ ファイルに、更新可能なヘルプに許可されているファイルの種類だけが含まれるか確認し、ヘルプ ファイル スキーマに対してそれらを検証します。 コマンドレットで無効なファイルまたは許可された種類ではないファイルが検出された場合、無効なファイルはインストールされません。CAB からのファイルのインストール Update-Help は停止されます。 許可されるファイルの種類の一覧については、「更新可能なヘルプ CAB ファイルで許可されるファイル の種類」を参照してください

  3. ヘルプ ファイルにデジタル署名します。 デジタル署名は必要ありませんが、ベスト プラクティスです。

  4. モジュールのすべてのヘルプ ファイルを、新しいファイルや変更されたファイルだけでなく、UI カルチャに含めます。 CAB ファイルが不完全な場合、初めてヘルプ ファイルをダウンロードするユーザー、またはすべての更新プログラムをダウンロードしないユーザーは、すべてのモジュール ヘルプ ファイルを持つとは言えないことです。

  5. などのキャビネット ファイルを作成するユーティリティを使用します MakeCab.exe 。 PowerShell には、CAB ファイルを作成するコマンドレットは含まれます。

  6. CAB ファイルに名前を付ける。 詳細については、「更新可能な ヘルプ CAB ファイルに名前を付ける方法」を参照してください

  7. アップロードの CAB ファイルを、モジュールの HelpInfo XML ファイルの HelpContentUri 要素で指定された場所に格納します。 次に、HelpInfo XML ファイルを、モジュール マニフェストの HelpInfoUri キーで指定された場所にアップロードします。 HelpContentUri と HelpInfoUri は、同じ場所を指す場合があります。

注意事項

HelpInfoUri キーと HelpContentUri 要素の値は、 または で始まる必要 http があります https 。 値はインターネットの場所を示す必要があります。また、ファイル名を含めずに指定する必要があります。