Erstellen eines IoT Hubs mit der Azure-Befehlszeilenschnittstelle
In diesem Artikel erfahren Sie, wie Sie unter Verwendung der Azure-Befehlszeilenschnittstelle eine IoT Hub-Instanz erstellen.
Voraussetzungen
Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.
Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.
Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.
Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.
Wenn Sie einen IoT Hub erstellen, müssen Sie ihn in einer Ressourcengruppe erstellen. Verwenden Sie entweder eine vorhandene Ressourcengruppe, oder führen Sie den folgenden Befehl zum Erstellen einer Ressourcengruppe aus:
az group create --name {your resource group name} --location westus
Tipp
Im vorherigen Beispiel wird die Ressourcengruppe am Standort „USA, Westen“ erstellt. Mit dem folgenden Befehl können Sie eine Liste mit verfügbaren Standorten anzeigen:
az account list-locations -o table
Erstellen eines IoT-Hubs
Verwenden Sie die Azure CLI zum Erstellen einer Ressourcengruppe, und fügen Sie dann einen IoT Hub hinzu.
Führen Sie den folgenden Befehl zum Erstellen einer IoT Hub-Instanz in Ihrer Ressourcengruppe aus, und verwenden Sie dabei einen global eindeutigen Namen für Ihre IoT Hub-Instanz:
az iot hub create --name {your iot hub name} \
--resource-group {your resource group name} --sku S1
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 vorhergehenden Befehl wird ein kostenpflichtiger IoT-Hub im S1-Tarif erstellt. Weitere Informationen finden Sie unter Azure IoT Hub – Preise.
Weitere Informationen zu Azure IoT Hub-Befehlen finden Sie im az iot hub Referenzartikel.
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.
Eine vollständige Liste der Optionen zum Aktualisieren eines IoT-Hubs finden Sie auf der Referenzseite für az iot hub update-Befehle.
Registrieren eines neuen Geräts beim IoT-Hub
In diesem Abschnitt erstellen Sie eine Geräteidentität in der Identitätsregistrierung im IoT Hub. Ein Gerät kann eine Verbindung mit einem Hub nur dann herstellen, wenn die Identitätsregistrierung einen Eintrag für dieses Gerät enthält. Weitere Informationen finden Sie unter Grundlegendes zur Identitätsregistrierung in Ihrer IoT Hub-Instanz. Für diese Geräteidentität ist IoT Edge aktiviert.
Führen Sie den folgenden Befehl aus, um eine simulierte Geräteidentität zu erstellen. Verwenden Sie Ihren IoT-Hubnamen und erstellen Sie einen neuen Geräte-ID-Namen anstelle von {iothub_name} und {device_id}. Dieser Befehl erstellt eine Geräteidentität mit Standardautorisierung (freigegebener privater Schlüssel).
az iot hub device-identity create -n {iothub_name} -d {device_id} --ee
Das Ergebnis ist ein JSON-Ausdruck, der Ihre Schlüssel und andere Informationen enthält.
Alternativ gibt es mehrere Optionen zum Registrieren eines Geräts mit unterschiedlichen Autorisierungsarten. Informationen zu den Optionen finden Sie unter Beispiele auf der az iot hub device-identity-Referenzseite.
Entfernen eines IoT-Hubs
Es gibt verschiedene Befehle zum Löschen einer einzelnen Ressource, wie etwa eines IoT-Hubs.
Führen Sie zum Löschen einer IoT Hub-Instanz den folgenden Befehl aus:
az iot hub delete --name {your iot hub name} -\
-resource-group {your resource group name}
Nächste Schritte
Erfahren Sie mehr über die Befehle, die in der Microsoft Azure IoT-Erweiterung für die Azure CLI verfügbar sind: