このトピックでは、更新可能なヘルプが各モジュールの HelpInfo XML ファイルと CAB ファイルを処理し、ユーザーの更新されたヘルプをインストールする方法について説明します。
Update-Help プロセス
次の一覧では、ユーザーが特定の UI カルチャのモジュールのヘルプファイルを更新するコマンドを実行したとき の update-help コマンドレットの 動作について説明します。
Update-Helpモジュールマニフェストの Helpinfouri キーの値によって指定された場所からリモートの HelpInfo XML ファイルを取得し、スキーマに対してファイルを検証します。 (スキーマを表示するには、「 HELPINFO XML schema」を参照してください)。は、Update-Helpユーザーのコンピューターのモジュールディレクトリにあるモジュールのローカル HELPINFO XML ファイルを検索します。Update-Helpモジュールのリモートおよびローカルの HelpInfo XML ファイル内にある、指定した UI カルチャのヘルプファイルのバージョン番号を比較します。 リモートファイルのバージョン番号がローカルファイルのバージョン番号よりも大きい場合、またはモジュールのローカル HelpInfo XML ファイルがない場合は、によってUpdate-Help新しいヘルプファイルのダウンロードが準備されます。Update-Helpリモート HelpInfo XML ファイルの Helpcontenturi 要素によって指定された場所からモジュールの CAB ファイルを選択します。 モジュール名、モジュール GUID、および UI カルチャを使用して、CAB ファイルを識別します。Update-HelpCAB ファイルをダウンロードしてアンパックし、ヘルプコンテンツファイルを検証して、ヘルプコンテンツファイルをユーザーのコンピューターのモジュールディレクトリの言語固有のサブディレクトリに保存します。Update-Helpリモートの HelpInfo XML ファイルをコピーすることによって、ローカルの HelpInfo XML ファイルを作成します。 ローカルの HelpInfo XML ファイルを編集して、インストールした CAB ファイルの要素のみが含まれるようにします。 次に、ローカルの HelpInfo XML ファイルをモジュールディレクトリに保存し、更新を終了します。
Save-Help プロセス
次の一覧では、ユーザーがファイル共有内のヘルプファイルを更新するコマンドを実行し、そのファイルを使用してユーザーのコンピューター上のヘルプファイルを更新するときの、 help および update-help コマンドレットの動作について説明します。
Save-Helpコマンドレットは、 DestinationPath パラメーターで指定されたファイル共有内のモジュールのヘルプファイルを保存するコマンドに応答して、次の操作を実行します。
Save-Helpモジュールマニフェストの Helpinfouri キーの値によって指定された場所からリモートの HelpInfo XML ファイルを取得し、スキーマに対してファイルを検証します。 (スキーマを表示するには、「 HELPINFO XML schema」を参照してください)。は、Save-Helpコマンドで DestinationPath パラメーターで指定されたディレクトリでローカル HelpInfo XML ファイルを検索しSave-Helpます。Save-Helpモジュールのリモートおよびローカルの HelpInfo XML ファイル内にある、指定した UI カルチャのヘルプファイルのバージョン番号を比較します。 リモートファイルのバージョン番号がローカルファイルのバージョン番号よりも大きい場合、または DestinationPath ディレクトリにモジュール用のローカル HelpInfo XML ファイルがない場合は、によってSave-Help新しいヘルプファイルのダウンロードが準備されます。Save-Helpリモート HelpInfo XML ファイルの Helpcontenturi 要素によって指定された場所からモジュールの CAB ファイルを選択します。 モジュール名、モジュール GUID、および UI カルチャを使用して、CAB ファイルを識別します。Save-HelpCAB ファイルをダウンロードし、 DestinationPath ディレクトリに保存します。 (言語固有のサブディレクトリは作成されません)。Save-Helpリモートの HelpInfo XML ファイルをコピーすることによって、ローカルの HelpInfo XML ファイルを作成します。 ローカルの HelpInfo XML ファイルを編集して、保存された CAB ファイルの要素のみが含まれるようにします。 次に、ローカルの HelpInfo XML ファイルを DestinationPath ディレクトリに保存し、更新を終了します。Update-Helpコマンドレットは、 SourcePath パラメーターで指定されたファイル共有内のファイルからユーザーのコンピューター上のヘルプファイルを更新するコマンドに応答して、次の操作を実行します。Update-HelpSourcePath ディレクトリからリモートの HelpInfo XML ファイルを取得します。 次に、ユーザーのコンピューターのモジュールディレクトリでローカル HelpInfo XML ファイルを検索します。Update-Helpモジュールのリモートおよびローカルの HelpInfo XML ファイル内にある、指定した UI カルチャのヘルプファイルのバージョン番号を比較します。 リモートファイルのバージョン番号がローカルファイルのバージョン番号よりも大きい場合、またはローカルの HelpInfo XML ファイルがない場合は、によってUpdate-Help新しいヘルプファイルのインストールが準備されます。Update-HelpSourcePath ディレクトリからモジュールの CAB ファイルを選択します。 モジュール名、モジュール GUID、および UI カルチャを使用して、CAB ファイルを識別します。Update-HelpCAB ファイルをアンパックし、ヘルプコンテンツファイルを検証して、ヘルプコンテンツファイルをユーザーのコンピューターのモジュールディレクトリの言語固有のサブディレクトリに保存します。Update-Helpリモートの HelpInfo XML ファイルをコピーすることによって、ローカルの HelpInfo XML ファイルを作成します。 ローカルの HelpInfo XML ファイルを編集して、インストールした CAB ファイルの要素のみが含まれるようにします。 次に、ローカルの HelpInfo XML ファイルをモジュールディレクトリに保存し、更新を終了します。