Поделиться через


Развертывание локальных установок справки и управление ими для сетевых сред

Средство просмотра справки Майкрософт можно использовать для установки, просмотра и управления локальными установками документации для продуктов и технологий Майкрософт на локальных компьютерах. К этим технологиям относятся Visual Studio, .NET, справочник по языку, SQL Server и разработка Windows.

В этой статье вы узнаете, как использовать средство просмотра справки для развертывания локальных установок справки и управления ими для сетевых сред с доступом к Интернету или без них. Локальное содержимое справки настраивается для каждого компьютера. По умолчанию пользователи должны иметь права администратора для обновления своей локальной установленной справки.

Если сетевая среда разрешает клиентам доступ в Интернет, с помощью диспетчера содержимого справки можно развертывать локальное содержимое справки из Интернета. Дополнительные сведения о синтаксисе командной строки HlpCtntMgr.exe см. в разделе Аргументы командной строки для диспетчера содержимого справки.

Сведения о создании содержимого, создании конечной точки службы интрасети и аналогичных типах действий см. в разделе Пакет SDK для окна справки.

Если в сетевой среде нет доступа в Интернет, окно справки может развертывать локальное содержимое справки из интрасети или из сетевой папки. Вы также можете отключить параметры справки для интегрированной среде разработки Visual Studio с помощью переопределений разделов реестра. Таким образом можно настроить следующие возможности:

  • подключенная и автономная справка;

  • установка содержимого при первом запуске интегрированной среды разработки;

  • указание службы содержимого в интрасети;

  • управление содержимым.

Развертывание локального содержимого справки из Интернета

Диспетчер содержимого справки (HlpCtntMgr.exe) можно использовать для локального развертывания содержимого справки из Интернета на клиентских компьютерах. Используйте следующий синтаксис:

\\%ProgramFiles(x86)%\Microsoft Help Viewer\v2.3\HlpCtntmgr.exe /operation \<*name*> /catalogname \<*catalog name*> /locale \<*locale*>

Дополнительные сведения о синтаксисе командной строки HlpCtntMgr.exe см. в разделе Аргументы командной строки для диспетчера содержимого справки.

Требования:

  • Клиентские компьютеры должны иметь доступ к Интернету.

  • Пользователи должны обладать правами администратора, чтобы обновлять, добавлять или удалять локальное содержимое справки после того, как оно было установлено.

Предупреждения:

  • Источником справки по умолчанию по-прежнему будет Интернет.

Пример

Следующий пример устанавливает содержимое для Visual Studio на английском языке на клиентский компьютер.

Установка содержимого на английском языке из Интернета

  1. Нажмите кнопку Пуск и выберите команду Выполнить.

  2. Введите следующее:

    C:\Program Files (x86)\Microsoft Help Viewer\v2.3\hlpctntmgr.exe /operation install /catalogname VisualStudio15 /locale en-us

  3. Нажмите ВВОД.

Развертывание предустановленного локального содержимого справки на клиентских компьютерах

Можно установить набор содержимого из сети на один компьютер, а затем скопировать этот установленный набор содержимого на другие компьютеры.

Требования:

  • Компьютер, где устанавливается набор содержимого, должен иметь доступ к Интернету.

  • Пользователи должны обладать правами администратора, чтобы обновлять, добавлять или удалять локальное содержимое справки после того, как оно было установлено.

    Совет

    Если пользователи не имеют прав администратора, рекомендуется отключить вкладку Управление содержимым в окне справки. Дополнительные сведения см. в разделе "Переопределение справки" по умолчанию.

Предупреждения:

  • Источником справки по умолчанию по-прежнему будет Интернет.

Создание набора содержимого

Прежде чем можно будет создать базовый набор содержимого, необходимо сначала удалить все локальное содержимое Visual Studio на целевом компьютере.

Удаление локальной справки

  1. В средстве просмотра справки выберите вкладку Управление содержимым.

  2. Перейдите к набору документов Visual Studio.

  3. Нажмите кнопку Удалить рядом с каждым вложенным элементом.

  4. Выберите Обновить, чтобы выполнить удаление.

  5. Перейдите в папку %ProgramData%\Microsoft\HelpLibrary2\Catalogs\VisualStudio15 и убедитесь в том, что она содержит только файл catalogType.xml.

    После удаления всего ранее установленного локального содержимого справки Visual Studio можно загрузить базовый набор содержимого.

Загрузка содержимого

  1. В средстве просмотра справки выберите вкладку Управление содержимым.

  2. В разделе Рекомендуемая документация или Доступная документация перейдите к наборам документации, которые требуется скачать, и затем выберите Добавить.

  3. Выберите Обновить.

После этого потребуется упаковать содержимое, чтобы его можно было развертывать на клиентских компьютерах.

Упаковка содержимого

  1. Создайте папку, чтобы скопировать содержимое для дальнейшего развертывания. Пример: C:\VSHelp.

  2. Откройте cmd.exe с разрешениями администратора.

  3. Перейдите к папке, созданной на шаге 1.

  4. Введите следующее:

    Xcopy %ProgramData%\Microsoft\HelpLibrary2 \<*foldername*>\ /y /e /k /o

    Например: Xcopy %ProgramData%\Microsoft\HelpLibrary2 c:\VSHelp\ /y /e /k /o

Развертывание содержимого

  1. Создайте сетевую папку и скопируйте содержимое справки в это место.

    Например, скопируйте содержимое в C:\VSHelp в \\myserver\VSHelp.

  2. Создайте 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%)
    
  3. Запустите BAT-файл на локальных компьютерах, на которых требуется установить содержимое справки.