适用于: Windows Server 2019,Windows Server 2016,Windows Server 2012 R2,Windows Server 2012。
本主题介绍了如何更新运行选项,这些选项可用于配置 群集感知更新 (CAU) 更新运行。 当使用 CAU UI 或 CAU Windows PowerShell cmdlet 来应用更新或者配置自我更新选项时,可以配置这些高级选项。
大多数配置设置可以另存为称为“更新运行配置文件”的 XML 文件,以后执行更新运行时可以重复使用该文件。 还可以在许多群集环境中使用 CAU 提供的更新运行选项的默认值。
你可以为每个更新运行指定其他选项,此方面的信息以及更新运行配置文件的信息,请参阅以下部分(本主题后面提供):
请求更新运行时指定的选项使用更新运行配置文件选项,这些选项可以在更新运行配置文件中设置
下表列出了你可以在 CAU 更新运行配置文件中设置的选项。
Note: 若要设置 PreUpdateScript 或 PostUpdateScript 选项,请确保已安装 Windows PowerShell 和 .NET Framework 4.6 或4.5,并且已在群集中的每个节点上启用 PowerShell 远程处理。 有关详细信息,请参阅 Cluster-Aware 更新的要求和最佳做法中的配置用于远程管理的节点。
| 选项 | 默认值 | 详细信息 |
|---|---|---|
| StopAfter | 无时间限制 | 时间(分钟),如果未完成,则经过该时间之后停止更新运行。 注意: 如果指定更新前或更新后的 PowerShell 脚本,则运行脚本和执行更新的整个过程都必须在 StopAfter 时间限制内完成。 |
| WarnAfter | 默认情况下不显示警告 | 时间(分钟),如果更新运行(包括更新前脚本和更新后脚本(如果已配置))未完成,则经过该时间之后显示警告。 |
| MaxRetriesPerNode | 3 | 每个节点将重试更新过程(包括更新前脚本和更新后脚本(如果已配置))的最大次数。 最大值为 64。 |
| MaxFailedNodes | 对于大多数群集而言,它是一个大约为群集节点数三分之一的整数 | 更新可能会失败(原因是节点失败或者群集服务停止运行)的最大节点数。 如果多个节点失败,则停止更新运行。有效值范围为群集节点数减 0 到减 1。 |
| RequireAllNodesOnline | 无 | 指定更新开始之前所有节点都必须联机且可以访问。 |
| RebootTimeoutMinutes | 15 | CAU 给重新启动节点(如果有必要重新启动)以及启动所有自动启动服务留出的时间(分钟)。 如果重新启动过程在此时间内未完成,则该节点上的更新运行标记为失败。 |
| PreUpdateScript | 无 | 要在更新开始之前以及节点置于维护模式之前,要在每个节点上运行的 PowerShell 脚本的路径和文件名。 文件扩展名必须为 . ps1,并且路径加上文件名的总长度不得超过260个字符。 最佳做法是,应该将脚本放置在群集存储中的磁盘上,或者放置在可用性高的网络文件共享上,以确保所有群集节点始终都可以对该脚本进行访问。 如果将脚本放置在网络文件共享上,请确保为 Everyone 组配置对该文件共享的读取权限,并限制写入访问权限,以防止未经授权的用户篡改文件。 如果指定更新前脚本,请确保配置诸如时间限制之类的设置(例如“StopAfter”)以允许脚本成功运行。 这些限制跨运行脚本和安装更新的整个过程,而不仅仅是安装更新的过程。 |
| PostUpdateScript | 无 | 更新完成后要运行的 PowerShell 脚本的路径和文件名 (在节点离开维护模式) 。 文件扩展名必须为 . ps1 ,路径加上文件名的总长度不得超过260个字符。 最佳做法是,应该将脚本放置在群集存储中的磁盘上,或者放置在可用性高的网络文件共享上,以确保所有群集节点始终都可以对该脚本进行访问。 如果将脚本放置在网络文件共享上,请确保为 Everyone 组配置对该文件共享的读取权限,并限制写入访问权限,以防止未经授权的用户篡改文件。 如果指定更新后脚本,则确保配置诸如时间限制之类的设置(例如“StopAfter”)以允许脚本成功运行。 这些限制跨运行脚本和安装更新的整个过程,而不仅仅是安装更新的过程。 |
| ConfigurationName | 仅当运行脚本时此设置才有效。 如果指定更新前脚本或更新后脚本,但未指定 ConfigurationName,则将使用 PowerShell () 的默认会话配置。 | 指定 PowerShell 会话配置,该配置定义在其中运行 PreUpdateScript 和 PostUpdateScript) 指定的脚本 (的会话,并且可以限制可运行的命令。 |
| CauPluginName | Microsoft.WindowsUpdatePlugin | 配置群集感知更新以用于预览更新或执行更新运行的插件。 有关详细信息,请参阅 Cluster-Aware 更新插件的工作原理。 |
| CauPluginArguments | 无 | 用于更新要使用插件的一组 name=value 对,例如:域 = 本地这些 name=value 对必须对在“CauPluginName”中指定的插件有意义。若要使用 CAU UI 指定参数,请键入 name,按 Tab 键,然后键入相应的 value。 再次按 Tab 键以提供下一个参数。 每个 name 和 value 都用一个等号 (=) 自动分隔。 多个对用分号自动分隔。对于默认的 microsoft.windowsupdateplugin 插件,无需参数。 但是,可以指定一个可选参数,例如,指定一个标准的 Windows 更新代理查询字符串,用于筛选插件应用的更新集。 对于 " 名称",请使用 QueryString,对于 值,请将完整查询用引号引起来。 有关详细信息,请参阅 Cluster-Aware 更新插件的工作原理。 |
请求更新运行时指定的选项
下表列出了请求更新运行时可以指定的选项(不是更新运行配置文件中的选项)。 有关在更新运行配置文件中可以设置的选项的信息,请参阅上表。
| 选项 | 默认值 | 详细信息 |
|---|---|---|
| ClusterName | 无 注意: 仅当 CAU UI 未在故障转移群集节点上运行,或者要引用不同于 CAU UI 运行位置的故障转移群集时,才必须设置此选项。 | 要在其上执行更新运行的群集的 NetBIOS 名称。 |
| 凭据 | 当前帐户凭据 | 将执行更新运行的目标群集的管理凭据。 如果从对群集具有管理员权限的帐户) 使用 CAU PowerShell cmdlet,则你可能已具有所需的凭据 (或打开 PowerShell 会话。 |
| NodeOrder | 默认情况下,CAU 从拥有群集角色数量最少的节点开始,然后是数量第二少的节点,依此类推。 | 群集节点的名称,顺序为应对它们进行更新的顺序(如果可能)。 |
使用更新运行配置文件
可将每个更新运行与特定的更新运行配置文件进行关联。 默认的更新运行配置文件存储在 %windir%\cluster 文件夹中。 如果在远程更新模式中使用 CAU UI,则可以在应用更新时指定更新运行配置文件,也可以使用默认的更新运行配置文件。 如果在自我更新模式中使用 CAU,则在配置自我更新选项时,可以从指定的更新运行配置文件中导入设置。 在这两种情况下,都可以根据需要覆盖更新运行选项的显示值。 如果需要,可以使用相同或不同的文件名将更新运行选项另存为更新运行配置文件。 下一次当你应用更新或者配置自我更新选项时,CAU 将自动选择上次所选择的更新运行配置文件。
可以通过在 CAU UI 中选择 " 创建或修改更新运行配置文件 " 来修改现有的更新运行配置文件或创建一个新的配置文件。
下面是有关使用更新运行配置文件的一些重要说明:
- 更新运行配置文件不存储特定于群集的信息,例如管理凭据。 如果在自我更新模式中使用 CAU,则更新运行配置文件也不会存储自我更新计划信息。 这样便可在指定类的所有故障转移群集之间共享更新运行配置文件。
- 如果使用更新运行配置文件配置自我更新选项,然后使用不同的值为更新运行选项修改配置文件,则自我更新配置不会自动更改。 若要应用新的更新运行设置,必须再次配置自我更新选项。
- 运行配置文件编辑器不支持包含空格的文件路径,如 C:\Program 文件。 作为一种解决方法,请在不包含空格的路径中存储更新前和后期更新脚本,或仅使用 PowerShell 来管理运行配置文件,并在运行 invoke-caurun 时在路径两侧加上引号。
Windows PowerShell 等效命令
运行 invoke-caurun、 add-cauclusterrole 或 add-cauclusterrole Cmdlet 时,可以从更新运行配置文件中导入设置。
以下示例将使用 C:\Windows\Cluster\DefaultParameters.xml 中指定的更新运行选项,在名为 CONTOSO-FC1 的群集上执行扫描和完整的更新运行。 为剩余的 cmdlet 参数使用默认值。
$MyRunProfile = Import-Clixml C:\Windows\Cluster\DefaultParameters.xml
Invoke-CauRun –ClusterName CONTOSO-FC1 @MyRunProfile
通过更新运行配置文件,你可以使用异常管理、时间限制和其他操作参数的一致性设置反复更新某个故障转移群集。 由于这些设置通常特定于故障转移群集的类(如 "所有 Microsoft SQL Server 群集" 或 "我的业务关键型群集"),因此你可能需要根据将用于的故障转移群集类来命名每个更新运行配置文件。 此外,你可能需要在可由 IT 组织中特定类的所有故障转移群集访问的文件共享上管理更新运行配置文件。
其他参考
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 JasonGerend)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
