Importieren eines Updates in Device Update for IoT Hub

Hier erfahren Sie, wie Sie ein neues Update abrufen und in das Geräte-Update für den IoT-Hub importieren. Wenn Sie dies noch nicht wissen, sollten Sie sich unbedingt mit den wichtigsten Importkonzepten und der Vorbereitung eines Updates für den Import vertraut machen.

Voraussetzungen

Unterstützte Browser:

Importieren eines Updates

In diesem Abschnitt wird gezeigt, wie Sie ein Update entweder über das Azure-Portal oder mit der Azure-Befehlszeilenschnittstelle importieren. Sie können stattdessen auch das Geräteupdate für IoT Hub-APIs verwenden, um ein Update zu importieren.

Zum Importieren eines Updates laden Sie zunächst die Updatedateien und das Importmanifest in einen Azure Storage-Container hoch. Anschließend importieren Sie das Update aus Azure Storage in Device Update for IoT Hub. Dort wird es für Sie zum Bereitstellen auf Geräten gespeichert.

  1. Navigieren Sie im Azure-Portal zu Ihrem IoT-Hub mit Device Update.

  2. Wählen Sie links auf der Seite unter Geräteverwaltung die Option Updates aus.

    Importieren von Updates

  3. Wählen Sie die Registerkarte Updates in der Liste der Registerkarten am oberen Bildschirmrand aus.

    Updates

  4. Wählen Sie unter dem Header Verfügbare Updates die Option + Neues Update importieren aus.

    Neues Update importieren

  5. Klicken Sie auf + Aus Speichercontainer auswählen. Die Benutzeroberfläche für Speicherkonten wird angezeigt. Wählen Sie ein vorhandenes Speicherkonto aus, oder erstellen Sie mit + Speicherkonto ein neues. Dieses Konto wird für einen Container verwendet, um Ihre Updates für den Import zu stagen.

    Updatedateien auswählen

  6. Nachdem Sie ein Speicherkonto haben, wird die Benutzeroberfläche für Container angezeigt. Wählen Sie einen vorhandenen Container aus, oder erstellen Sie mit + Container einen neuen. Dieser Container wird zum Stagen Ihrer Updatedateien für den Import verwendet.

    Es wird empfohlen, bei jedem Import eines Updates einen neuen Container zu verwenden. Indem Sie immer neue Container verwenden, können Sie das versehentliche Importieren von Dateien aus früheren Updates vermeiden. Wenn Sie keinen neuen Container verwenden, müssen Sie unbedingt alle Dateien aus dem vorhandenen Container löschen, bevor Sie diesen Schritt abschließen.

    Speicherkonto

  7. Wählen Sie in Ihrem Container Hochladen aus. Die Benutzeroberfläche für Uploads wird angezeigt.

    Auswählen des Containers

  8. Wählen Sie das Ordnersymbol auf der rechten Seite des Abschnitts Dateien unter dem Header Blob hochladen aus. Verwenden Sie die Dateiauswahl, um zum Speicherort Ihrer Updatedateien und Ihres Importmanifests zu navigieren, und wählen Sie alle Dateien und dann Öffnen aus. Sie können die UMSCHALTTASTE gedrückt halten, um mehrere Dateien auszuwählen.

    Update veröffentlichen

  9. Nachdem Sie alle Updatedateien ausgewählt haben, wählen Sie Hochladen aus.

    Containerupload

  10. Wählen Sie die hochgeladenen Dateien aus, um sie für den Import festzulegen. Klicken Sie dann auf die Schaltfläche Auswählen, um zur Seite Update importieren zurückzukehren.

    Auswählen der hochgeladenen Dateien

  11. Überprüfen Sie auf der Seite „Update importieren“ die zu importierenden Dateien. Klicken Sie dann auf Update importieren, um den Importvorgang zu starten. Informationen zum Beheben möglicher Fehler finden Sie unter Problembehandlung bei Proxyupdates.

    Starten des Imports

  12. Der Importvorgang beginnt, und auf dem Bildschirm wird der Abschnitt Importverlauf angezeigt. Wählen Sie Aktualisieren aus, um den Status anzuzeigen, bis der Importvorgang abgeschlossen ist (je nach Größe des Updates kann dieser Vorgang innerhalb weniger Minuten abgeschlossen werden oder auch länger dauern).

    Updateimportsequenzierung

  13. Wenn in der Spalte Status angezeigt wird, dass der Import erfolgreich war, wählen Sie den Header Verfügbare Updates aus. Ihr importiertes Update sollte nun in der Liste angezeigt werden.

    Auftragsstatus

Wenn Sie stattdessen über APIs importieren

Sie können ein Update wie folgt auch programmgesteuert importieren:

Hinweis

Informationen zur erforderlichen API-Berechtigung finden Sie unter Benutzerrollen und -zugriff für Device Update.

Die Updatedateien und das Importmanifest müssen für das Staging in einen Azure Blob Storage-Container hochgeladen werden. Um die gestageten Dateien zu importieren, geben Sie die Blob-URL (oder die Shared Access Signature (SAS) bei privaten Blobs) in der Device Update-API an. Geben Sie bei Verwendung einer SAS ein Ablauffenster von mindestens drei Stunden an.

Tipp

Um große Updatedateien in Azure Blob Storage-Container hochzuladen, können Sie eine der folgenden Vorgehensweisen nutzen, um die Leistung zu verbessern:

Nächste Schritte