Erstellen von Vor- und Nachbereitungsereignissen

Gilt für: ✔️ Windows-VMs ✔️ Linux-VMs ✔️ Lokale Umgebung ✔️ Azure Arc-fähige Server ✔️ Azure-VMs.

Vor- und Nachbereitungsereignisse ermöglichen es Ihnen, benutzerdefinierte Aktionen vor und nach der geplanten Konfiguration der geplanten Wartung auszuführen. Weitere Informationen erhalten Sie in den Arbeiten eines Vor- und Nachbereitungsereignisses in Azure Update Manager.

In diesem Artikel erfahren Sie, wie Sie Vor- und Nachbereitungsereignisse in Azure Update Manager erstellen.

Event Grid in Wartungszeitplankonfigurationen

Azure Update Manager nutzt Event Grid zum Erstellen und Verwalten von Vor- und Nachbereitungsereignissen. Weitere Informationen hierzu erfahren Sie in der Übersicht über Event Grid. Um ein Ereignis vor oder nach einem Wartungsfenster für einen Zeitplan auszulösen, benötigen Sie Folgendes:

1. Planen der Wartungskonfiguration: Sie können Vor- und Nachbereitungsereignisse für eine Wartungszeitplankonfiguration in Azure Update Manager erstellen. Weitere Informationen finden Sie unter Planen von Updates mithilfe von Wartungskonfigurationen.
2. Aktion, die als Vor- oder Nachbereitungsereignis ausgeführt werden soll: Sie können die Ereignishandler (Endpunkte) verwenden, die von Event Grid unterstützt werden, um Aktionen oder Tasks zu definieren. Hier finden Sie Beispiele zum Erstellen von Azure Automation Runbooks über Webhooks und Azure Functions. Innerhalb dieser Ereignishandler/Endpunkte müssen Sie die Aktionen definieren, die als Teil von Vor- und Nachbereitungsereignissen ausgeführt werden sollen.
   1. Webhook - Erstellen Sie ein Runbook mit PowerShell 7.2 und verknüpfen Sie das Runbook mit einem Webhook.
   2. Azure Functions - Erstellen Sie eine Azure-Funktion.
3. Vor- und Nachbereitungsereignis: Sie können die im folgenden Abschnitt angegebenen Schritte ausführen, um ein Vor- und Nachbereitungsereignis für die Planung der Wartungskonfiguration zu erstellen. Weitere Informationen zu den Begriffen, die auf der Registerkarte „Allgemeine Informationen“ von Event Grid verwendet werden, finden Sie unter Event Grid-Begriffe.

Erstellen eines Vor- und Nachbereitungsereignisses

Erstellen von Vor- und Nachbereitungsereignissen beim Erstellen einer neuen Konfiguration für eine geplante Wartung

Über das Azure-Portal

1. Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Azure Update Manager.

2. Wählen Sie unter Verwalten die Option Computer aus.

3. Wählen Sie oben im Menüband Updates planen aus.

4. Wählen Sie auf der Seite Wartungskonfiguration erstellen die Registerkarte Ereignisse (Events) aus.

5. Wählen Sie + Ereignisabonnement aus, um ein Vor- oder Nachbereitungsereignis zu erstellen.

6. Geben Sie auf der Seite Ereignisabonnement hinzufügen die folgenden Details ein: Geben Sie im Abschnitt Details zum Ereignisabonnement einen geeigneten Namen ein.

   • Behalten Sie für das Schema die Option Event Grid-Schema bei.
   • Geben Sie den Namen des Systemthemas für das erste Ereignis ein, das Sie in dieser Wartungskonfiguration erstellen. Derselbe Name des Systemthemas wird automatisch für die folgenden Ereignisse eingetragen.
   • Wählen Sie im Abschnitt Ereignistypen unter Nach Ereignistypen filtern die Ereignistypen aus, die an den Endpunkt oder an das Ziel gepusht werden sollen. Sie können entweder Ereignis vor der Wartung oder Ereignis nach der Wartung oder beides auswählen. Weitere Informationen zu Ereignistypen, die spezifisch für Konfigurationen von geplanten Wartungen sind, finden Sie unter Azure-Ereignistypen.
   • Wählen Sie im Abschnitt Endpunktdetails den Endpunkt aus, von dem Sie die Antwort empfangen möchten.

7. Wählen Sie Hinzufügen aus, um die Vor- und Nachbereitungsereignisse bei der Erstellung des Zeitplans zu erstellen.

   

Hinweis

Im obigen Flow sind Webhook und Azure Functions die beiden Ereignishandler/Endpunkte, aus denen Sie auswählen können. Wenn Sie Hinzufügen auswählen, wird das Ereignisabonnement nicht erstellt, sondern zur Wartungskonfiguration hinzugefügt. Das Ereignisabonnement wird zusammen mit der Konfiguration für die geplante Wartung erstellt.

Mithilfe von PowerShell

1. Erstellen Sie eine Wartungskonfiguration, indem Sie die hier aufgeführten Schritte ausführen.

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
   
   

Verwenden von CLI

1. Erstellen Sie eine Wartungskonfiguration, indem Sie die hier aufgeführten Schritte ausführen.

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
   
   

Mit der API

1. Erstellen Sie eine Wartungskonfiguration, indem Sie die hier aufgeführten Schritte ausführen.

2. # Erstellung des Systemthemas Weitere Informationen

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

   Anforderungstext:

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

   # Erstellung des Ereignisabonnements Weitere Informationen

   Zulässige Ereignistypen: 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
   

   Anforderungstext:

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

   Azure-Funktion

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

   Anforderungstext

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

   ---

Erstellen von Vor- und Nachbereitungsereignissen für eine bestehende Konfiguration für eine geplante Wartung

Über das Azure-Portal

1. Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Azure Update Manager.

2. Wählen Sie unter Verwalten erst Computer und dann Wartungskonfigurationen aus.

3. Wählen Sie auf der Seite Wartungskonfiguration die Wartungskonfiguration aus, der Sie ein Vor- und Nachbereitungsereignis hinzufügen möchten.

4. Wählen Sie auf der ausgewählten Seite Wartungskonfiguration unter Einstellungen die Option Ereignisse (Events) aus. Wählen Sie alternativ unter Übersicht die Karte Wartungsereignis erstellen aus.

   

5. Wählen Sie + Ereignisabonnement aus, um ein Ereignis vor oder nach der Wartung zu erstellen.

   

6. Geben Sie auf der Seite Ereignisabonnement erstellen die folgenden Details ein:

   • Geben Sie im Abschnitt Details zum Ereignisabonnement einen geeigneten Namen an.

   • Behalten Sie für das Schema die Option Event Grid-Schema bei.

   • Geben Sie im Abschnitt Themendetails unter Name des Systemthemas einen geeigneten Namen an.

   • Wählen Sie im Abschnitt Ereignistypen unter Nach Ereignistypen filtern die Ereignistypen aus, die an den Endpunkt oder an das Ziel gepusht werden sollen. Sie können zwischen Ereignis vor der Wartung und Ereignis nach der Wartung wählen. Weitere Informationen zu Ereignistypen, die spezifisch für Konfigurationen von geplanten Wartungen sind, finden Sie unter Azure-Ereignistypen.

   • Wählen Sie im Abschnitt Details zum Endpunkt den Endpunkt aus, von dem Sie die Antwort empfangen möchten.

     

7. Wählen Sie Erstellen aus, um die Vor- oder Nachbereitungsereignisse für einen bereits vorhandenen Zeitplan zu konfigurieren.

Mithilfe von PowerShell

    $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

Verwenden von CLI

   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

Mit der API

# Erstellung des Systemthemas Weitere Informationen

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

Anforderungstext:

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

# Erstellung des Ereignisabonnements Weitere Informationen

Zulässige Ereignistypen: 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

Anforderungstext:

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

Azure-Funktion

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

Anforderungstext

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

Nächste Schritte

• Eine Übersicht über Vor- und Nachbereitungsereignisse in Azure Update Manager finden Sie hier.
• Informationen zum Verwalten von Vor- und Nachbereitungsereignissen oder zum Abbrechen einer geplanten Ausführung finden Sie unter Vor- und Nachbereitungsereignisse für eine Wartungskonfiguration.
• Informationen zum Aktivieren und Deaktivieren Ihrer VMs mithilfe von Vor- und Nachbereitungsereignissen sowie Webhooks finden Sie hier.
• Informationen zum Aktivieren und Deaktivieren Ihrer VMs mithilfe von Vor- und Nachbereitungsereignissen sowie Azure Functions finden Sie hier.