Tutorial: Integration von Azure Automation mit Event Grid und Microsoft Teams

In diesem Tutorial lernen Sie, wie die folgenden Aufgaben ausgeführt werden:

• Importieren Sie ein Event Grid-Beispielrunbook.
• Erstellen Sie einen optionalen Microsoft Teams-Webhook.
• Erstellen Sie einen Webhook für das Runbook.
• Erstellen Sie ein Event Grid-Abonnement.
• Erstellen Sie einen virtuellen Computer, der das Runbook auslöst.

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Voraussetzungen

Wichtig

Die Verwendung dieser Azure-Funktion mit PowerShell erfordert, dass Sie das AzureRM-Modul installiert haben. Dies ist ein älteres Modul, das nur für Windows PowerShell 5.1 verfügbar ist und keine neuen Funktionen mehr erhält. Die Az- und AzureRM-Module sind nicht kompatibel, wenn sie für dieselben PowerShell-Versionen installiert werden. Wenn Sie beide Versionen benötigen:

1. Deinstallieren Sie das Az-Modul über eine PowerShell 5.1-Sitzung.
2. Deinstallieren Sie das AzureRM-Modul über eine PowerShell 5.1-Sitzung.
3. Laden Sie mindestens PowerShell Core 6.x herunter, und installieren Sie die Anwendung.
4. Installieren Sie das Az-Modul in einer PowerShell Core-Sitzung.

Um dieses Tutorial abzuschließen, ist ein Azure Automation-Konto erforderlich, um das vom Azure Event Grid-Abonnement ausgelöste Runbook aufzunehmen.

• Das AzureRM.Tags-Modul muss in Ihr Automation-Konto geladen werden. Informationen zum Importieren von Modulen in Azure Automation finden Sie unter Importieren von Modulen in Azure Automation.

Importieren eines Event Grid-Beispielrunbooks

1. Wählen Sie Ihr Automation-Konto und dann die Seite Runbooks aus.

   

2. Wählen Sie die Schaltfläche Katalog durchsuchen aus.

3. Suchen Sie nach Event Grid und wählen Sie Integration von Azure Automation mit Event Grid aus.

   

4. Wählen Sie Importieren aus und nennen Sie es Watch-VMWrite.

5. Nach dem Import wählen Sie Bearbeiten aus, um die Runbookquelle anzuzeigen.

6. Aktualisieren Sie die Zeile 74 im Skript, sodass Tag anstelle von Tags verwendet wird.

   Update-AzureRmVM -ResourceGroupName $VMResourceGroup -VM $VM -Tag $Tag | Write-Verbose
   

7. Wählen Sie die Schaltfläche Veröffentlichen aus.

Erstellen eines optionalen Microsoft Teams-Webhooks

1. Wählen Sie in Microsoft-Teams die Option Weitere Optionen neben dem Kanalnamen und dann Connectors aus.

   

2. Scrollen Sie durch die Liste der Connectors zu Eingehender Webhook und wählen Sie Hinzufügen aus.

3. Geben Sie AzureAutomationIntegration für den Namen ein und wählen Sie Erstellen aus.

4. Kopieren Sie die Webhook-URL in die Zwischenablage und speichern Sie sie. Die Webhook-URL wird zum Senden von Informationen an Microsoft Teams verwendet.

5. Wählen Sie Fertig aus, um den Webhook zu speichern.

Erstellen eines Webhooks für das Runbook

1. Öffnen Sie das Runbook „Watch-VMWrite“.

2. Wählen Sie Webhooks und dann die Schaltfläche Webhook hinzufügen aus.

3. Geben Sie WatchVMEventGrid für den Namen ein. Kopieren Sie die URL in die Zwischenablage und speichern Sie sie.

   

4. Wählen Sie Parameter konfigurieren und Einstellungen ausführen aus und geben Sie Microsoft Teams-Webhook-URL für CHANNELURL ein. Lassen Sie WEBHOOKDATA leer.

   

5. Wählen Sie Erstellen aus, um den Webhook des Automation-Runbooks zu erstellen.

Erstellen eines Event Grid-Abonnements

1. Wählen Sie auf der Übersichtsseite Automation-Konto die Option Event Grid aus.

   

2. Klicken Sie auf + Ereignisabonnement.

3. Konfigurieren Sie das Abonnement mit den folgenden Informationen:

   1. Wählen Sie unter Thementyp die Option Azure-Abonnements aus.

   2. Deaktivieren Sie das Kontrollkästchen Alle Ereignistypen abonnieren.

   3. Geben Sie AzureAutomation für den Namen ein.

   4. Deaktivieren Sie in der Dropdownliste Definierte Ereignistypen alle Optionen bis auf Resource Write Success (Ressourcenschreiberfolg).

      Hinweis

      Azure Resource Manager unterscheidet zurzeit nicht zwischen „Erstellen“ und „Aktualisieren“, sodass die Implementierung dieses Tutorials für alle „Microsoft.Resources.ResourceWriteSuccess“-Ereignisse in Ihrem Azure-Abonnement zu einer großen Anzahl von Aufrufen führen kann.

   5. Wählen Sie unter Endpunkttyp die Option Webhook aus.

   6. Klicken Sie auf Endpunkt auswählen. Fügen Sie auf der daraufhin geöffneten Seite Webhook auswählen die Webhook-URL ein, die Sie für das Runbook „Watch-VMWrite“ erstellt haben.

   7. Geben Sie unter FILTER das Abonnement und die Ressourcengruppe ein, in denen Sie nach den neu erstellten virtuellen Computern suchen möchten. Diese sollte wie folgt aussehen: /subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Compute/virtualMachines.

4. Wählen Sie Erstellen aus, um das Event Grid-Abonnement zu speichern.

Erstellen eines virtuellen Computers, der das Runbook auslöst

1. Legen Sie einen neuen virtuellen Computer in der Ressourcengruppe an, die Sie im Event Grid-Abonnementpräfixfilter angegeben haben.

2. Das Runbook „Watch-VMWrite“ sollte aufgerufen und dem virtuellen Computer ein neues Tag hinzugefügt werden.

   

3. Eine neue Nachricht wird an den Microsoft Teams-Kanal gesendet.

   

Nächste Schritte

In diesem Tutorial richten Sie die Integration zwischen Event Grid und Automation ein. Sie haben Folgendes gelernt:

• Importieren Sie ein Event Grid-Beispielrunbook.
• Erstellen Sie einen optionalen Microsoft Teams-Webhook.
• Erstellen Sie einen Webhook für das Runbook.
• Erstellen Sie ein Event Grid-Abonnement.
• Erstellen Sie einen virtuellen Computer, der das Runbook auslöst.

Erstellen und Weiterleiten benutzerdefinierter Ereignisse mit Event Grid