Erstellen von Device Update for IoT Hub-Ressourcen

Für Ihre ersten Schritte mit Device Update erstellen Sie ein Device Update-Konto und eine Device Update-Instanz. Danach legen Sie Zugriffssteuerungsrollen fest.

Ein Device Update-Konto ist eine Ressource in Ihrem Azure-Abonnement. Eine Device Update-Instanz ist ein logischer Container in einem Konto, das einem bestimmten IoT-Hub zugeordnet ist. Eine Instanz enthält Updates und Bereitstellungen, die deren IoT-Hub zugeordnet sind. Sie können mehrere Instanzen innerhalb eines Kontos erstellen. Weitere Informationen finden Sie unter Device Update-Ressourcen.

Voraussetzungen

Azure portal

Einen IoT Hub. Es muss mindestens ein S1-Tarif (Standard) verwendet werden.

Azure-Befehlszeilenschnittstelle

• Einen IoT Hub. Es muss mindestens ein S1-Tarif (Standard) verwendet werden.

• Eine Azure CLI-Umgebung:

  • Verwenden Sie die Bash-Umgebung in Azure Cloud Shell.

    

  • Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI

    • Melden Sie sich mit dem Befehl az login bei der Azure CLI an.

    • 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.

    • Installieren Sie die Azure CLI-Erweiterungen bei der ersten Verwendung, wenn Sie dazu aufgefordert werden. Die Befehle in diesem Artikel verwenden die azure-iot-Erweiterung . Führen Sie az extension update --name azure-iot aus, um sicherzustellen, dass Sie die neueste Version der Erweiterung verwenden.

Erstellen eines Kontos und einer Instanz

Azure portal

1. Wählen Sie im Azure-Portal die Option Ressource erstellen aus, und suchen Sie nach „Device Update for IoT Hub“.

2. Wählen Sie Erstellen>Device Update for IoT Hub aus.

   

3. Geben Sie auf der Registerkarte Allgemeine Informationen die folgenden Informationen für Ihr Device Update-Konto und Ihre Instanz an:

   • Abonnement: Das Azure-Abonnement, das Ihrem Device Update-Konto zugeordnet werden soll.
   • Ressourcengruppe: Eine vorhandene oder neue Ressourcengruppe.
   • Name: Ein Name für Ihr Konto.
   • Standort: Die Azure-Region, in der sich Ihr Konto befinden wird. Informationen dazu, welche Regionen Device Update for IoT Hub unterstützen, finden Sie auf der Seite „Azure Products-by-region“.
   • Aktivieren Sie das Kontrollkästchen, um sich selbst die Rolle „Administrator für Geräteupdates“ zuzuweisen. Sie können auch die Schritte im Abschnitt Konfigurieren von Zugriffssteuerungsrollen ausführen, um Benutzern und Anwendungen eine Kombination aus Rollen für die richtige Zugriffsebene zur Verfügung zu stellen. Sie müssen in Ihrem Abonnement über die Berechtigung „Besitzer“ oder „Benutzerzugriffsadministrator“ verfügen, um Rollen verwalten zu können.
   • Instanzname: Ein Name für Ihre Instanz.
   • IoT-Hub-Name: Wählen Sie die IoT Hub-Instanz aus, die Sie mit Ihrer Device Update-Instanz verknüpfen möchten.
   • Aktivieren Sie das Kontrollkästchen, um dem Azure Device Update-Dienstprinzipal in IoT Hub den passenden Zugriff für die Einrichtung und den Betrieb von Device Update Service zu gewähren. Sie müssen über die richtigen Berechtigungen verfügen, um Zugriff hinzufügen zu können.

   Hinweis

   Wenn Sie dem Azure Device Update-Dienstprinzipal im Rahmen der Ressourcenerstellung keinen Zugriff gewähren können, lesen Sie Konfigurieren von Zugriffssteuerungsrollen für Device Update-Ressourcen. Ist dieser Zugriff nicht festgelegt, können keine Bereitstellungs-, Geräteverwaltungs- oder Diagnosevorgänge ausgeführt werden. Weitere Informationen zum Zugriff für den Azure Device Update-Dienstprinzipal finden Sie hier.

   

4. Wählen Sie Weiter: Diagnose aus. Durch die Aktivierung der Microsoft-Diagnose wird Microsoft gestattet, bei einem Updatefehler Diagnoseprotokolldateien von Ihren Geräten zu sammeln, zu speichern und zu analysieren. Um die Remoteprotokollsammlung für die Diagnose zu ermöglichen, müssen Sie Ihre Device Update-Instanz mit Ihrem Azure Blob Storage-Konto verknüpfen. Wenn Sie das Azure Storage-Konto auswählen, werden die Speicherdetails automatisch aktualisiert.

   

5. Fahren Sie auf der Registerkarte Netzwerk mit der Erstellung des Device Update-Kontos und der Instanz fort. Wählen Sie die Endpunkte aus, über die Geräte eine Verbindung mit Ihrer Device Update-Instanz herstellen können. Übernehmen Sie für dieses Beispiel die Standardeinstellung Öffentlicher Zugriff.

   

6. Klicken Sie auf Weiter: Überprüfen + erstellen. Wählen Sie nach der Überprüfung die Option Erstellen aus.

   

7. Sie sehen, dass Ihre Bereitstellung in Bearbeitung ist. Der Status der Bereitstellung wird innerhalb weniger Minuten in „Abgeschlossen“ geändert. Wenn dies zutrifft, wählen Sie Zu Ressource wechseln aus.

Azure-Befehlszeilenschnittstelle

Erstellen Sie mithilfe des Befehls az iot du account create ein neues Device Update-Konto.

Ersetzen Sie die folgenden Platzhalter durch Ihre eigenen Informationen:

• <resource_group>: Eine bestehende Ressourcengruppe in Ihrem Abonnement.

• <account_name>: Ein Name für Ihr Device Update-Konto.

• <region>: Die Azure-Region, in der sich Ihr Konto befinden wird. Informationen dazu, welche Regionen Device Update for IoT Hub unterstützen, finden Sie auf der Seite „Azure Products-by-region“. Wenn keine Region angegeben wird, wird der Standort der Ressourcengruppe verwendet.

  Hinweis

  Ihr Device Update-Konto muss sich nicht in derselben Region wie Ihre IoT-Hubs befinden. Für eine bessere Leistung empfiehlt es sich aber, dass deren Standort möglichst in Ihrer Nähe liegt.

az iot du account create --resource-group <resource_group> --account <account_name> --location <region>

Erstellen Sie mithilfe des Befehls az iot du instance create eine neue Device Update-Instanz.

Eine Instanz von Device Update ist einem einzelnen IoT-Hub zugeordnet. Wählen Sie den IoT Hub aus, der mit Device Update verwendet werden soll. Wenn Sie einen IoT-Hub mit einer Device Update-Instanz verknüpfen, wird automatisch eine neue Richtlinie für den gemeinsamen Zugriff erstellt, die Device Update-Berechtigungen für die Arbeit mit IoT Hub (Registrierungs-, Schreib- und Dienstverbindung) bietet. Diese Richtlinie stellt sicher, dass der Zugriff nur auf Device Update beschränkt ist.

Ersetzen Sie die folgenden Platzhalter durch Ihre eigenen Informationen:

• <account_name>: Der Name des Device Update-Kontos, dem diese Instanz zugeordnet wird.
• <instance_name>: Ein Name für diese Instanz.
• <iothub_id>: Die Ressourcen-ID für den IoT-Hub, der mit dieser Instanz verknüpft wird. Sie können Ihre IoT-Hub-Ressourcen-ID abrufen, indem Sie den Befehl az iot hub show eingeben und den ID-Wert abfragen: az iot hub show -n <iothub_name> --query id.

az iot du instance create --account <account_name> --instance <instance_name> --iothub-ids <iothub_id>

Tipp

Im Rahmen des Instanzerstellungsprozesses können Sie auch die Diagnoseprotokollierung konfigurieren. Weitere Informationen dazu finden Sie unter Remotesammlung von Diagnoseprotokollen von Geräten.

Nächste Schritte

Nachdem Sie Ihre Device Update-Ressourcen erstellt haben, konfigurieren Sie die Zugriffssteuerung für Benutzer und den Azure Device Update-Dienstprinzipal.

Oder aber informieren Sie sich ausführlicher über Device Update-Konten und -Instanzen oder Device Update-Zugriffssteuerungsrollen.