Gebeurtenissen vóór en na beheren (preview)

Van toepassing op: ✔️ Virtuele Windows-machines linux-VM's ✔️ ✔️ on-premises azure ✔️ Arc-servers.

Met gebeurtenissen voorafgaand aan en na de gebeurtenissen kunt u door de gebruiker gedefinieerde acties uitvoeren vóór en na de installatie van de planningspatch. In dit artikel wordt beschreven hoe u de gebeurtenissen vóór en na het maken, weergeven en annuleren in Azure Update Manager kunt maken, weergeven en annuleren.

Uw abonnement registreren voor openbare preview

Ga als volgende te werk om uw abonnement zelf te registreren voor openbare preview in Azure Portal:

1. Meld u aan bij Azure Portal en selecteer Meer services.

2. Zoek op de pagina Alle services naar Preview-functies.

3. Zoek en selecteer pre- en postgebeurtenissen op de pagina Preview-functies.

4. Selecteer de functie en selecteer Vervolgens Registreren om het abonnement te registreren.

   

Tijdlijn van planningen voor voor- en postgebeurtenissen

U wordt aangeraden de volgende tabel te doorlopen om inzicht te hebben in de tijdlijn van de planning voor gebeurtenissen vóór en na de gebeurtenissen.

Als een onderhoudsschema bijvoorbeeld is ingesteld op begin om 13:00 uur, met het onderhoudsvenster van 3 uur en 55 minuten voor het bereik van gastonderhoud , volgt u de details:

Tijd	DETAILS
2:19 pm	U kunt de machines bewerken en/of de machines maximaal 40 minuten dynamisch bereiken voordat een geplande patch wordt uitgevoerd met een bijbehorende pregebeurtenis. Als er na deze tijd wijzigingen worden aangebracht in de resources die aan het schema zijn gekoppeld, worden de resources opgenomen in de volgende planningsuitvoering en niet de huidige uitvoering. Opmerking Als u een nieuw schema maakt of een bestaand schema bewerkt met een pregebeurtenis, moet u ten minste 40 minuten voordat het onderhoudsvenster wordt uitgevoerd. Als u in dit voorbeeld om 13:00 uur een schema hebt ingesteld, kunt u het bereik 40 minuten wijzigen voordat de ingestelde tijd om 2,19 uur valt.
Tussen 2:20 en 2:30 uur	De pregebeurtenis wordt geactiveerd, waardoor ten minste 20 minuten te voltooien is voordat de installatie van de patch wordt uitgevoerd. In dit voorbeeld wordt de voorgebeurtenis tussen 2:20 en 2:30 uur gestart.
14:50 uur	De pregebeurtenis heeft ten minste 20 minuten om te voltooien voordat de installatie van de patch begint te worden uitgevoerd. Opmerking : als de pregebeurtenis langer dan 20 minuten wordt uitgevoerd, gaat de installatie van de patch verder, ongeacht de status van de pregebeurtenisuitvoering. - Als u ervoor kiest om de huidige uitvoering te annuleren, kunt u annuleren met behulp van de annulerings-API 10 minuten vóór de planning. In dit voorbeeld kunt u om 2:50 uur annuleren vanuit uw script- of Azure-functiecode. Als de annulerings-API niet kan worden aangeroepen of niet is ingesteld, wordt de patchinstallatie uitgevoerd. In dit voorbeeld moet de pregebeurtenis de taken om 2:50 uur voltooien. Als u ervoor kiest om de huidige uitvoering te annuleren, is de laatste tijd waarop u de annulerings-API kunt aanroepen om 2:50 uur.
15:00 uur	Zoals gedefinieerd in de onderhoudsconfiguratie, wordt de planning op het opgegeven moment geactiveerd. In dit voorbeeld wordt de planning om 13:00 uur geactiveerd.
18:55 uur	De postgebeurtenis wordt geactiveerd nadat het gedefinieerde onderhoudsvenster is voltooid. Als u een korter onderhoudsvenster van 2 uur hebt gedefinieerd, wordt de postonderhoudsgebeurtenis na 2 uur geactiveerd en als het onderhoudsschema is voltooid vóór de opgegeven tijd van 2 uur dat wil, in 1 uur 50 minuten, wordt de postgebeurtenis gestart. Als in dit voorbeeld het onderhoudsvenster is ingesteld op het maximum, is het installatieproces van de patch voltooid om 18:55 uur en als u een korter onderhoudsvenster hebt, wordt het installatieproces van de patch voltooid om 17:00 uur.
19:15	Na de installatie van de patch wordt de post-gebeurtenis gedurende 20 minuten uitgevoerd. In dit voorbeeld wordt de postgebeurtenis gestart om 18:55 en voltooid om 17:15 en als u een korter onderhoudsvenster hebt, wordt de postgebeurtenis om 17:00 uur geactiveerd en om 17:20 uur voltooid.

U wordt aangeraden het volgende te controleren:

• Als u een nieuw schema maakt of een bestaand schema bewerkt met een pregebeurtenis, hebt u ten minste 40 minuten nodig vóór het begin van het onderhoudsvenster (3PM in het bovenstaande voorbeeld) voor de pregebeurtenis, anders leidt dit tot automatische annulering van de huidige geplande uitvoering.
• Voorgebeurtenis wordt 30 minuten geactiveerd voordat de geplande patch wordt uitgevoerd, waardoor de pregebeurtenis minimaal 20 minuten is voltooid.
• Na de gebeurtenis wordt direct uitgevoerd nadat de installatie van de patch is voltooid.
• Als u de huidige patchuitvoering wilt annuleren, gebruikt u de annulerings-API ten minste 10 minuten vóór de onderhoudstijd van het schema.

Gebeurtenissen vooraf configureren en posten volgens een bestaand schema

U kunt gebeurtenissen vooraf en na een bestaande planning configureren en meerdere voor- en postgebeurtenissen toevoegen aan één planning. Voer de volgende stappen uit om een pre- en postgebeurtenis toe te voegen:

1. Meld u aan bij Azure Portal en ga naar Azure Update Manager.

2. Selecteer onder Beheren de optie Machines, Onderhoudsconfiguraties.

3. Selecteer op de pagina Onderhoudsconfiguratie de onderhoudsconfiguratie waaraan u een pre- en postgebeurtenis wilt toevoegen.

4. Selecteer Gebeurtenissen op de geselecteerde pagina Onderhoudsconfiguratie onder Instellingen. U kunt ook onder Overzicht de kaart Een onderhoudsevenement maken selecteren.

   

5. Selecteer +Gebeurtenisabonnement om een pre-/postonderhoudsgebeurtenis te maken.

   

6. Voer op de pagina Gebeurtenisabonnement maken de volgende gegevens in:

   • Geef in de sectie Details van gebeurtenisabonnement een geschikte naam op.

   • Behoud het schema als Event Grid-schema.

   • Geef in de sectie Onderwerpdetails een geschikte naam op voor de naam van het systeemonderwerp.

   • Selecteer in de sectie Gebeurtenistypen filteren op gebeurtenistypen de gebeurtenistypen die u naar het eindpunt of de bestemming wilt pushen. U kunt kiezen tussen preonderhoudsgebeurtenis en postonderhoudsgebeurtenis.

   • Selecteer in de sectie Eindpuntdetails het eindpunt van waaruit u het antwoord wilt ontvangen. Het helpt klanten om hun pre- of postgebeurtenis te activeren.

     

7. Selecteer Maken om de voor- en postgebeurtenissen volgens een bestaand schema te configureren.

Notitie

• De pre- en postgebeurtenis kan alleen worden gemaakt op het configuratieniveau voor gepland onderhoud.
• Systeemonderwerp wordt automatisch gemaakt per onderhoudsconfiguratie en alle gebeurtenisabonnementen zijn gekoppeld aan het systeemonderwerp in EventGrid.
• De uitvoering van de pre- en postgebeurtenis valt buiten het onderhoudsvenster van het schema.

Gebeurtenissen vooraf en posten weergeven

Voer de volgende stappen uit om de gebeurtenissen vooraf en na te plaatsen:

1. Meld u aan bij Azure Portal en ga naar Azure Update Manager.
2. Selecteer onder Beheren de optie Machines, Onderhoudsconfiguraties.
3. Selecteer op de pagina Onderhoudsconfiguratie de onderhoudsconfiguratie waaraan u een pre- en postgebeurtenis wilt toevoegen.
4. Selecteer Overzicht en controleer de onderhoudsevenementen.

   • Selecteer Configureren om er een in te stellen.

   • Als de installatie al is voltooid, ziet u het aantal gebeurtenissen vóór en na de configuratie op de pagina Gebeurtenissen .

     

Voor- en nagebeurtenis verwijderen

Als u gebeurtenissen vóór en na wilt verwijderen, voert u de volgende stappen uit:

1. Meld u aan bij Azure Portal en ga naar Azure Update Manager.

2. Selecteer onder Beheren de optie Machines, Onderhoudsconfiguraties.

3. Selecteer op de pagina Onderhoudsconfiguratie de onderhoudsconfiguratie waaraan u een pre- en postgebeurtenis wilt toevoegen.

4. Selecteer Gebeurtenissen op de geselecteerde pagina Onderhoudsconfiguratie onder Instellingen. U kunt ook onder Overzicht de kaart Een onderhoudsevenement maken selecteren.

5. Selecteer de gebeurtenisnaam die u uit het raster wilt verwijderen.

6. Selecteer Verwijderen op de geselecteerde gebeurtenispagina.

   

Notitie

• Als alle voor- en postgebeurtenissen worden verwijderd uit de onderhoudsconfiguratie, wordt het systeemonderwerp automatisch verwijderd uit EventGrid.
• Het is raadzaam om te voorkomen dat u het systeemonderwerp handmatig verwijdert uit de EventGrid-service.

Een planning van een pregebeurtenis annuleren

Als u het schema wilt annuleren, moet u de annulerings-API aanroepen in uw pregebeurtenis om het annuleringsproces in te stellen dat zich in uw Runbookscript- of Azure-functiecode bevindt. Hier moet u de criteria definiëren vanaf het moment dat de planning moet worden geannuleerd. Het systeem controleert niet en annuleert het schema niet automatisch op basis van de status van de pregebeurtenis.

Er zijn twee soorten annuleringen:

• Annuleren door gebruiker : wanneer u de annulerings-API aanroept vanuit uw script of code.
• Annuleren per systeem : wanneer het systeem de annulerings-API aanroept vanwege een interne fout. Dit gebeurt alleen als het systeem de pregebeurtenis niet kan verzenden naar het eindpunt van de klant dat 30 minuten vóór de geplande patchtaak valt.

Notitie

Als de annulering wordt uitgevoerd door het systeem, wordt de geplande patchtaak geannuleerd vanwege de fout bij het uitvoeren van de pregebeurtenissen door de sytem.

Belangrijk

Als de geplande onderhoudstaak wordt geannuleerd door de gebruiker met behulp van de annulerings-API of door het systeem vanwege een interne fout, wordt de postgebeurtenis, indien geabonneerd, verzonden naar het eindpunt dat door de gebruiker is geconfigureerd.

De annuleringsstatus weergeven

Voer de volgende stappen uit om de annuleringsstatus weer te geven:

1. Ga op de startpagina van Azure Update Manager naar Geschiedenis

2. Selecteer op de onderhoudsuitvoerings-id en kies de uitvoerings-id waarvoor u de status wilt weergeven.

   

U kunt de annuleringsstatus bekijken vanuit het foutbericht in de JSON. De JSON kan worden verkregen via Azure Resource Graph (ARG). De bijbehorende onderhoudsconfiguratie wordt geannuleerd met behulp van de Cancelation-API.

Met de volgende query kunt u de lijst met VM's voor een bepaald schema of een onderhoudsconfiguratie weergeven:

maintenanceresources  
| where type =~ "microsoft.maintenance/maintenanceconfigurations/applyupdates"  
| where properties.correlationId has "/subscriptions/your-s-id/resourcegroups/your-rg-id/providers/microsoft.maintenance/maintenanceconfigurations/mc-name/providers/microsoft.maintenance/applyupdates/"  
| order by name desc

• your-s-id : Abonnements-id waarin onderhoudsconfiguratie met pre- of postgebeurtenis wordt gemaakt
• your-rg-id : Resourcegroepnaam waarin de onderhoudsconfiguratie wordt gemaakt
• mc-name : De naam van de onderhoudsconfiguratie in de voorgebeurtenis wordt gemaakt

Als de onderhoudstaak om welke reden dan ook wordt geannuleerd door het systeem, wordt het foutbericht in de JSON opgehaald uit Azure Resource Graph voor de bijbehorende onderhoudsconfiguratie als gevolg van een storing in het interne platform.

De annulerings-API aanroepen

 C:\ProgramData\chocolatey\bin\ARMClient.exe put https://management.azure.com/<your-c-id-obtained-from-above>?api-version=2023-09-01-preview "{\"Properties\":{\"Status\": \"Cancel\"}}" -Verbose 

Notitie

U moet de correlatie-id die u hebt ontvangen van de bovenstaande ARG-query vervangen en vervangen in de Cancelation-API.

Voorbeeld

  C:\ProgramData\chocolatey\bin\ARMClient.exe put https://management.azure.com/subscriptions/eee2cef4-bc47-4278-b4f8-cfc65f25dfd8/resourcegroups/fp02centraluseuap/providers/microsoft.maintenance/maintenanceconfigurations/prepostdemo7/providers/microsoft.maintenance/applyupdates/20230810085400?api-version=2023-09-01-preview "{\"Properties\":{\"Status\": \"Cancel\"}}" -Verbose

Volgende stappen

• Zie Problemen en tijdelijke oplossingen oplossen
• Voor een overzicht van pre- en postscenario's
• Meer informatie over de algemene scenario's van pre- en postgebeurtenissen