更新重置工具

适用于: Configuration Manager(current branch)

从版本 1706 开始,Configuration Manager 主站点和管理中心站点包括 Configuration Manager 更新重置工具 ,CMUpdateReset.exe。 当控制台中的更新在下载或复制时遇到问题时,请使用该工具修复问题。 该工具位于站点服务器的 \cd.latest\SMSSETUP\TOOLS 文件夹中。

可以将此工具与当前分支的任何版本一起使用,该分支仍受支持。

如果 尚未安装控制台内更新 并且处于失败状态,请使用此工具。 失败状态表示更新下载正在进行,但停滞或花费的时间过长。 对于类似大小的更新包,较长时间被认为比历史预期要长几小时。 将更新复制到子主站点也可能失败。

运行该工具时,它会针对指定的更新运行。 默认情况下,该工具不会删除已成功安装或下载的更新。

先决条件

用于运行该工具的帐户需要以下权限:

  • 对管理中心站点的站点数据库以及层次结构中每个主站点的读取写入权限。 若要设置这些权限,可以将用户帐户添加为 db_datawriter 的成员,并在每个站点的 Configuration Manager 数据库中 db_datareader固定数据库角色 。 该工具不与辅助站点交互。
  • 层次结构的顶级站点上的本地管理员
  • 承载服务连接点的计算机上的本地管理员

需要要重置的更新包的 GUID。 获取 GUID:

  1. 在控制台中,转到 “管理>更新和服务”。
  2. 在显示窗格中,右键单击其中一列的标题 ((如 状态) ),然后选择“ 包 Guid ”将该列添加到显示。
  3. 列现在显示更新包 GUID。

提示

若要复制 GUID,请选择要重置的更新包的行,然后使用 Ctrl+C 复制该行。 如果将复制的选定内容粘贴到文本编辑器中,则可以在运行该工具时仅复制 GUID 以用作命令行参数。

运行工具

该工具必须在层次结构的顶级站点上运行。

运行该工具时,请使用命令行参数指定:

  • 层次结构顶层站点上的 SQL Server。
  • 顶层站点上的站点数据库名称。
  • 要重置的更新包的 GUID。

根据更新的状态,该工具标识需要访问的其他服务器。

如果更新包处于 下载后 状态,则该工具不会清理包。 作为一个选项,可以使用强制删除参数强制删除成功下载的更新 (请参阅本主题后面的命令行参数) 。

工具运行后:

  • 如果删除了包,请在顶层站点上重启SMS_Executive服务。 然后,检查更新,以便可以再次下载包。
  • 如果未删除包,则无需执行任何操作。 更新会重新初始化,然后重启复制或安装。

命令行参数:

参数 说明
顶层站点的 SQL Server 的 -S <FQDN> 必需
指定托管层次结构顶层站点的站点数据库的 SQL Server 的 FQDN。
-D <数据库名称> 必需
在顶层站点上指定数据库的名称。
-P <包 GUID> 必需
指定要重置的更新包的 GUID。
-I <SQL Server 实例名称> 可选
标识承载站点数据库的 SQL Server 实例。
-FDELETE 可选
强制删除已成功下载的更新包。

示例:
在典型方案中,需要重置有下载问题的更新。 SERVER1.FABRIKAM.COM SQL Server FQDN ,站点数据库 CM_XYZ,包 GUID 为 61F16B3C-F1F6-4F9F-8647-2A524B0C802C。 运行: CMUpdateReset.exe -S server1.fabrikam.com -D CM_XYZ -P 61F16B3C-F1F6-4F9F-8647-2A524B0C802C

在更极端的情况下,需要强制删除有问题的更新包。 SERVER1.FABRIKAM.COM SQL Server FQDN ,站点数据库 CM_XYZ,包 GUID 为 61F16B3C-F1F6-4F9F-8647-2A524B0C802C。 运行: CMUpdateReset.exe -FDELETE -S server1.fabrikam.com -D CM_XYZ -P 61F16B3C-F1F6-4F9F-8647-2A524B0C802C