Device Update for IoT Hub-Ressourcenverwaltung

Für Ihre ersten Schritte mit Device Update müssen Sie ein Device Update-Konto und eine Device Update-Instanz erstellen sowie Rollen für die Zugriffssteuerung festlegen.

Voraussetzungen

Azure portal

Einen IoT Hub. Es wird empfohlen, einen S1-Tarif (Standard) oder höher zu verwenden.

Azure-Befehlszeilenschnittstelle

• Einen IoT Hub. Es wird empfohlen, einen S1-Tarif (Standard) oder höher zu verwenden.

• 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 Device Update-Kontos und einer Device Update-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 Grundlagen die folgenden Informationen für Ihr Device Update-Konto 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“.

   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.

   

4. Optional können Sie das Kontrollkästchen aktivieren, 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.

5. Wählen Sie Weiter: Instanz aus.

   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.

6. Geben Sie auf der Registerkarte Instanz die folgenden Informationen für Ihre Device Update-Instanz an:

   • Name: Ein Name für Ihre Instanz.
   • IoT Hub-Details: Wählen Sie einen IoT-Hub aus, um eine Verknüpfung mit dieser Instanz zu erstellen.

   

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

   

8. 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 mit dem Befehl az iot device-update 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 device-update account create --resource-group <resource_group> --account <account_name> --location <region>

Erstellen Sie mit dem Befehl az iot device-update 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 device-update 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.

Konfigurieren von Zugriffssteuerungsrollen für Device Update

Damit andere Benutzer auf Device Update zugreifen können, muss ihnen der Zugriff auf diese Ressource gewährt werden. Sie können diesen Schritt überspringen, wenn Sie sich bei der Erstellung des Kontos die Rolle „Device Update-Administrator“ selbst zugewiesen haben und anderen Benutzern oder Anwendungen keinen Zugriff gewähren müssen.

Azure portal

1. Wählen Sie in Ihrem Device Update-Konto im Navigationsmenü die Option Zugriffssteuerung (IAM) aus.

   

2. Wählen Sie Rollenzuweisung hinzufügen aus.

3. Wählen Sie auf der Registerkarte Rolle aus den verfügbaren Optionen eine Device Update-Rolle aus:

   • Device Update-Administrator
   • Device Update-Leser
   • Device Update-Inhaltsadministrator
   • Device Update-Inhaltsleser
   • Device Update-Bereitstellungsadministrator
   • Device Update-Bereitstellungsleser

   Weitere Informationen dazu finden Sie unter Erfahren Sie mehr über die rollenbasierte Zugriffssteuerung in Device Update for IoT Hub.

   

4. Wählen Sie Weiter aus.

5. Wählen Sie auf der Registerkarte Mitglieder die Benutzer oder Gruppen aus, denen Sie die Rolle zuweisen möchten.

   

6. Wählen Sie Überprüfen und zuweisen aus.

7. Überprüfen Sie die neuen Rollenzuweisungen, und wählen Sie erneut Überprüfen und zuweisen aus.

8. Jetzt können Sie Device Update aus Ihrem IoT Hub heraus verwenden.

Azure-Befehlszeilenschnittstelle

Die folgenden Rollen stehen zum Zuweisen des Zugriffs auf Device Update zur Verfügung:

• Device Update-Administrator
• Device Update-Leser
• Device Update-Inhaltsadministrator
• Device Update-Inhaltsleser
• Device Update-Bereitstellungsadministrator
• Device Update-Bereitstellungsleser

Weitere Informationen dazu finden Sie unter Erfahren Sie mehr über die rollenbasierte Zugriffssteuerung in Device Update for IoT Hub.

Konfigurieren Sie mit dem Befehl az role assignment create die Zugriffssteuerung für Ihr Device Update-Konto.

Ersetzen Sie die folgenden Platzhalter durch Ihre eigenen Informationen:

• <role>: Die Device Update-Rolle, die Sie zuweisen.
• <user_group>: Der Benutzer oder die Gruppe, dem bzw. der Sie die Rolle zuweisen möchten.
• <account_id>: Die Ressourcen-ID für das Device Update-Konto, auf das der Benutzer oder die Gruppe Zugriff erhält. Sie können die Ressourcen-ID auch mithilfe des Befehls az iot device-update account show abrufen und den ID-Wert abfragen: az iot device-update account show -n <account_name> --query id.

az role assignment create --role '<role>' --assignee <user_group> --scope <account_id>

Konfigurieren von Zugriffssteuerungsrollen für IoT Hub

Device Update for IoT Hub kommuniziert mit IoT Hub, um Bereitstellungen und Updates zu verwalten und Informationen zu Geräten abzurufen. Um den Zugriff zu aktivieren, müssen Sie dem Azure Device Update-Dienstprinzipal Zugriff mit der Rolle Mitwirkender an IoT Hub-Daten gewähren.

Azure portal

1. Navigieren Sie im Azure-Portal zum IoT Hub, der mit Ihrer Device Update-Instanz verbunden ist.
2. Wählen Sie im Navigationsmenü Zugriffssteuerung (IAM) aus.
3. Wählen Sie Hinzufügen>Rollenzuweisung hinzufügen.
4. Wählen Sie auf der Registerkarte Rolle die Option Mitwirkender an IoT Hub-Daten aus. Klicken Sie auf Weiter.
5. Wählen Sie für Zugriff zuweisen zu die Option Benutzer, Gruppe oder Dienstprinzipal aus.
6. Wählen Sie Mitglieder auswählen aus, und suchen Sie nach 'Azure Device Update'.
7. Wählen Sie Nächste>Überprüfung + Zuweisen aus.

So überprüfen Sie, ob Sie Berechtigungen richtig festgelegt haben:

1. Navigieren Sie im Azure-Portal zum IoT Hub, der mit Ihrer Device Update-Instanz verbunden ist.
2. Wählen Sie im Navigationsmenü Zugriffssteuerung (IAM) aus.
3. Wählen Sie Zugriff prüfen aus.
4. Wählen Sie Benutzer, Gruppe oder Dienstprinzipal aus, und suchen Sie nach Azure Device Update.
5. Nachdem Sie auf Azure Device Update geklickt haben, überprüfen Sie unter Rollenzuweisungen, ob dort die Rolle Mitwirkender an IoT Hub-Daten aufgeführt ist.

Azure-Befehlszeilenschnittstelle

Verwenden Sie den Befehl az role assignment create, um eine Rollenzuweisung für den Azure Device Update-Dienstprinzipal zu erstellen.

Ersetzen Sie <resource_id> durch die Ressourcen-ID Ihres IoT Hubs. Sie können die Ressourcen-ID abrufen, indem Sie den Befehl az iot hub showverwenden und den ID-Wert abfragen: az iot hub show -n <hub_name> --query id.

az role assignment create --role "IoT Hub Data Contributor" --assignee https://api.adu.microsoft.com/ --scope <resource_id>

Anzeigen und Abfragen von Konten oder Instanzen

Sie können alle Ihre Device Update-Konten und -Instanzen anzeigen, sortieren und abfragen.

Azure portal

1. Wenn Sie alle Device Update-Konten anzeigen möchten, suchen Sie über das Azure-Portal nach dem Dienst Device Update für IoT Hubs.

   • Verwenden Sie das Dropdownmenü Gruppieren zum Gruppieren des Kontos nach Abonnement, Ressourcengruppe, Standort und anderen Bedingungen.
   • Wählen Sie Filter hinzufügen aus, um die Liste der Konten nach Ressourcengruppe, Standort, Tags und anderen Bedingungen zu filtern.

2. Zum Anzeigen aller Instanzen in einem Konto navigieren Sie im Azure-Portal zu diesem Konto. Wählen Sie im Abschnitt Instanzverwaltung des Menüs die Option Instanzen aus.

   • Verwenden Sie das Suchfeld zum Filtern von Instanzen.

Azure-Befehlszeilenschnittstelle

Verwenden Sie zum Anzeigen aller Device Update-Konten den Befehl az iot device-update account list.

az iot device-update account list 

Verwenden Sie zum Anzeigen aller Instanzen in einem Konto den Befehl az iot device-update instance list.

az iot device-update instance list --account <account_name>

Beide list-Befehle unterstützen zusätzliche Gruppierungs- und Filtervorgänge. Verwenden Sie das Argument --query für die Suche nach Konten oder Instanzen basierend auf Bedingungen wie Tags. Beispiel: --query "[?tags.env == 'test']". Verwenden Sie das Argument --output zum Formatieren der Ergebnisse. Beispiel: --output table.

Nächste Schritte

Versuchen Sie, ein Gerät anhand eines der folgenden Schnellstarttutorials zu aktualisieren:

• Aktualisieren eines simulierten IoT Edge-Geräts
• Aktualisieren eines Raspberry Pi
• Aktualisieren eines Ubuntu Server 18.04 x64-Paket-Agents

Erfahren Sie mehr über das Device Update-Konto und die Instanz.

Erfahren Sie mehr über die Device Update-Zugriffssteuerungsrollen.