可更新帮助的工作原理

本主题说明可更新帮助如何处理每个模块的 HelpInfo XML 文件和 CAB 文件，并为用户安装更新的帮助。

更新帮助流程

以下列表描述了当用户运行命令来更新特定 UI 区域性中模块的帮助文件时 Update-Help cmdlet 的操作。

1. Update-Help 从模块清单中 HelpInfoURI 键值指定的位置获取远程 HelpInfo XML 文件，并根据架构验证该文件。 （要查看该架构，请参阅 HelpInfo XML 架构。）然后 Update-Help 在用户计算机上的模块目录中查找该模块的本地 HelpInfo XML 文件。

2. Update-Help 比较模块的远程和本地 HelpInfo XML 文件中指定 UI 区域性的帮助文件的版本号。如果远程文件上的版本号大于本地文件上的版本号，或者如果模块没有本地 HelpInfo XML 文件，Update-Help 准备下载新的帮助文件。

3. Update-Help 从远程 HelpInfo XML 文件中 HelpContentUri 元素指定的位置选择模块的 CAB 文件。它使用模块名称、模块 GUID 和 UI 区域性来识别 CAB 文件。

4. Update-Help 下载 CAB 文件，解压它，验证帮助内容文件，并将帮助内容文件保存在用户计算机上模块目录的特定于语言的子目录中。

5. Update-Help 通过复制远程 HelpInfo XML 文件来创建本地 HelpInfo XML 文件。它编辑本地 HelpInfo XML 文件，使其仅包含其安装的 CAB 文件的元素。然后，它将本地 HelpInfo XML 文件保存在模块目录中并结束更新。

保存帮助流程

以下列表描述了当用户运行命令来更新文件共享中的帮助文件，然后使用这些文件更新用户计算机上的帮助文件时 Save-Help 和 Update-Help cmdlet 的操作。

Save-Help cmdlet 执行以下操作来响应将模块的帮助文件保存到由 DestinationPath 参数指定的文件共享中的命令。

1. Save-Help 从模块清单中 HelpInfoURI 键的值指定的位置获取远程 HelpInfo XML 文件，并根据架构验证该文件。 （要查看架构，请参阅 HelpInfo XML 架构。）然后 Save-Help 在 DestinationPath 参数指定的目录中查找本地 HelpInfo XML 文件。 >保存帮助命令。

2. Save-Help 比较模块的远程和本地 HelpInfo XML 文件中指定 UI 区域性的帮助文件的版本号。如果远程文件上的版本号大于本地文件上的版本号，或者如果 DestinationPath 目录中没有该模块的本地 HelpInfo XML 文件，Save-Help 准备下载新的帮助文件。

3. Save-Help 从远程 HelpInfo XML 文件中 HelpContentUri 元素指定的位置选择模块的 CAB 文件。它使用模块名称、模块 GUID 和 UI 区域性来识别 CAB 文件。

4. Save-Help 下载 CAB 文件并将其保存在 DestinationPath 目录中。 （它不会创建任何特定于语言的子目录。）

5. Save-Help 通过复制远程 HelpInfo XML 文件来创建本地 HelpInfo XML 文件。它编辑本地 HelpInfo XML 文件，使其仅包含其保存的 CAB 文件的元素。然后，它将本地 HelpInfo XML 文件保存在 DestinationPath 目录中并结束更新。

   Update-Help cmdlet 执行以下操作来响应从 SourcePath 参数指定的文件共享中的文件更新用户计算机上的帮助文件的命令。

6. Update-Help 从SourcePath 目录获取远程HelpInfo XML 文件。然后，它在用户计算机上的模块目录中查找本地 HelpInfo XML 文件。

7. Update-Help 比较模块的远程和本地 HelpInfo XML 文件中指定 UI 区域性的帮助文件的版本号。如果远程文件的版本号大于本地文件的版本号，或者没有本地 HelpInfo XML 文件，Update-Help 准备安装新的帮助文件。

8. Update-Help 从 SourcePath 目录中选择模块的 CAB 文件。它使用模块名称、模块 GUID 和 UI 区域性来识别 CAB 文件。

9. Update-Help 解压 CAB 文件，验证帮助内容文件，并将帮助内容文件保存在用户计算机上模块目录的特定于语言的子目录中。

10. Update-Help 通过复制远程 HelpInfo XML 文件来创建本地 HelpInfo XML 文件。它编辑本地 HelpInfo XML 文件，使其仅包含其安装的 CAB 文件的元素。然后，它将本地 HelpInfo XML 文件保存在模块目录中并结束更新。