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
- Zugriff auf einen IoT Hub mit aktiviertem Device Update for IoT Hub.
- Ein für Device Update bereitgestelltes IoT-Gerät (oder ein entsprechender Simulator) in IoT Hub.
- PowerShell 5 oder später (einschließlich Linux-, macOS- und Windows-Installationen)
- Unterstützte Browser:
- Microsoft Edge
- Google Chrome
Importieren eines Updates
Hinweis
Die folgenden Anweisungen zeigen, wie Sie ein Update über die Benutzeroberfläche im Azure-Portal importieren. Sie können stattdessen auch das Geräteupdate für IoT Hub-APIs verwenden, um ein Update zu importieren.
Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Ihrer IoT Hub-Instanz mit Device Update.
Wählen Sie auf der linken Seite unter
Device Management
die OptionUpdates
aus.Wählen Sie die Registerkarte
Updates
in der Liste der Registerkarten am oberen Bildschirmrand aus.Wählen Sie
+ Import a new update
unterhalb des HeadersAvailable Updates
aus.Wählen Sie
+ Select from storage container
aus. Die Benutzeroberfläche für Speicherkonten wird angezeigt. Wählen Sie entweder ein vorhandenes Konto aus, oder erstellen Sie mit+ Storage account
ein neues Konto. Dieses Konto wird für einen Container verwendet, um Ihre Updates für den Import zu stagen.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 Container. Dieser Container wird verwendet, um Ihre Updatedateien für den Import der Empfehlung: Verwenden Sie bei jedem Import eines Updates einen neuen Container, um das versehentliche Importieren von Dateien aus früheren Updates zu vermeiden. Wenn Sie keinen neuen Container verwenden, müssen Sie vor diesem Schritt alle Dateien aus dem vorhandenen Container löschen. zu stagen.Wählen Sie in Ihrem Container
Upload
aus. Die Benutzeroberfläche für Uploads wird angezeigt.Wählen Sie das Ordnersymbol auf der rechten Seite des Abschnitts
Files
unter dem HeaderUpload blob
aus. Verwenden Sie die Dateiauswahl, um zum Speicherort Ihrer Updatedateien zu navigieren und das Manifest zu importieren. Wählen Sie alle Dateien und dannOpen
aus. Sie können die UMSCHALTTASTE gedrückt halten, um mehrere Dateien auszuwählen.Nachdem Sie alle Updatedateien ausgewählt haben, wählen Sie
Upload
aus.Wählen Sie die hochgeladenen Dateien aus, um sie für den Import festzulegen. Klicken Sie dann auf die Schaltfläche
Select
, um zur SeiteImport update
zurückzukehren.Überprüfen Sie auf der Seite „Update importieren“ die zu importierenden Dateien. Wählen Sie dann
Import update
aus, um den Importvorgang zu starten. Informationen zum Beheben von Fehlern finden Sie auf der Seite Problembehandlung bei Proxyupdates.Der Importvorgang beginnt, und auf dem Bildschirm wird der Abschnitt
Import History
angezeigt. Wählen SieRefresh
aus, um den Fortschritt 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).Wenn in der Spalte
Status
angezeigt wird, dass der Import erfolgreich war, wählen Sie den HeaderAvailable Updates
aus. Ihr importiertes Update sollte nun in der Liste angezeigt werden.
Wenn Sie stattdessen über APIs importieren
Zusätzlich zum Importieren über das Azure-Portal können Sie ein Update auch wie folgt programmgesteuert importieren:
- Mit
Azure SDK
für .NET, Java, JavaScript oder Python - Mit der REST-API für das Importieren von Updates
- Mit PowerShell-Beispielmodulen
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. Wenn Sie eine SAS verwenden, stellen Sie sicher, dass Sie ein Ablauffenster von mindestens drei Stunden festlegen.
Tipp
Um große Updatedateien in Azure Blob Storage-Container hochzuladen, können Sie eine der folgenden Vorgehensweisen nutzen, um die Leistung zu verbessern: