ネットワーク環境用のローカル ヘルプ インストールの展開と管理
Microsoft ヘルプ ビューアーを使用して、Microsoft 製品とテクノロジに関するローカル ドキュメントをローカル コンピューターにインストールし、インストールしたものを表示、管理できます。 これらの技術には、Visual Studio、.NET、言語リファレンス、SQL Server、Windows 開発が含まれます。
この記事では、ヘルプ ビューアーを使用して、インターネット アクセスの有無に関係なく、ネットワーク環境のローカル ヘルプ インストールを展開および管理する方法について説明します。 ローカル ヘルプ コンテンツは、コンピューターごとに構成されます。 既定では、ユーザーがローカル ヘルプのインストールを更新するには、そのユーザーに管理者権限が必要です。
ご利用のネットワーク環境でクライアントがインターネットにアクセスできる場合、ヘルプ コンテンツ マネージャーの実行可能ファイルを利用し、インターネットからローカル ヘルプ コンテンツを配置できます。 HlpCtntMgr.exe のコマンド ライン構文の詳細については、「ヘルプ コンテンツ マネージャーのコマンド ライン引数」を参照してください。
コンテンツの作成、イントラネット サービスのエンドポイントの作成、類似した種類のアクティビティの詳細については、ヘルプ ビューアー SDK を参照してください。
ご利用のネットワーク環境にインターネット アクセスがない場合、ヘルプ ビューアーでは、イントラネットかネットワーク共有からローカル ヘルプ コンテンツを展開できます。 次のような機能でレジストリ キーをオーバーライドし、Visual Studio IDE のヘルプ オプションを無効にすることもできます。
オンラインとオフラインのヘルプ
IDE の初回起動時のコンテンツ インストール
イントラネット コンテンツ サービスの指定
コンテンツの管理
インターネットからローカル ヘルプ コンテンツを配置する
ヘルプ コンテンツ マネージャー (HlpCtntMgr.exe) を利用し、インターネットからクライアント コンピューターにローカル ヘルプ コンテンツを配置できます。 次の構文を使用します。
\\%ProgramFiles(x86)%\Microsoft Help Viewer\v2.3\HlpCtntmgr.exe /operation \<*name*> /catalogname \<*catalog name*> /locale \<*locale*>
HlpCtntMgr.exe のコマンド ライン構文の詳細については、「ヘルプ コンテンツ マネージャーのコマンド ライン引数」を参照してください。
要件:
クライアント コンピューターがインターネットにアクセスできる必要があります。
インストール後にユーザーがローカル ヘルプ コンテンツを更新、追加、または削除するには、そのユーザーに管理者権限が必要です。
注意事項:
- ヘルプの既定のソースはオンラインのままです。
例
次の例では、クライアント コンピューターに Visual Studio の英語のコンテンツをインストールします。
インターネットから英語のコンテンツをインストールするには
[スタート] を選択し、[ファイル名を指定して実行] を選択します。
次のように入力します。
C:\Program Files (x86)\Microsoft Help Viewer\v2.3\hlpctntmgr.exe /operation install /catalogname VisualStudio15 /locale en-us
Enter キーを押します。
事前にインストールされたローカル ヘルプ コンテンツをクライアント コンピューターに配置する
オンラインから 1 台のコンピューターに一連のコンテンツをインストールし、そのインストールされたコンテンツを他のコンピューターにコピーすることができます。
要件:
最初にコンテンツをインストールするコンピューターでは、インターネットにアクセスできる必要があります。
インストール後にユーザーがローカル ヘルプ コンテンツを更新、追加、または削除するには、そのユーザーに管理者権限が必要です。
ヒント
ユーザーに管理者権限がない場合は、ヘルプ ビューアーで [コンテンツの管理] タブを無効にすることをお勧めします。 詳細については、「ヘルプ ビューアーの既定値をオーバーライドする」を参照してください。
注意事項:
- ヘルプの既定のソースはオンラインのままです。
コンテンツ セットを作成する
基本コンテンツ セットを作成する前に、ターゲット コンピューターで Visual Studio のすべてのローカル コンテンツをアンインストールする必要があります。
ローカル ヘルプをアンインストールするには
ヘルプ ビューアーで、[コンテンツの管理] タブを選択します。
Visual Studio ドキュメント セットに移動します。
各サブ項目の横の [削除] を選択します。
[更新] を選択し、アンインストールします。
%ProgramData%\Microsoft\HelpLibrary2\Catalogs\VisualStudio15 に移動し、フォルダーに catalogType.xml ファイルだけが含まれていることを確認します。
前にインストールされた Visual Studio のローカル ヘルプ コンテンツをすべて削除したら、基本コンテンツ セットをダウンロードする準備が整いました。
コンテンツをダウンロードするには
ヘルプ ビューアーで、[コンテンツの管理] タブを選択します。
[推奨されるドキュメント] または [利用可能なドキュメント] で、ダウンロードするドキュメント セットに移動し、[追加] を選択します。
[更新] を選択します。
次に、クライアント コンピューターに配置できるように、コンテンツをパッケージ化する必要があります。
コンテンツをパッケージ化するには
後の配置でコンテンツをコピーするフォルダーを作成します。 たとえば、C:\VSHelp とします。
管理者のアクセス許可で cmd.exe を開きます。
手順 1 で作成したフォルダーに移動します。
次のように入力します。
Xcopy %ProgramData%\Microsoft\HelpLibrary2 \<*foldername*>\ /y /e /k /o
例:
Xcopy %ProgramData%\Microsoft\HelpLibrary2 c:\VSHelp\ /y /e /k /o
コンテンツを配置する
ネットワーク共有を作成し、その場所にヘルプ コンテンツをコピーします。
たとえば、C:\VSHelp のコンテンツを \\myserver\VSHelp にコピーします。
ヘルプ コンテンツの配置スクリプトを含める .bat ファイルを作成します。 クライアントがプッシュの一部として、削除されるファイルのいずれかに読み取りロックを設定している可能性があるため、更新をプッシュする前にクライアントをシャットダウンする必要があります。 たとえば次のような点です。
REM - copy pre-ripped content to ProgramData Xcopy %~dp0HelpLibrary2 %SYSTEMDRIVE%\ProgramData\Microsoft\HelpLibrary2\ /y /e /k /o if ERRORLEVEL 1 ECHO *** ERROR COPYING Help Library files to ProgramData (%ERRORLEVEL%)
ヘルプ コンテンツをインストールするローカル コンピューターで .bat ファイルを実行します。