Как работает обновляемая справка

В этом разделе объясняется, как обновляемая справка обрабатывает XML-файл HelpInfo и CAB-файлы для каждого модуля и устанавливает обновленную справку для пользователей.

Процесс Update-Help

В следующем списке описываются действия командлета Update-Help , когда пользователь запускает команду для обновления файлов справки для модуля в определенном языке и региональных параметрах пользовательского интерфейса.

1. Update-Help возвращает удаленный XML-файл HelpInfo из расположения, указанного значением ключа HelpInfoURI в манифесте модуля, и проверяет файл по схеме. (Чтобы просмотреть схему, ознакомьтесь со схемой XML HelpInfo.) Затем Update-Help найдите локальный XML-файл HelpInfo для модуля в каталоге модулей на компьютере пользователя.

2. Update-Help сравнивает номер версии файлов справки для указанного языка и региональных параметров пользовательского интерфейса в удаленных и локальных XML-файлах HelpInfo для модуля. Если номер версии удаленного файла больше номера версии в локальном файле или отсутствует локальный XML-файл HelpInfo для модуля, Update-Help готовится скачать новые файлы справки.

3. Update-Help Выбирает CAB-файл для модуля из расположения, указанного элементом HelpContentUri в удаленном XML-файле HelpInfo. Он использует имя модуля, GUID модуля и язык и региональные параметры пользовательского интерфейса для идентификации CAB-файла.

4. Update-Help загружает CAB-файл, распаковывает его, проверяет файлы содержимого справки и сохраняет файлы содержимого справки в подкаталоге каталога модуля на компьютере пользователя.

5. Update-Help создает локальный XML-файл HelpInfo, копируя удаленный XML-файл HelpInfo. Он редактирует локальный XML-файл HelpInfo, чтобы он содержит элементы только для установленного CAB-файла. Затем он сохраняет локальный XML-файл HelpInfo в каталоге модуля и завершает обновление.

Процесс Save-Help

В следующем списке описываются действия командлетов Save-Help и Update-Help , когда пользователь выполняет команды для обновления файлов справки в общей папке, а затем используйте эти файлы для обновления файлов справки на компьютере пользователя.

Командлет Save-Help выполняет следующие действия в ответ на команду, чтобы сохранить файлы справки для модуля в общей папке, указанной параметром DestinationPath .

1. Save-Help возвращает удаленный XML-файл HelpInfo из расположения, указанного значением ключа HelpInfoURI в манифесте модуля, и проверяет файл по схеме. (Чтобы просмотреть схему, ознакомьтесь со схемой XML HelpInfo.) Затем Save-Help ищет локальный XML-файл HelpInfo в каталоге, указанном параметром DestinationPath в команде Save-Help .

2. Save-Help сравнивает номер версии файлов справки для указанного языка и региональных параметров пользовательского интерфейса в удаленных и локальных XML-файлах HelpInfo для модуля. Если номер версии удаленного файла больше номера версии локального файла или если для модуля в каталоге DestinationPath отсутствует локальный XML-файл HelpInfo, Save-Help готовится скачать новые файлы справки.

3. Save-Help Выбирает CAB-файл для модуля из расположения, указанного элементом HelpContentUri в удаленном XML-файле HelpInfo. Он использует имя модуля, GUID модуля и язык и региональные параметры пользовательского интерфейса для идентификации CAB-файла.

4. Save-Help загружает CAB-файл и сохраняет его в каталоге DestinationPath . (Она не создает подкаталогов для конкретного языка.)

5. Save-Help создает локальный XML-файл HelpInfo, копируя удаленный XML-файл HelpInfo. Он изменяет локальный XML-файл HelpInfo, чтобы он содержит элементы только для сохраненного CAB-файла. Затем он сохраняет локальный XML-файл HelpInfo в каталоге DestinationPath и завершает обновление.

   Командлет Update-Help выполняет следующие действия в ответ на команду, чтобы обновить файлы справки на компьютере пользователя из файлов в общей папке, указанной параметром SourcePath .

6. Update-Help получает удаленный XML-файл HelpInfo из каталога SourcePath . Затем он ищет локальный XML-файл HelpInfo в каталоге модуля на компьютере пользователя.

7. Update-Help сравнивает номер версии файлов справки для указанного языка и региональных параметров пользовательского интерфейса в удаленных и локальных XML-файлах HelpInfo для модуля. Если номер версии удаленного файла больше номера версии локального файла или если локальный XML-файл HelpInfo отсутствует, Update-Help подготавливается к установке новых файлов справки.

8. Update-Help Выбирает CAB-файл модуля из каталога SourcePath . Он использует имя модуля, GUID модуля и язык и региональные параметры пользовательского интерфейса для идентификации CAB-файла.

9. Update-Help распаковывает CAB-файл, проверяет файлы содержимого справки и сохраняет файлы содержимого справки в подкаталоге каталога модуля на компьютере пользователя.

10. Update-Help создает локальный XML-файл HelpInfo, копируя удаленный XML-файл HelpInfo. Он редактирует локальный XML-файл HelpInfo, чтобы он содержит элементы только для установленного CAB-файла. Затем он сохраняет локальный XML-файл HelpInfo в каталоге модуля и завершает обновление.