Erstellen einer IoT Hub-Instanz mithilfe des Cmdlets New-AzIotHub
Mit Azure PowerShell-Cmdlets können Sie Azure IoT Hubs erstellen und verwalten. In diesem Tutorial erfahren Sie, wie Sie eine IoT Hub-Instanz mit PowerShell erstellen.
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.
Alternativ können Sie Azure Cloud Shell verwenden, wenn Sie keine zusätzlichen Module auf Ihrem Computer installieren möchten. Der folgende Abschnitt enthält Informationen zu den ersten Schritten mit Azure Cloud Shell.
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 rechts oben in einem Code- oder Befehlsblock die Option Ausprobieren aus. Durch die Auswahl von Ausprobieren wird der Code oder Befehl nicht automatisch in Cloud Shell kopiert. |  |
| Rufen Sie https://shell.azure.com auf, oder klicken Sie auf die Schaltfläche Cloud Shell starten, um Cloud Shell im Browser zu öffnen. |  |
| Wählen Sie im Azure-Portal rechts oben im Menü die Schaltfläche Cloud Shell aus. |  |
So verwenden Sie Azure Cloud Shell:
Starten Sie Cloud Shell.
Wählen Sie die Schaltfläche Kopieren für einen Codeblock (oder Befehlsblock) aus, um den Code oder Befehl zu kopieren.
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.
Drücken Sie die EINGABETASTE, um den Code oder Befehl auszuführen.
Voraussetzungen
Für das Bereitstellen einer IoT Hub-Instanz benötigen Sie eine Ressourcengruppe. Sie können eine vorhandene Ressourcengruppe verwenden oder eine neue erstellen.
Wenn Sie eine neue Ressourcengruppe für Ihren IoT-Hub erstellen möchten, verwenden Sie den Befehl New-AzResourceGroup. Mit diesem Beispiel wird die Ressourcengruppe MyIoTRG1 in der Region USA, Osten erstellt:
New-AzResourceGroup -Name MyIoTRG1 -Location "East US"
Verbinden mit Ihrem Azure-Abonnement
Wenn Sie Cloud Shell verwenden, sind Sie bereits bei Ihrem Abonnement angemeldet, sodass Sie diesen Abschnitt überspringen können. Wenn Sie stattdessen PowerShell lokal ausführen, geben Sie den folgenden Befehl ein, um sich bei Ihrem Azure-Abonnement anzumelden:
# Log into Azure account.
Login-AzAccount
Erstellen eines IoT-Hubs
Erstellen Sie einen IoT-Hub mit Ihrer neuen Ressourcengruppe. Verwenden Sie den Befehl New-AzIotHub. Mit diesem Beispiel wird ein S1-Hub mit dem Namen MyTestIoTHub in der Region USA, Osten erstellt:
New-AzIotHub `
-ResourceGroupName MyIoTRG1 `
-Name MyTestIoTHub `
-SkuName S1 -Units 1 `
-Location "East US"
Der Name der IoT Hub-Instanz muss global eindeutig sein.
Wichtig
Der IoT-Hub ist öffentlich als DNS-Endpunkt ermittelbar. Stellen Sie daher sicher, dass Sie beim Vergeben des Namens keine sensiblen oder personenbezogenen Informationen verwenden.
Mit dem Befehl Get-AzIotHub listen Sie alle IoT-Hubs in Ihrem Abonnement auf.
Dieses Beispiel zeigt die IoT Hub-Instanz vom Typ „S1 Standard“, die Sie im vorherigen Schritt erstellt haben.
Get-AzIotHub
Mit dem Befehl Remove-AzIotHub löschen Sie den IoT-Hub.
Remove-AzIotHub `
-ResourceGroupName MyIoTRG1 `
-Name MyTestIoTHub
Aktualisieren des IoT-Hubs
Sie können die Einstellungen eines vorhandenen IoT-Hubs nach seiner Erstellung im Bereich „IoT Hub“ ändern. Hier werden einige der Eigenschaften aufgeführt, die Sie für einen IoT-Hub festlegen können:
Tarif und Skalierung: Mit dieser Eigenschaft können Sie die Migration zu einem anderen Tarif durchführen oder die Anzahl von IoT Hub-Einheiten festlegen.
IP-Filter: Hier können Sie einen IP-Adressbereich angeben, der vom IoT-Hub akzeptiert oder abgelehnt wird.
Eigenschaften: Enthält die Liste der Eigenschaften, die Sie kopieren und an anderer Stelle verwenden können, z. B. die Ressourcen-ID, die Ressourcengruppe, den Standort usw.
Erkunden Sie die Befehle vom Typ Set-AzIotHub, um eine vollständige Liste von Updateoptionen abzurufen.
Nächste Schritte
Nachdem Sie einen IoT-Hub mithilfe eines PowerShell-Cmdlets bereitgestellt haben, erkunden Sie jetzt weitere Artikel:
Entwickeln für IoT Hub:
Erkunden der Funktionen von IoT Hub: