Gebeurtenissen vooraf maken en posten

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

Met voor- en nagebeurtenissen kunt u door de gebruiker gedefinieerde acties uitvoeren vóór en na de geplande onderhoudsconfiguratie. Ga voor meer informatie door de werking van een pre- en postgebeurtenis in Azure Update Manager.

In dit artikel wordt beschreven hoe u pre- en postgebeurtenissen maakt in Azure Update Manager.

Event Grid in onderhoudsconfiguraties plannen

Azure Update Manager maakt gebruik van Event Grid om pre- en postgebeurtenissen te maken en te beheren. Zie het overzicht van Event Grid voor meer informatie. Als u een gebeurtenis wilt activeren vóór of na een planningsonderhoudsvenster, hebt u het volgende nodig:

1. Onderhoudsconfiguratie plannen: u kunt pre- en postgebeurtenissen maken voor een planningsonderhoudsconfiguratie in Azure Update Manager. Zie updates plannen met behulp van onderhoudsconfiguraties voor meer informatie.
2. Actie die moet worden uitgevoerd in de pre- of postgebeurtenis : u kunt de gebeurtenis-handlers (eindpunten) die door Event Grid worden ondersteund, gebruiken om acties of taken te definiëren. Hier volgen voorbeelden van het maken van Azure Automation-runbooks via Webhooks en Azure Functions. Binnen deze gebeurtenis-handlers/eindpunten moet u de acties definiëren die moeten worden uitgevoerd als onderdeel van voorafgaande en postgebeurtenissen.
   1. Webhook Maak een PowerShell 7.2-runbook en koppel het runbook aan een webhook. -
   2. Een Azure-functie - maken.
3. Pre- en postgebeurtenis : u kunt de stappen volgen die worden gedeeld in de volgende sectie om een pre- en postgebeurtenis te maken voor het plannen van de onderhoudsconfiguratie. Zie De termen van Event Grid voor meer informatie over de termen die worden gebruikt op het tabblad Basisbeginselen van Event Grid.

Een pre- en postgebeurtenis maken

Gebeurtenissen vooraf maken en posten tijdens het maken van een nieuwe configuratie voor planningsonderhoud

Azure-portal gebruiken

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

2. Selecteer Machines onder Beheren.

3. Selecteer Updates plannen op het lint bovenaan.

4. Selecteer op de pagina Onderhoudsconfiguratie maken het tabblad Gebeurtenissen .

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

6. Voer op de pagina Gebeurtenisabonnement toevoegen de volgende gegevens in: Geef in de sectie Details van gebeurtenisabonnement een geschikte naam op.

   • Behoud het schema als Event Grid-schema.
   • Voer de naam van het systeemonderwerp in voor de eerste gebeurtenis die u in deze onderhoudsconfiguratie maakt. Dezelfde naam van het systeemonderwerp wordt automatisch ingevuld voor de volgende gebeurtenissen.
   • Selecteer in de sectie Gebeurtenistypen filteren op gebeurtenistypen de gebeurtenistypen die u naar het eindpunt of de bestemming wilt pushen. U kunt preonderhoudsgebeurtenis of postonderhoudsgebeurtenis of beide selecteren. Zie Azure-gebeurtenistypen voor meer informatie over gebeurtenistypen die specifiek zijn voor het plannen van onderhoudsconfiguraties.
   • Selecteer in de sectie Eindpuntdetails het eindpunt van waaruit u het antwoord wilt ontvangen.

7. Selecteer Toevoegen om de voor- en postgebeurtenissen voor de planning te maken bij het maken ervan.

   

Notitie

In de bovenstaande stroom zijn Webhook en Azure Functions de twee gebeurtenis-handlers/eindpunten waaruit u kunt kiezen. Wanneer u Toevoegen selecteert, wordt het gebeurtenisabonnement niet gemaakt, maar toegevoegd aan de onderhoudsconfiguratie. Gebeurtenisabonnement wordt gemaakt samen met de planningsonderhoudsconfiguratie.

PowerShell gebruiken

1. Maak een onderhoudsconfiguratie door de stappen te volgen die hier worden vermeld.

2.  # Obtain the Maintenance Configuration ID from Step 1 and assign it to MaintenanceConfigurationResourceId variable  
   
    $MaintenanceConfigurationResourceId = "/subscriptions/<subId>/resourceGroups/<Resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<Maintenance configuration Name>"
   
    # Use the same Resource Group that you used to create maintenance configuration in Step 1
   
    $ResourceGroupForSystemTopic = "<Resource Group for System Topic>"
   
    $SystemTopicName = "<System topic name>"
   
    $TopicType = "Microsoft.Maintenance.MaintenanceConfigurations"
   
    $SystemTopicLocation = "<System topic location>"
   
    # System topic creation
   
    New-AzEventGridSystemTopic -ResourceGroupName $ResourceGroupForSystemTopic -Name $SystemTopicName -Source $MaintenanceConfigurationResourceId -TopicType $TopicType -Location $SystemTopicLocation
   
    # Event subscription creation
   
    $IncludedEventTypes = @("Microsoft.Maintenance.PreMaintenanceEvent")
   
    # Webhook
   
    $EventSubscriptionName = "PreEventWebhook"
   
    $PreEventWebhookEndpoint = "<Webhook URL>"
   
    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Endpoint $PreEventWebhookEndpoint -IncludedEventType $IncludedEventTypes
   
    # Azure Function
   
    $dest = New-AzEventGridAzureFunctionEventSubscriptionDestinationObject -ResourceId "<Azure Function Resource Id>"
   
    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Destination $dest -IncludedEventType $IncludedEventTypes
   
   

CLI gebruiken

1. Maak een onderhoudsconfiguratie door de stappen te volgen die hier worden vermeld.

2. 
    SystemTopicName="<System topic name> 
   
    # Use the same Resource Group that you used to create maintenance configuration in Step 1
   
    ResourceGroupName="<Resource Group mentioned in Step 1>"
   
    # Obtain the Maintenance Configuration ID from Step 1 and assign it to Source variable
   
    Source="/subscriptions/<subId>/resourceGroups/<Resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<Maintenance configuration Name>"
   
    TopicType="Microsoft.Maintenance.MaintenanceConfigurations"
   
    Location="<System topic location> "
   
    # System topic creation
   
    az eventgrid system-topic create --name $SystemTopicName --resource-group $ResourceGroupName --source $Source --topic-type $TopicType --location $Location
   
    # Event subscription creation
   
    IncludedEventTypes='("Microsoft.Maintenance.PreMaintenanceEvent")'
   
    # Webhook
   
    az eventgrid system-topic event-subscription create --name "<Event subscription name>" --resource-group $ResourceGroupName --system-topic-name $SystemTopicName --endpoint-type webhook --endpoint "<webhook URL>" --included-event-types IncludedEventTypes
   
    # Azure Function
   
    az eventgrid system-topic event-subscription create –name "<Event subscription name>" --resource-group $ResourceGroupName --system-topic-name $SystemTopicName --endpoint-type azurefunction --endpoint "<Azure Function ResourceId>" --included-event-types IncludedEventTypes
   
   

API gebruiken

1. Maak een onderhoudsconfiguratie door de stappen te volgen die hier worden vermeld.

2. # Systeemonderwerp maken Meer informatie

   PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>?api-version=2022-06-15
   

   Aanvraagtekst:

   {
     "properties": {
       "source": "/subscriptions/<subscription Id>/resourceGroups/<resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<maintenance configuration name> ",
       "topicType": "Microsoft.Maintenance.MaintenanceConfigurations"
     },
     "location": "<location>"
   }
   

   # Gebeurtenisabonnement maken Meer informatie

   Toegestane gebeurtenistypen - Microsoft.Maintenance.PreMaintenanceEvent, Microsoft.Maintenance.PostMaintenanceEvent

   Webhook

   PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15
   

   Aanvraagtekst:

   {
     "properties": {
       "destination": {
         "endpointType": "WebHook",
         "properties": {
           "endpointUrl": "<Webhook URL>"
         }
       },
       "filter": {
         "includedEventTypes": [
           "Microsoft.Maintenance.PreMaintenanceEvent"
         ]
       }
     }
   }
   

   Azure-functie

   PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15
   

   Hoofdtekst van aanvraag

   {
       "properties": {
           "destination": {
               "endpointType": "AzureFunction",
               "properties": {
                   "resourceId": "<Azure Function Resource Id>"
               }
           }
       },
       "filter": {
           "includedEventTypes": [
               "Microsoft.Maintenance.PostMaintenanceEvent"
           ]
       }
   }
   

   ---

Gebeurtenissen vooraf maken en posten op basis van een bestaande planningsonderhoudsconfiguratie

Azure-portal gebruiken

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. Zie Azure-gebeurtenistypen voor meer informatie over gebeurtenistypen die specifiek zijn voor het plannen van onderhoudsconfiguraties.

   • Selecteer in de sectie Eindpuntdetails het eindpunt van waaruit u het antwoord wilt ontvangen.

     

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

PowerShell gebruiken

    $MaintenanceConfigurationResourceId = "/subscriptions/<subId>/resourceGroups/<Resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<Maintenance configuration Name>"

    $ResourceGroupForSystemTopic = "<Resource Group for System Topic>"

    $SystemTopicName = "<System topic name>"

    $TopicType = "Microsoft.Maintenance.MaintenanceConfigurations"

    $SystemTopicLocation = "<System topic location>"

    # System topic creation

    New-AzEventGridSystemTopic -ResourceGroupName $ResourceGroupForSystemTopic -Name $SystemTopicName -Source $MaintenanceConfigurationResourceId -TopicType $TopicType -Location $SystemTopicLocation

    # Event subscription creation

    $IncludedEventTypes = @("Microsoft.Maintenance.PreMaintenanceEvent")

    # Webhook

    $EventSubscriptionName = "PreEventWebhook"

    $PreEventWebhookEndpoint = "<Webhook URL>"

    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Endpoint $PreEventWebhookEndpoint -IncludedEventType $IncludedEventTypes

    # Azure Function

    $dest = New-AzEventGridAzureFunctionEventSubscriptionDestinationObject -ResourceId "<Azure Function Resource Id>"

    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Destination $dest -IncludedEventType $IncludedEventTypes

CLI gebruiken

   SystemTopicName="<System topic name> 

   ResourceGroupName="<Resource Group for System Topic>"

   Source="/subscriptions/<subId>/resourceGroups/<Resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<Maintenance configuration Name>"

    TopicType="Microsoft.Maintenance.MaintenanceConfigurations"

    Location="<System topic location> "

   # System topic creation

    az eventgrid system-topic create --name $SystemTopicName --resource-group $ResourceGroupName --source $Source --topic-type $TopicType --location $Location

   # Event subscription creation

    IncludedEventTypes='("Microsoft.Maintenance.PreMaintenanceEvent")'

   # Webhook

    az eventgrid system-topic event-subscription create --name "<Event subscription name>" --resource-group $ResourceGroupName --system-topic-name $SystemTopicName --endpoint-type webhook --endpoint "<webhook URL>" --included-event-types IncludedEventTypes

   # Azure Function

    az eventgrid system-topic event-subscription create –name "<Event subscription name>" --resource-group $ResourceGroupName --system-topic-name $SystemTopicName --endpoint-type azurefunction --endpoint "<Azure Function ResourceId>" --included-event-types IncludedEventTypes

API gebruiken

# Systeemonderwerp maken Meer informatie

PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>?api-version=2022-06-15

Aanvraagtekst:

{
  "properties": {
    "source": "/subscriptions/<subscription Id>/resourceGroups/<resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<maintenance configuration name> ",
    "topicType": "Microsoft.Maintenance.MaintenanceConfigurations"
  },
  "location": "<location>"
}

# Gebeurtenisabonnement maken Meer informatie

Toegestane gebeurtenistypen - Microsoft.Maintenance.PreMaintenanceEvent, Microsoft.Maintenance.PostMaintenanceEvent

Webhook

PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15

Aanvraagtekst:

{
  "properties": {
    "destination": {
      "endpointType": "WebHook",
      "properties": {
        "endpointUrl": "<Webhook URL>"
      }
    },
    "filter": {
      "includedEventTypes": [
        "Microsoft.Maintenance.PreMaintenanceEvent"
      ]
    }
  }
}

Azure-functie

PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15

Hoofdtekst van aanvraag

{
    "properties": {
        "destination": {
            "endpointType": "AzureFunction",
            "properties": {
                "resourceId": "<Azure Function Resource Id>"
            }
        }
    },
    "filter": {
        "includedEventTypes": [
            "Microsoft.Maintenance.PostMaintenanceEvent"
        ]
    }
}

Volgende stappen

• Raadpleeg hier voor een overzicht van gebeurtenissen vóór en na gebeurtenissen in Azure Update Manager.
• Voor meer informatie over het beheren van pre- en postgebeurtenissen of het annuleren van een planningsuitvoering, raadpleegt u pre- en post-onderhoudsconfiguratiegebeurtenissen.
• Raadpleeg hier voor meer informatie over het gebruik van pre- en postgebeurtenissen om uw VM's in en uit te schakelen met behulp van Webhooks.
• Raadpleeg hier voor meer informatie over het gebruik van pre- en postgebeurtenissen om uw VM's in en uit te schakelen met behulp van Azure Functions.