Zelfstudie: Azure Automation integreren met Event Grid en Microsoft-Teams

In deze zelfstudie leert u het volgende:

  • Een voorbeeldrunbook importeren in Event Grid.
  • Een optionele Microsoft Teams-webhook maken.
  • Een webhook voor het runbook maken.
  • Hiermee wordt een Event Grid-abonnement gemaakt.
  • Een virtuele machine maken die het runbook activeert.

Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.

Vereisten

Belangrijk

Als u deze Azure-functie van PowerShell wilt gebruiken, moet de AzureRM-module zijn geïnstalleerd. Dit is een oudere module die alleen beschikbaar is voor Windows PowerShell 5.1, dat geen nieuwe functies meer ontvangt. De modules Az en AzureRM zijn niet compatibel als ze voor dezelfde versies van PowerShell worden geïnstalleerd. Als u beide versies nodig hebt:

  1. De Az-module verwijderen vanuit een PowerShell 5.1-sessie.
  2. De AzureRM-module installeren vanuit een PowerShell 5.1-sessie.
  3. PowerShell Core 6.x of nieuwer downloaden en installeren.
  4. De Az-module installeren in een PowerShell Core-sessie.

Voor het volgen van deze zelfstudie is een Azure Automation-account vereist voor het opslaan van het runbook dat wordt geactiveerd vanuit het Azure Event Grid-abonnement.

Een voorbeeldrunbook importeren in Event Grid

  1. Selecteer uw Automation-account en selecteer de pagina Runbooks.

    Runbooks selecteren

  2. Selecteer de knop Bladeren in galerie.

  3. Zoek naar Event Grid en selecteer Azure Automation integreren met Event Grid.

    Galerierunbook importeren

  4. Selecteer Importeren en noem het runbook Watch VMWrite.

  5. Nadat het is geïmporteerd, selecteert u Bewerken om de runbookbron weer te geven.

  6. Werk de regel 74 in het script bij voor het gebruik van Tag in plaats van Tags.

    Update-AzureRmVM -ResourceGroupName $VMResourceGroup -VM $VM -Tag $Tag | Write-Verbose
    
  7. Selecteer de knop Publiceren.

Een optionele Microsoft Teams-webhook maken

  1. Selecteer in Microsoft Teams Meer opties naast de naam van het kanaal, en selecteer vervolgens Connectors.

    Microsoft Teams-connectors

  2. Blader door de lijst met connectors naar Binnenkomende webhook en selecteer Toevoegen.

  3. Voer AzureAutomationIntegration in voor de naam en selecteer Maken.

  4. Kopieer de webhook-URL naar het klembord en sla deze op. De webhook-URL wordt gebruikt voor het verzenden van gegevens naar Microsoft Teams.

  5. Selecteer Gereed om de webhook op te slaan.

Een webhook voor het runbook maken

  1. Open het runbook Watch VMWrite.

  2. Selecteer Webhooks en selecteer de knop Webhook toevoegen.

  3. Voer WatchVMEventGrid in voor de naam. Kopieer de URL naar het klembord en sla deze op.

    Webhooknaam configureren

  4. Selecteer Parameters en runinstellingen configureren en voer de URL van de Microsoft Teams-webhook voor CHANNELURL in. Laat WEBHOOKDATA leeg.

    Webhookparameters configureren

  5. Selecteer Maken om de Automation-runbookwebhook te maken.

Een Event Grid-abonnement maken

  1. Selecteer op de overzichtspagina Automation-Account de optie Event Grid.

    Event Grid selecteren

  2. Klik op + Gebeurtenisabonnement.

  3. Configureer het abonnement met de volgende gegevens:

    1. Selecteer Azure-abonnementen voor Onderwerptype.

    2. Schakel het selectievakje Abonneren op alle gebeurtenistypen uit.

    3. Voer AzureAutomation in voor de naam.

    4. Schakel in de vervolgkeuzelijst Gedefinieerde gebeurtenistypen alle opties uit behalve Schrijven resource gelukt.

      Notitie

      In Azure Resource Manager wordt momenteel geen onderscheid gemaakt tussen Maken en Bijwerken. Hierdoor kan het implementeren van deze zelfstudie voor alle gebeurtenissen van Microsoft.Resources.ResourceWriteSuccess leiden tot een grote hoeveelheid aanroepen in uw Azure-abonnement.

    5. Selecteer Webhook voor Eindpunttype.

    6. Klik op Een eindpunt selecteren. Plak op de pagina Webhook selecteren die wordt geopend, de webhook-URL die u hebt gemaakt voor het runbook Watch-VMWrite.

    7. Voer onder FILTERS het abonnement en de resourcegroep in waarin u wilt zoeken naar de nieuwe virtuele machines die zijn gemaakt. Dit ziet er als volgt uit: /subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachines

  4. Selecteer Maken om het Event Grid-abonnement op te slaan.

Een virtuele machine maken die het runbook activeert

  1. Maak een nieuwe virtuele machine in de resourcegroep die u hebt opgegeven in het voorvoegselfilter van het Event Grid-abonnement.

  2. Het VMWrite-runbook moet worden aangeroepen en er moet een nieuwe tag worden toegevoegd aan de virtuele machine.

    VM-tag

  3. Er wordt een nieuw bericht verzonden naar het Microsoft Teams-kanaal.

    Microsoft Teams-melding

Volgende stappen

In deze zelfstudie stelt u de integratie tussen Event Grid en Automation in. U hebt geleerd hoe u:

  • Een voorbeeldrunbook importeren in Event Grid.
  • Een optionele Microsoft Teams-webhook maken.
  • Een webhook voor het runbook maken.
  • Hiermee wordt een Event Grid-abonnement gemaakt.
  • Een virtuele machine maken die het runbook activeert.