Skapa för- och efterhändelser

Gäller för: ✔️ Virtuella Windows-datorer ✔️ med Virtuella Linux-datorer ✔️ Lokal miljö ✔️ Azure Arc-aktiverade servrar ✔️ Virtuella Azure-datorer.

Med för- och efterhändelser kan du köra användardefinierade åtgärder före och efter den schemalagda underhållskonfigurationen. Mer information finns i arbetet med en för- och efterhändelse i Azure Update Manager.

Den här artikeln beskriver hur du skapar för- och efterhändelser i Azure Update Manager.

Event Grid i schemalägg underhållskonfigurationer

Azure Update Manager använder Event Grid för att skapa och hantera för- och efterhändelser. Mer information finns i översikten över Event Grid. För att utlösa en för- eller efterhändelse antingen före eller efter ett schemaunderhållsfönster behöver du följande:

1. Schemalägg underhållskonfiguration – Du kan skapa för- och efterhändelser för en schemaunderhållskonfiguration i Azure Update Manager. Mer information finns i Schemalägga uppdateringar med hjälp av underhållskonfigurationer.
2. Åtgärd som ska utföras i för- eller efterhändelsen – Du kan använda händelsehanterare (slutpunkter) som stöds av Event Grid för att definiera åtgärder eller uppgifter. Här är exempel på hur du skapar Azure Automation Runbooks via Webhooks och Azure Functions. Inom dessa händelsehanterare/slutpunkter måste du definiera de åtgärder som ska utföras som en del av för- och efterhändelser.
   1. Webhook Skapa en PowerShell 7.2 Runbook och länka Runbook till en webhook. -
   2. Azure-funktion - Skapa en Azure-funktion.
3. Före och efter händelse – Du kan följa stegen som delas i följande avsnitt för att skapa en för- och efterhändelse för schemaunderhållskonfiguration. Mer information om de termer som används på fliken Grundläggande i Event Grid finns villkor för Event Grid.

Skapa en för- och efterhändelse

Skapa för- och efterhändelser när du skapar en ny schemaunderhållskonfiguration

Med Azure Portal

1. Logga in på Azure-portalen och gå till Azure Uppdateringshanteraren.

2. Under Hantera väljer du Datorer.

3. Välj Schemalägg uppdateringar från menyfliksområdet längst upp.

4. På sidan Skapa en underhållskonfiguration väljer du fliken Händelser .

5. Välj +Händelseprenumeration för att skapa för-/efterhändelse.

6. På sidan Lägg till händelseprenumeration anger du följande information: Ange ett lämpligt namn i avsnittet Information om händelseprenumeration.

   • Behåll schemat som Event Grid-schema.
   • Ange systemämnesnamnet för den första händelsen som du skapar i den här underhållskonfigurationen. Samma systemämnesnamn fylls i automatiskt för de efterföljande händelserna.
   • I avsnittet Händelsetyper filtrerar du till händelsetyper och väljer de händelsetyper som du vill push-överföras till slutpunkten eller målet. Du kan välja antingen Händelse före underhåll eller Händelse efter underhåll eller båda. Mer information om händelsetyper som är specifika för schemaläggning av underhållskonfigurationer finns i Azure-händelsetyper.
   • I avsnittet Slutpunktsinformation väljer du den slutpunkt där du vill ta emot svaret från.

7. Välj Lägg till för att skapa för- och efterhändelser för schemat när det skapas.

   

Kommentar

I ovanstående flöde är Webhook och Azure Functions de två händelsehanterare/slutpunkter som du kan välja mellan. När du väljer Lägg till skapas inte händelseprenumerationen utan läggs till i underhållskonfigurationen. Händelseprenumeration skapas tillsammans med schemaunderhållskonfigurationen.

Med PowerShell

1. Skapa en underhållskonfiguration genom att följa stegen som anges här.

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>"
   
    $dest = New-AzEventGridWebHookEventSubscriptionDestinationObject -EndpointUrl $PreEventWebhookEndpoint
   
    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Endpoint $PreEventWebhookEndpoint -IncludedEventType $IncludedEventTypes -Destination $dest
   
    # Azure Function
   
    $dest = New-AzEventGridAzureFunctionEventSubscriptionDestinationObject -ResourceId "<Azure Function Resource Id>"
   
    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Destination $dest -IncludedEventType $IncludedEventTypes
   
   

Använda CLI

1. Skapa en underhållskonfiguration genom att följa stegen som anges här.

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
   
   

Använda API

1. Skapa en underhållskonfiguration genom att följa stegen som anges här.

2. # Skapa systemämne Läs mer

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

   Begärandetext:

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

   # Skapa händelseprenumeration Läs mer

   Tillåtna händelsetyper – 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
   

   Begärandetext:

   {
     "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
   

   Begärandetext

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

   ---

Skapa för- och efterhändelser i en befintlig schemaunderhållskonfiguration

Med Azure Portal

1. Logga in på Azure-portalen och gå till Azure Uppdateringshanteraren.

2. Under Hantera väljer du Datorer, Underhållskonfigurationer.

3. På sidan Underhållskonfiguration väljer du den underhållskonfiguration som du vill lägga till en för- och efterhändelse till.

4. På den valda sidan Underhållskonfiguration går du till Inställningar och väljer Händelser. Du kan också välja kortet Skapa en underhållshändelse under Översikt.

   

5. Välj +Händelseprenumeration för att skapa händelse före/efter underhåll.

   

6. På sidan Skapa händelseprenumeration anger du följande information:

   • I avsnittet Information om händelseprenumeration anger du ett lämpligt namn.

   • Behåll schemat som Event Grid-schema.

   • I avsnittet Ämnesinformation anger du ett lämpligt namn för systemämnesnamnet.

   • I avsnittet Händelsetyper filtrerar du till händelsetyper och väljer de händelsetyper som du vill push-överföras till slutpunkten eller målet. Du kan välja mellan Händelse före underhåll och Händelse efter underhåll. Mer information om händelsetyper som är specifika för schemaläggning av underhållskonfigurationer finns i Azure-händelsetyper.

   • I avsnittet Slutpunktsinformation väljer du slutpunkten där du vill ta emot svaret från.

     

7. Välj Skapa för att konfigurera för- och efterhändelser enligt ett befintligt schema.

Med 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>"

    $dest = New-AzEventGridWebHookEventSubscriptionDestinationObject -EndpointUrl $PreEventWebhookEndpoint

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

    # Azure Function

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

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

Använda 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

Använda API

# Skapa systemämne Läs mer

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

Begärandetext:

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

# Skapa händelseprenumeration Läs mer

Tillåtna händelsetyper – 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

Begärandetext:

{
  "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

Begärandetext

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

Nästa steg

• En översikt över för- och efterhändelser i Azure Update Manager finns här.
• Information om hur du hanterar för- och efterhändelser eller hur du avbryter en schemakörning finns i konfigurationshändelser före och efter underhåll.
• Mer information om hur du använder för- och efterhändelser för att aktivera och inaktivera dina virtuella datorer med hjälp av Webhooks finns här.
• Mer information om hur du använder för- och efterhändelser för att aktivera och inaktivera dina virtuella datorer med hjälp av Azure Functions finns här.