Kontrollera uppdateringar med underhållskonfigurationer och Azure CLI

Gäller för: ✔️ Virtuella Linux-datorer ✔️ Windows virtuella datorer ✔️ – flexibla skalningsuppsättningar ✔️ – enhetliga skalningsuppsättningar

Med underhållskonfigurationer kan du bestämma när du ska tillämpa plattformsuppdateringar på olika Azure-resurser. Det här avsnittet beskriver Azure CLI-alternativen för dedikerade värdar och isolerade virtuella datorer. Mer information om fördelarna med att använda underhållskonfigurationer, dess begränsningar och andra hanteringsalternativ finns i Hantera plattformsuppdateringar med underhållskonfigurationer.

Viktigt

Det finns olika omfång som stöder vissa datortyper och scheman, så se till att du väljer rätt omfång för den virtuella datorn.

Skapa en underhållskonfiguration

Använd az maintenance configuration create för att skapa en underhållskonfiguration. I det här exemplet skapas en underhållskonfiguration med namnet myConfig som är begränsad till värden.

az group create \
   --location eastus \
   --name myMaintenanceRG
az maintenance configuration create \
   -g myMaintenanceRG \
   --resource-name myConfig \
   --maintenance-scope host\
   --location eastus

Kopiera konfigurations-ID:t från utdata för senare användning.

Användning --maintenance-scope host säkerställer att underhållskonfigurationen används för att kontrollera uppdateringar av värdinfrastrukturen.

Om du försöker skapa en konfiguration med samma namn, men på en annan plats, får du ett felmeddelande. Konfigurationsnamn måste vara unika för resursgruppen.

Du kan fråga efter tillgängliga underhållskonfigurationer med hjälp av az maintenance configuration list.

az maintenance configuration list --query "[].{Name:name, ID:id}" -o table 

Skapa en underhållskonfiguration med ett schemalagt fönster

Du kan också deklarera ett schemalagt fönster när Azure ska tillämpa uppdateringarna på dina resurser. I det här exemplet skapas en underhållskonfiguration med namnet myConfig med en schemalagd period på 5 timmar den fjärde måndagen i varje månad. När du har skapat ett schemalagt fönster behöver du inte längre tillämpa uppdateringarna manuellt.

az maintenance configuration create \
   -g myMaintenanceRG \
   --resource-name myConfig \
   --maintenance-scope host \
   --location eastus \
   --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"

Viktigt

Underhållstiden måste vara 2 timmar eller längre.

Återkommande underhåll kan uttryckas som varje dag, vecka eller månad. Några exempel är:

  • daily- maintenance-window-recur-every: "Day" eller "3Days"
  • weekly- maintenance-window-recur-every: "3Weeks" eller "Week Saturday,Sunday"
  • monthly- maintenance-window-recur-every: "Month day23,day24" or "Month Last Sunday" eller "Month Fourth Monday"

Tilldela konfigurationen

Använd az maintenance assignment create för att tilldela konfigurationen till datorn.

Isolerad virtuell dator

Tillämpa konfigurationen på en virtuell dator med hjälp av konfigurationens ID. Ange --resource-type virtualMachines och ange namnet på den virtuella datorn för --resource-name, och resursgruppen för till den virtuella datorn i --resource-groupoch platsen för den virtuella datorn för --location.

az maintenance assignment create \
   --resource-group myMaintenanceRG \
   --location eastus \
   --resource-name myVM \
   --resource-type virtualMachines \
   --provider-name Microsoft.Compute \
   --configuration-assignment-name myConfig \
   --maintenance-configuration-id "/subscriptions/1111abcd-1a11-1a2b-1a12-123456789abc/resourcegroups/myMaintenanceRG/providers/Microsoft.Maintenance/maintenanceConfigurations/myConfig"

Dedikerad värd

Om du vill tillämpa en konfiguration på en dedikerad värd måste du inkludera --resource-type hosts, --resource-parent-name med namnet på värdgruppen och --resource-parent-type hostGroups.

Parametern --resource-id är värdens ID. Du kan använda az-vm-host-get-instance-view för att hämta ID:t för din dedikerade värd.

az maintenance assignment create \
   -g myDHResourceGroup \
   --resource-name myHost \
   --resource-type hosts \
   --provider-name Microsoft.Compute \
   --configuration-assignment-name myConfig \
   --maintenance-configuration-id "/subscriptions/1111abcd-1a11-1a2b-1a12-123456789abc/resourcegroups/myDhResourceGroup/providers/Microsoft.Maintenance/maintenanceConfigurations/myConfig" \
   -l eastus \
   --resource-parent-name myHostGroup \
   --resource-parent-type hostGroups 

Kontrollera konfigurationen

Du kan kontrollera att konfigurationen har tillämpats korrekt eller kontrollera vilken konfiguration som används för närvarande med .az maintenance assignment list

Isolerad virtuell dator

az maintenance assignment list \
   --provider-name Microsoft.Compute \
   --resource-group myMaintenanceRG \
   --resource-name myVM \
   --resource-type virtualMachines \
   --query "[].{resource:resourceGroup, configName:name}" \
   --output table

Dedikerad värd

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}" \
   -o table

Sök efter väntande uppdateringar

Använd az maintenance update list för att se om det finns väntande uppdateringar. Uppdatera – prenumerationen ska vara ID:t för den prenumeration som innehåller den virtuella datorn.

Om det inte finns några uppdateringar returnerar kommandot ett felmeddelande som innehåller texten: Resource not found...StatusCode: 404.

Om det finns uppdateringar returneras bara en, även om det finns flera väntande uppdateringar. Data för den här uppdateringen returneras i ett -objekt:

[
  {
    "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"
  }
]

Isolerad virtuell dator

Sök efter väntande uppdateringar för en isolerad virtuell dator. I det här exemplet formateras utdata som en tabell för läsbarhet.

az maintenance update list \
   -g myMaintenanceRg \
   --resource-name myVM \
   --resource-type virtualMachines \
   --provider-name Microsoft.Compute \
   -o table

Dedikerad värd

Så här söker du efter väntande uppdateringar för en dedikerad värd. I det här exemplet formateras utdata som en tabell för läsbarhet. Ersätt värdena för resurserna med dina egna.

az maintenance update list \
   --subscription 1111abcd-1a11-1a2b-1a12-123456789abc \
   -g myHostResourceGroup \
   --resource-name myHost \
   --resource-type hosts \
   --provider-name Microsoft.Compute \
   --resource-parentname myHostGroup \
   --resource-parent-type hostGroups \
   -o table

Tillämpa uppdateringar

Använd az maintenance apply update för att tillämpa väntande uppdateringar. Vid lyckat resultat returnerar det här kommandot JSON som innehåller information om uppdateringen. Det kan ta upp till 2 timmar att tillämpa uppdateringsanrop.

Isolerad virtuell dator

Skapa en begäran om att tillämpa uppdateringar på en isolerad virtuell dator.

az maintenance applyupdate create \
   --subscription 1111abcd-1a11-1a2b-1a12-123456789abc \
   --resource-group myMaintenanceRG \
   --resource-name myVM \
   --resource-type virtualMachines \
   --provider-name Microsoft.Compute

Dedikerad värd

Tillämpa uppdateringar på en dedikerad värd.

az maintenance applyupdate create \
   --subscription 1111abcd-1a11-1a2b-1a12-123456789abc \
   --resource-group myHostResourceGroup \
   --resource-name myHost \
   --resource-type hosts \
   --provider-name Microsoft.Compute \
   --resource-parent-name myHostGroup \
   --resource-parent-type hostGroups

Kontrollera statusen för att tillämpa uppdateringar

Du kan kontrollera förloppet för uppdateringarna med hjälp av az maintenance applyupdate get.

Du kan använda default som uppdateringsnamn för att se resultat för den senaste uppdateringen eller ersätta myUpdateName med namnet på uppdateringen som returnerades när du körde 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 är den tidpunkt då uppdateringen slutfördes, antingen initierad av dig eller av plattformen om självunderhållsfönstret inte användes. Om en uppdatering aldrig har tillämpats via underhållskontrollen visas standardvärdet.

Isolerad virtuell dator

az maintenance applyupdate get \
   --resource-group myMaintenanceRG \
   --resource-name myVM \
   --resource-type virtualMachines \
   --provider-name Microsoft.Compute \
   --apply-update-name default 

Dedikerad värd

az maintenance applyupdate get \
   --subscription 1111abcd-1a11-1a2b-1a12-123456789abc \ 
   --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

Ta bort en underhållskonfiguration

Använd az maintenance configuration delete för att ta bort en underhållskonfiguration. Om du tar bort konfigurationen tas underhållskontrollen bort från de associerade resurserna.

az maintenance configuration delete \
   --subscription 1111abcd-1a11-1a2b-1a12-123456789abc \
   -g myResourceGroup \
   --resource-name myConfig

Nästa steg

Mer information finns i Underhåll och uppdateringar.