使用维护配置和 Azure CLI 来控制更新
适用于:✔️ Linux VM ✔️ Windows VM ✔️ 灵活规模集 ✔️ 统一规模集
可以使用维护配置功能来控制何时将平台更新应用到各种 Azure 资源。 本文介绍了用于使用此功能的 Azure CLI 选项。 若要详细了解使用维护配置的好处、该功能的限制以及其他管理选项,请参阅使用维护配置管理平台更新。
重要
特定的范围支持特定的机器类型和计划。 请务必为虚拟机 (VM) 选择正确的范围。
创建维护配置
创建维护配置的第一步是创建一个资源组作为你的配置的容器。 此示例在 chinanorth 中创建一个名为 myMaintenanceRG 的资源组。 如果你已有一个可供使用的资源组,则可跳过此部分,并在其余示例中将资源组名称替换为你自己的名称。
az group create \
--location chinanorth \
--name myMaintenanceRG
创建该资源组后,使用 az maintenance configuration create
创建维护配置。
主机
此示例创建一个名为 myConfig 的维护配置,该配置的作用域为主机,其计划时段为每月第四个星期一的 5 个小时:
az maintenance configuration create \
--resource-group myMaintenanceRG \
--resource-name myConfig \
--maintenance-scope host \
--location chinanorth \
--maintenance-window-duration "05:00" \
--maintenance-window-recur-every "Month Fourth Monday" \
--maintenance-window-start-date-time "2020-12-30 08:00" \
--maintenance-window-time-zone "Pacific Standard Time"
使用 --maintenance-scope host
可确保使用维护配置来控制对主机基础结构的更新。 如果尝试创建同名但位于不同位置的配置,则会收到错误。 配置名称对于资源组必须是唯一的。
若要检查是否已成功创建了维护配置,可以使用 az maintenance configuration list
来查询可用的维护配置:
az maintenance configuration list
--query "[].{Name:name, ID:id}"
--output table
可以将维护重复周期表示为每日、每周或每月。 以下是一些示例:
- 每日:
maintenance-window-recur-every
值为"Day"
或"3Days"
。 - 每周:
maintenance-window-recur-every
值为"3Weeks"
或"Week Saturday,Sunday"
。 - 每月:
maintenance-window-recur-every
值为"Month day23,day24"
、"Month Last Sunday"
或Month Fourth Monday
。
虚拟机规模集
此示例创建一个名为 myConfig 的维护配置,该配置的作用域为虚拟机规模集的操作系统映像,其计划时段为每月第四个星期一的 5 个小时:
az maintenance configuration create \
--resource-group myMaintenanceRG \
--resource-name myConfig \
--maintenance-scope osimage \
--location chinanorth \
--maintenance-window-duration "05:00" \
--maintenance-window-recur-every "Month Fourth Monday" \
--maintenance-window-start-date-time "2020-12-30 08:00" \
--maintenance-window-time-zone "Pacific Standard Time"
来宾 VM
此示例创建一个名为 myConfig 的维护配置,该配置的作用域为来宾计算机(VM 和已启用 Azure Arc 的服务器),其计划时段为每 20 天 2 个小时。 详细了解来宾虚拟机的维护配置。
az maintenance configuration create \
--resource-group myMaintenanceRG \
--resource-name myConfig \
--maintenance-scope InGuestPatch \
--location chinanorth \
--maintenance-window-duration "02:00" \
--maintenance-window-recur-every "20days" \
--maintenance-window-start-date-time "2022-12-30 07:00" \
--maintenance-window-time-zone "Pacific Standard Time" \
--install-patches-linux-parameters package-name-masks-to-exclude="ppt" package-name-masks-to-include="apt" classifications-to-include="Other" \
--install-patches-windows-parameters kb-numbers-to-exclude="KB123456" kb-numbers-to-include="KB123456" classifications-to-include="FeaturePack" \
--reboot-setting "IfRequired" \
--extension-properties InGuestPatchMode="User"
分配配置
使用 az maintenance assignment create
将配置分配给你的计算机。
隔离的 VM
使用此配置的 ID 将配置应用于独立主机 VM。 指定 --resource-type virtualMachines
。 为 --resource-name
提供 VM 的名称,为 --resource-group
提供 VM 的资源组,为 --location
提供 VM 的位置。
az maintenance assignment create \
--resource-group myMaintenanceRG \
--location chinanorth \
--resource-name myVM \
--resource-type virtualMachines \
--provider-name Microsoft.Compute \
--configuration-assignment-name myConfig \
--maintenance-configuration-id "/subscriptions/{subscription ID}/resourcegroups/myMaintenanceRG/providers/Microsoft.Maintenance/maintenanceConfigurations/myConfig"
专用主机
若要将配置应用到专用主机,需要包含 --resource-type hosts
、带主机组名称的 --resource-parent-name
,以及 --resource-parent-type hostGroups
。
参数 --resource-id
是主机的 ID。 可以使用 az-vm-host-get-instance-view 获取专用主机的 ID。
az maintenance assignment create \
--resource-group myDHResourceGroup \
--resource-name myHost \
--resource-type hosts \
--provider-name Microsoft.Compute \
--configuration-assignment-name myConfig \
--maintenance-configuration-id "/subscriptions/{subscription ID}/resourcegroups/myDhResourceGroup/providers/Microsoft.Maintenance/maintenanceConfigurations/myConfig" \
--location chinanorth \
--resource-parent-name myHostGroup \
--resource-parent-type hostGroups
虚拟机规模集
az maintenance assignment create \
--resource-group myMaintenanceRG \
--location chinanorth \
--resource-name myVMSS \
--resource-type virtualMachineScaleSets \
--provider-name Microsoft.Compute \
--configuration-assignment-name myConfig \
--maintenance-configuration-id "/subscriptions/{subscription ID}/resourcegroups/myMaintenanceRG/providers/Microsoft.Maintenance/maintenanceConfigurations/myConfig"
来宾 VM
az maintenance assignment create \
--resource-group myMaintenanceRG \
--location chinanorth \
--resource-name myVM \
--resource-type virtualMachines \
--provider-name Microsoft.Compute \
--configuration-assignment-name myConfig \
--maintenance-configuration-id "/subscriptions/{subscription ID}/resourcegroups/myMaintenanceRG/providers/Microsoft.Maintenance/maintenanceConfigurations/myConfig"
检查配置
可以验证是否正确应用了配置,或者使用 az maintenance assignment list
来检查当前应用了哪种配置。
隔离的 VM
az maintenance assignment list \
--provider-name Microsoft.Compute \
--resource-group myMaintenanceRG \
--resource-name myVM \
--resource-type virtualMachines \
--query "[].{resource:resourceGroup, configName:name}" \
--output table
专用主机
az maintenance assignment list \
--resource-group myDHResourceGroup \
--resource-name myHost \
--resource-type hosts \
--provider-name Microsoft.Compute \
--resource-parent-name myHostGroup \
--resource-parent-type hostGroups \
--query "[].{ResourceGroup:resourceGroup,configName:name}" \
--output table
虚拟机规模集
az maintenance assignment list \
--provider-name Microsoft.Compute \
--resource-group myMaintenanceRG \
--resource-name myVMSS \
--resource-type virtualMachines \
--query "[].{resource:resourceGroup, configName:name}" \
--output table
来宾 VM
az maintenance assignment list \
--provider-name Microsoft.Compute \
--resource-group myMaintenanceRG \
--resource-name myVM \
--resource-type virtualMachines \
--query "[].{resource:resourceGroup, configName:name}" \
--output table
检查挂起的更新
使用 az maintenance update list
查看是否存在挂起的更新。 将 --subscription
更新为包含 VM 的订阅的 ID。
如果没有更新,该命令会返回一条错误消息,其中包含文本:Resource not found...StatusCode: 404
。
如果存在更新,即使多个更新处于待执行状态,该命令也仅返回一个更新。 此更新的数据在对象中返回:
[
{
"impactDurationInSec": 9,
"impactType": "Freeze",
"maintenanceScope": "Host",
"notBefore": "2020-03-03T07:23:04.905538+00:00",
"resourceId": "/subscriptions/9120c5ff-e78e-4bd0-b29f-75c19cadd078/resourcegroups/DemoRG/providers/Microsoft.Compute/hostGroups/demoHostGroup/hosts/myHost",
"status": "Pending"
}
]
隔离的 VM
检查隔离的 VM 的挂起更新。 在此示例中,输出的格式为表格,方便你阅读:
az maintenance update list \
--subscription {subscription ID} \
--resource-group myMaintenanceRg \
--resource-name myVM \
--resource-type virtualMachines \
--provider-name Microsoft.Compute \
--output table
专用主机
检查专用主机的挂起更新。 在此示例中,输出的格式为表格,方便你阅读。 将资源的值替换为你自己的值。
az maintenance update list \
--subscription {subscription ID} \
--resource-group myHostResourceGroup \
--resource-name myHost \
--resource-type hosts \
--provider-name Microsoft.Compute \
--resource-parentname myHostGroup \
--resource-parent-type hostGroups \
--output table
应用更新
使用 az maintenance apply update
来应用挂起的更新。 成功后,此命令返回包含更新详细信息的 JSON。 应用更新调用可能需要长达 2 小时才能完成。
隔离的 VM
创建向独立 VM 应用更新的请求:
az maintenance applyupdate create \
--subscription {subscriptionID} \
--resource-group myMaintenanceRG \
--resource-name myVM \
--resource-type virtualMachines \
--provider-name Microsoft.Compute
专用主机
将更新应用到专用主机:
az maintenance applyupdate create \
--subscription {subscriptionID} \
--resource-group myHostResourceGroup \
--resource-name myHost \
--resource-type hosts \
--provider-name Microsoft.Compute \
--resource-parent-name myHostGroup \
--resource-parent-type hostGroups
虚拟机规模集
将更新应用于规模集:
az maintenance applyupdate create \
--subscription {subscriptionID} \
--resource-group myMaintenanceRG \
--resource-name myVMSS \
--resource-type virtualMachineScaleSets \
--provider-name Microsoft.Compute
检查应用更新的状态
可以使用 az maintenance applyupdate get
检查更新进度。
若要查看上次更新的结果,请使用 default
作为更新名称。 或者将 myUpdateName
替换为运行 az maintenance applyupdate create
时返回的更新的名称。
Status : Completed
ResourceId : /subscriptions/12ae7457-4a34-465c-94c1-17c058c2bd25/resourcegroups/TestShantS/providers/Microsoft.Comp
ute/virtualMachines/DXT-test-04-iso
LastUpdateTime : 1/1/2020 12:00:00 AM
Id : /subscriptions/12ae7457-4a34-465c-94c1-17c058c2bd25/resourcegroups/TestShantS/providers/Microsoft.Comp
ute/virtualMachines/DXT-test-04-iso/providers/Microsoft.Maintenance/applyUpdates/default
Name : default
Type : Microsoft.Maintenance/applyUpdates
LastUpdateTime
是更新完成的时间,不管是你发起的更新,还是平台因为你没有使用自行维护时段而发起的更新。 如果从未通过维护配置应用更新,则 LastUpdateTime
会显示默认值。
隔离的 VM
az maintenance applyupdate get \
--subscription {subscriptionID} \
--resource-group myMaintenanceRG \
--resource-name myVM \
--resource-type virtualMachines \
--provider-name Microsoft.Compute \
--apply-update-name myUpdateName \
--query "{LastUpdate:lastUpdateTime, Name:name, ResourceGroup:resourceGroup, Status:status}" \
--output table
专用主机
az maintenance applyupdate get \
--subscription {subscriptionID} \
--resource-group myMaintenanceRG \
--resource-name myHost \
--resource-type hosts \
--provider-name Microsoft.Compute \
--resource-parent-name myHostGroup \
--resource-parent-type hostGroups \
--apply-update-name myUpdateName \
--query "{LastUpdate:lastUpdateTime, Name:name, ResourceGroup:resourceGroup, Status:status}" \
--output table
虚拟机规模集
az maintenance applyupdate get \
--subscription {subscriptionID} \
--resource-group myMaintenanceRG \
--resource-name myVMSS \
--resource-type virtualMachineScaleSets \
--provider-name Microsoft.Compute \
--apply-update-name myUpdateName \
--query "{LastUpdate:lastUpdateTime, Name:name, ResourceGroup:resourceGroup, Status:status}" \
--output table
删除维护配置
若要删除维护配置,请使用 az maintenance configuration delete
。 删除配置时,会从关联的资源中删除维护控制。
az maintenance configuration delete \
--subscription 1111abcd-1a11-1a2b-1a12-123456789abc \
-resource-group myResourceGroup \
--resource-name myConfig
后续步骤
若要了解详细信息,请参阅 Azure 中虚拟机的维护。