Freigeben über


Abonnieren von Ereignissen für ein benutzerdefiniertes Thema mit PowerShell

Dieses Skript erstellt ein Event Grid-Abonnement für die Ereignisse für ein benutzerdefiniertes Thema.

Sollten Sie über kein Azure-Abonnement verfügen, können Sie zunächst ein kostenloses Azure-Konto erstellen.

Für das Vorschaubeispielskript ist das Event Grid-Modul erforderlich. Führen Sie zum Installieren Install-Module -Name AzureRM.EventGrid -AllowPrerelease -Force -Repository PSGallery aus.

Beispielskript: stabil

Hinweis

Es wird empfohlen, das Azure Az PowerShell-Modul für die Interaktion mit Azure zu verwenden. Informationen zu den ersten Schritten finden Sie unter Installieren des Azure Az PowerShell-Moduls. Informationen zum Migrieren zum Az PowerShell-Modul finden Sie unter Migrieren von Azure PowerShell von AzureRM zum Az-Modul.

# Provide the name of the topic you are subscribing to
$myTopic = "<your-custom-topic-name>"

# Provide an endpoint for handling the events. Must be formatted "https://your-endpoint-URL"
$myEndpoint = "<your-endpoint-URL>"

# Provide a name for resource group to create. It will contain the custom event.
$myResourceGroup = "<resource-group-name>"

# Create resource group
New-AzResourceGroup -Name $myResourceGroup -Location westus2

# Create custom topic
New-AzEventGridTopic -ResourceGroupName $myResourceGroup -Name $myTopic -Location westus2 

# Subscribe to the custom event. Include the resource group that contains the custom topic.
New-AzEventGridSubscription `
  -EventSubscriptionName demoSubscription `
  -Endpoint $myEndpoint `
  -ResourceGroupName $myResourceGroup `
  -TopicName $myTopic

Beispielskript: Vorschaumodul

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.
# You must have the latest version of the Event Grid PowerShell module.
# To install:
# Install-Module -Name AzureRM.EventGrid -AllowPrerelease -Force -Repository PSGallery

# Provide the name of the topic you are subscribing to
$myTopic = "<your-custom-topic-name>"

# Provide an endpoint for handling the events. Must be formatted "https://your-endpoint-URL"
$myEndpoint = "<your-endpoint-URL>"

# Provide the name of the resource group to create. It will contain the custom topic.
$myResourceGroup = "<resource-group-name>"

# Create resource group
New-AzResourceGroup -Name $myResourceGroup -Location westus2

# Create custom topic and get its resource ID.
$topicID = (New-AzEventGridTopic -ResourceGroupName $myResourceGroup -Name $myTopic -Location westus2).Id 

# Subscribe to the custom event. Include the resource group that contains the custom topic.
New-AzEventGridSubscription `
  -ResourceId $topicID `
  -EventSubscriptionName demoSubscription `
  -Endpoint $myEndpoint 

Erläuterung des Skripts

Dieses Skript verwendet den folgenden Befehl, um das Ereignisabonnement zu erstellen. Jeder Befehl in der Tabelle ist mit der zugehörigen Dokumentation verknüpft.

Get-Help Notizen
New-AzEventGridSubscription Erstellen Sie ein Event Grid-Abonnement.

Nächste Schritte