Condividi tramite


Guida introduttiva: Creare un hub eventi usando Azure PowerShell

In questa guida introduttiva viene creato un hub eventi usando Azure PowerShell.

Prerequisiti

Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.

Azure Cloud Shell

Azure Cloud Shell è un ambiente di shell interattivo ospitato in Azure e usato tramite il browser. È possibile usare Bash o PowerShell con Cloud Shell per usare i servizi di Azure. È possibile usare i comandi preinstallati di Cloud Shell per eseguire il codice contenuto in questo articolo senza dover installare strumenti nell'ambiente locale.

Per avviare Azure Cloud Shell:

Opzione Esempio/Collegamento
Selezionare Prova nell'angolo superiore destro di un blocco di codice o di comando. Quando si seleziona Prova, il codice o il comando non viene copiato automaticamente in Cloud Shell. Screenshot che mostra un esempio di Prova per Azure Cloud Shell.
Passare a https://shell.azure.com o selezionare il pulsante Avvia Cloud Shell per aprire Cloud Shell nel browser. Pulsante per avviare Azure Cloud Shell.
Selezionare il pulsante Cloud Shell nella barra dei menu nell'angolo in alto a destra del portale di Azure. Screenshot che mostra il pulsante Cloud Shell nel portale di Azure

Per usare Azure Cloud Shell:

  1. Avviare Cloud Shell.

  2. Selezionare il pulsante Copia in un blocco di codice (o in un blocco di comando) per copiare il codice o il comando.

  3. Incollare il codice o il comando nella sessione di Cloud Shell selezionando CTRL+MAIUSC+V in Windows e Linux o selezionando CMD+MAIUSC+V in macOS.

  4. Premere Invio per eseguire il codice o il comando.

Se si usa PowerShell in locale, è necessario eseguire la versione più recente di PowerShell per completare questa guida introduttiva. Se è necessario eseguire l'installazione o l'aggiornamento, vedere Installare e configurare Azure PowerShell.

Creare un gruppo di risorse

Eseguire il comando seguente per creare un gruppo di risorse. Un gruppo di risorse è una raccolta logica di risorse di Azure. Tutte le risorse vengono distribuite e gestite in un gruppo di risorse.

Se si usa Azure Cloud Shell, passare a PowerShell da Bash nell'angolo superiore sinistro. Selezionare Copia per copiare il comando e incollarlo nella finestra di Cloud Shell ed eseguirlo.

L'esempio seguente crea un gruppo di risorse nell'area Stati Uniti orientali. Sostituire myResourceGroup con il nome del gruppo di risorse che si vuole usare.

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

Viene visualizzato l’output simile al seguente. Viene visualizzato il nome della risorsa con il suffisso del numero casuale.

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

Creare uno spazio dei nomi di Hub eventi

Eseguire il comando seguente per creare uno spazio dei nomi di Hub eventi nel gruppo di risorse. Uno spazio dei nomi di Hub eventi specifica un nome di dominio univoco completo in cui è possibile creare uno o più hub eventi. Aggiornare il valore dello spazio dei nomi, se si desidera.

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

Viene visualizzato l’output simile al seguente. Il nome dello spazio dei nomi viene visualizzato nel campo Name.

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       :

Creare un hub eventi

Dopo aver creato uno spazio dei nomi di Hub eventi, creare un hub eventi all'interno di esso eseguendo il comando seguente.

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

Viene visualizzato un output simile al seguente.

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

Complimenti. È stato usato Azure PowerShell per creare uno spazio dei nomi di Hub eventi e un hub eventi nello spazio dei nomi.

Pulire le risorse

Se si vuole mantenere questo hub eventi in modo che sia possibile testare l'invio e la ricezione di eventi, ignorare questa sezione. Diversamente, eseguire il comando seguente per eliminare il gruppo di risorse. Questo comando elimina tutte le risorse nel gruppo di risorse e il gruppo di risorse stesso.

Remove-AzResourceGroup $rgName

Passaggi successivi

In questo articolo è stato creato lo spazio dei nomi di Hub eventi e sono state usate applicazioni di esempio per inviare e ricevere eventi dall'hub eventi. Per istruzioni dettagliate relative all'invio o alla ricezione di eventi da un hub eventi, vedere le esercitazioni per l'invio e la ricezione di eventi: