このトピックでは、更新可能なヘルプ情報ファイル (一般に "HelpInfo XML ファイル" と呼ばれる) でバージョン番号を設定および増やす方法について説明します。
HelpInfo XML バージョン番号を設定する方法
HelpInfo XML ファイルのバージョン番号は、更新可能なヘルプの操作に不可欠です。 Update-HelpコマンドレットとSave-Helpコマンドレットは、リモート HelpInfo XML ファイル内の UI カルチャのバージョン番号がローカルの HelpInfo XML の UI カルチャのバージョン番号より大きい場合、またはローカルの HelpInfo XML ファイルがない場合にのみ、新しいヘルプ ファイルをダウンロードします。
HelpInfo XML ファイルでは、Microsoft .NET Framework の System.Version クラスで定義されている 4 部構成のバージョン番号が使用されます。 形式は N1.N2.N3.N4 です。 モジュール作成者は 、System.Version クラスで許可されている任意のバージョン番号付けスキームを使用できます。 更新可能ヘルプでは、その UI カルチャの CAB ファイルの新しいバージョンが HelpInfo XML ファイルの HelpContentURI 要素で指定された場所にアップロードされた場合にのみ、UI カルチャのバージョン番号が増える必要があります。
次の例は、バージョンが 2.15.0.10 の場合のドイツ語 (de-DE) UI カルチャの HelpInfo XML ファイルの要素を示しています。
<UICulture>
<UICultureName>de-DE</UICultureName>
<UICultureVersion>2.15.0.10</UICultureVersion>
</UICulture>
UI カルチャのバージョン番号には、その UI カルチャの CAB ファイルのバージョンが反映されます。 バージョン番号は CAB ファイル全体に適用されます。 CAB ファイル内のファイルごとに異なるバージョン番号を設定することはできません。 各 UI カルチャのバージョン番号は個別に評価され、モジュールがサポートする他の UI カルチャのバージョン番号に関連付けは必要ではありません。