Freigeben über

Schnellstart: Erstellen eines Event Hubs mithilfe von Azure PowerShell

In dieser Schnellstartanleitung erstellen Sie einen Event Hub mit Azure PowerShell.

Voraussetzungen

Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie kostenlos ein Konto.

Azure Cloud Shell

Azure hostet Azure Cloud Shell, eine interaktive Shell-Umgebung, die Sie über Ihren Browser nutzen können. Sie können entweder Bash oder PowerShell mit Cloud Shell verwenden, um mit Azure-Diensten zu arbeiten. Sie können die vorinstallierten Befehle von Cloud Shell verwenden, um den Code in diesem Artikel auszuführen, ohne etwas in Ihrer lokalen Umgebung installieren zu müssen.

Starten von Azure Cloud Shell:

Option Beispiel/Link
Wählen Sie "Ausprobieren" in der oberen rechten Ecke eines Code- oder Befehlsblocks aus. Wenn Sie "Testen" auswählen, wird der Code oder Befehl nicht automatisch in Cloud Shell kopiert. Screenshot eines Beispiels für
Wechseln Sie zu https://shell.azure.com, oder wählen Sie die Schaltfläche "Cloud Shell starten " aus, um Cloud Shell in Ihrem Browser zu öffnen. Schaltfläche zum Starten von Azure Cloud Shell.
Wählen Sie auf der Menüleiste oben rechts im Azure-Portal die Schaltfläche "Cloud Shell" aus. Screenshot der Schaltfläche

So verwenden Sie Azure Cloud Shell

  1. Starten Sie Cloud Shell.

  2. Wählen Sie die Schaltfläche "Kopieren " in einem Codeblock (oder Befehlsblock) aus, um den Code oder Befehl zu kopieren.

  3. Fügen Sie den Code oder Befehl mit STRG+UMSCHALT+V unter Windows und Linux oder CMD+UMSCHALT+V unter macOS in die Cloud Shell-Sitzung ein.

  4. Wählen Sie die EINGABETASTE aus, um den Code oder Befehl auszuführen.

Bei der lokalen Verwendung von PowerShell müssen Sie die aktuelle Version ausführen, um diese Schnellstartanleitung durcharbeiten zu können. Wenn Sie Azure PowerShell installieren oder aktualisieren müssen, lesen Sie " Installieren und Konfigurieren von Azure PowerShell".

Erstellen einer Ressourcengruppe

Führen Sie den folgenden Befehl aus, um eine Ressourcengruppe zu erstellen: Eine Ressourcengruppe ist eine logische Sammlung mit Azure-Ressourcen. Alle Ressourcen werden in einer Ressourcengruppe bereitgestellt und verwaltet.

Wenn Sie Azure Cloud Shell verwenden, wechseln Sie von Bash in der oberen linken Ecke zu PowerShell. Wählen Sie "Kopieren " aus, um den Befehl zu kopieren und in die Cloud Shell einzufügen, und führen Sie ihn aus.

Im folgenden Beispiel wird eine Ressourcengruppe in der Region „East US“ (USA, Osten) erstellt. Ersetzen Sie myResourceGroup durch den Namen der Ressourcengruppe, die Sie verwenden möchten.

$rgName="myResourceGroup$(Get-Random)"
$region="eastus"
New-AzResourceGroup –Name $rgName –Location $region

Daraufhin wird die Ausgabe angezeigt, die in etwa wie folgt aussieht. Der Name der Ressource wird mit einer zufälligen Zahl als Suffix angezeigt.

ResourceGroupName : myResourceGroup1625872532
Location          : eastus
ProvisioningState : Succeeded
Tags              : 
ResourceId        : /subscriptions/0000000000-0000-0000-0000-0000000000000/resourceGroups/myResourceGroup1625872532

Erstellen eines Event Hubs-Namespace

Führen Sie den folgenden Befehl aus, um einen Event Hubs-Namespace in der Ressourcengruppe zu erstellen. Ein Event Hubs-Namespace stellt einen eindeutigen vollqualifizierten Domänennamen bereit, unter dem Sie einen oder mehrere Event Hubs erstellen können. Aktualisieren Sie den Wert des Namespace, wenn Sie möchten.

$namespaceName="myNamespace$(Get-Random)"
New-AzEventHubNamespace -ResourceGroupName $rgName -Name $namespaceName -Location $region

Daraufhin wird die Ausgabe angezeigt, die in etwa wie folgt aussieht. Der Name des Namespace wird im Feld Name angezeigt.

Name                   : myNamespace143349827
Id                     : /subscriptions/0000000000-0000-0000-0000-00000000000000/resourceGroups/myResourceGroup162587253
                         2/providers/Microsoft.EventHub/namespaces/myNamespace143349827
ResourceGroupName      : myResourceGroup1625872532
Location               : East US
Sku                    : Name : Standard , Capacity : 1 , Tier : Standard
Tags                   : 
ProvisioningState      : Succeeded
Status                 : Active
CreatedAt              : 3/13/2023 10:22:54 PM
UpdatedAt              : 3/13/2023 10:23:41 PM
ServiceBusEndpoint     : https://myNamespace143349827.servicebus.windows.net:443/
Enabled                : True
KafkaEnabled           : True
IsAutoInflateEnabled   : False
MaximumThroughputUnits : 0
ZoneRedundant          : False
ClusterArmId           : 
DisableLocalAuth       : False
MinimumTlsVersion      : 1.2
KeySource              : 
Identity               : 
IdentityType           : 
IdentityId             : 
EncryptionConfig       :

Erstellen eines Ereignis-Hubs

Nachdem Sie nun über einen Event Hubs-Namespace verfügen, können Sie darin einen Event Hub erstellen, indem Sie den folgenden Befehl ausführen.

$ehubName="myEventHub"
New-AzEventHub -ResourceGroupName $rgName -NamespaceName $namespaceName -EventHubName $ehubName

Daraufhin wird eine Ausgabe angezeigt, die in etwa wie folgt aussieht:

ArchiveNameFormat            : 
BlobContainer                : 
CaptureEnabled               : 
CreatedAt                    : 3/13/2023 10:26:07 PM
DataLakeAccountName          : 
DataLakeFolderPath           : 
DataLakeSubscriptionId       : 
DestinationName              : 
Encoding                     : 
Id                           : /subscriptions/00000000000-0000-0000-0000-00000000000000/resourceGroups/myResourceGroup162
                               5872532/providers/Microsoft.EventHub/namespaces/myNamespace143349827/eventhubs/myEven
                               tHub
IntervalInSeconds            : 
Location                     : eastus
MessageRetentionInDays       : 7
Name                         : myEventHub
PartitionCount               : 4
PartitionId                  : {0, 1, 2, 3}
ResourceGroupName            : myResourceGroup1625872532
SizeLimitInBytes             : 
SkipEmptyArchive             : 
Status                       : Active
StorageAccountResourceId     : 
SystemDataCreatedAt          : 
SystemDataCreatedBy          : 
SystemDataCreatedByType      : 
SystemDataLastModifiedAt     : 
SystemDataLastModifiedBy     : 
SystemDataLastModifiedByType : 
Type                         : Microsoft.EventHub/namespaces/eventhubs
UpdatedAt                    : 3/13/2023 10:26:07 PM

Glückwunsch! Sie haben Azure PowerShell verwendet, um einen Event Hubs-Namespace und einen darin enthaltenen Event Hub zu erstellen.

Bereinigen von Ressourcen

Wenn Sie diesen Event Hub beibehalten möchten, damit Sie das Senden und Empfangen von Ereignissen testen können, ignorieren Sie diesen Abschnitt. Führen Sie andernfalls den folgenden Befehl aus, um die Ressourcengruppe zu löschen. Dieser Befehl löscht alle Ressourcen in der Ressourcengruppe und die Ressourcengruppe selbst.

Remove-AzResourceGroup $rgName

Nächste Schritte

In diesem Artikel haben Sie den Event Hubs-Namespace erstellt und Beispielanwendungen verwendet, um Ereignisse von Ihrem Event Hub zu senden und zu empfangen. Schrittweise Anleitungen zum Senden von Ereignissen an (oder) zum Empfangen von Ereignissen von einem Event Hub finden Sie in den Lernprogrammen zum Senden und Empfangen von Ereignissen :