Verwalten von Geräten mithilfe von Gerätezwillingstags in Azure IoT Hub
In diesem Artikel wird gezeigt, wie Sie Tags zum Verwalten von IoT-Geräten mithilfe von Gerätezwillingstags verwenden.
Gerätezwillingstags können als leistungsstarkes Tool als Hilfe beim Organisieren Ihrer Geräte verwendet werden. Dies ist besonders wichtig, wenn Ihre IoT-Lösungen mehrere Arten von Geräten enthalten. Dann können Sie mithilfe von Tags Typen, Standorte usw. festlegen. Beispiel:
{
"deviceId": "mydevice1",
"status": "enabled",
"connectionState": "Connected",
"cloudToDeviceMessageCount": 0,
"authenticationType": "sas",
"tags": {
"deploymentLocation": {
"building": "43",
"floor": "1"
},
"deviceType":"HDCamera"
},
"properties": {
...
}
}
Voraussetzungen
Einen IoT Hub. Erstellen Sie einen mit der CLI oder dem Azure-Portal.
Mindestens zwei registrierte Geräte. Registrieren Sie Geräte im Azure-Portal.
Hinzufügen und Anzeigen von Gerätezwillingstags über das Azure-Portal
In diesem Abschnitt wird beschrieben, wie Sie über das Azure-Portal einen IoT-Hub erstellen:
Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Ihrem IoT Hub.
Wählen Sie im linken Navigationsbereich die Registerkarte Gerät aus.
Wählen Sie die gewünschten Geräte und dann Tags zuweisen aus.
In der geöffneten Ansicht können Sie die Tags sehen, die den Geräten bereits zugewiesen wurden. Zum Hinzufügen eines neuen Basis-Tags geben Sie dafür einen Namen und einen Wert an. Das Format für das Name-Wert-Paar befindet sich in Format von Tags und Eigenschaften. Wählen Sie Speichern aus, um das Tag zu speichern.
Nach dem Speichern können Sie die hinzugefügten Tags anzeigen, indem Sie Tags zuweisen erneut auswählen.
Hinzufügen und Anzeigen von geschachtelten Tags
- Anhand des vorstehenden Beispiels können Sie ein geschachteltes Tag hinzufügen, indem Sie in Tags zuweisen die Registerkarte „Erweitert“ auswählen und ein geschachteltes JSON-Objekt mit zwei Werten hinzufügen.
{ "deploymentLocation": { "building": "43", "floor": "1" } }
- Wählen Sie Speichern aus.
- Wählen Sie die Geräte erneut und dann Tags zuweisen aus, um die neu hinzugefügten Tags anzuzeigen .
Filtern von Geräten mit Gerätezwillingstags
Gerätezwillingstags sind eine hervorragende Möglichkeit zum Gruppieren von Geräten nach Typ, Standort usw., und Sie können Ihre Geräte verwalten, indem Sie über Gerätetags filtern.
- Wählen Sie + Filter hinzufügen und dann Gerätetag als Filtertyp aus.
- Geben Sie den gewünschten Tagnamen und -wert ein, und wählen Sie Übernehmen aus, um die Liste der Geräte abzurufen, die den Kriterien entsprechen .
Aktualisieren und Löschen von Gerätezwillingstags aus mehreren Geräten über das Azure-Portal
- Wählen Sie zwei oder mehr Geräte und dann Tags zuweisen aus.
- Im geöffneten Bereich können Sie vorhandene Tags aktualisieren, indem Sie den Namen des Zieltags im Feld Name und die neue Zeichenfolge im Feld Wert eingeben.
- Zum Löschen eines Tag aus mehreren Geräten geben Sie den Namen des Zieltags im Feld Name ein, und wählen Sie die Schaltfläche Tags löschen aus.
- Wählen Sie Speichern aus, um das Tag aus den Geräten zu löschen, die den entsprechenden Tagnamen enthalten.
Verwalten von Gerätezwillingstags mithilfe der Azure-Befehlszeilenschnittstelle (Azure CLI)
Im folgenden Abschnitt werden mehrere Beispiele für das Tagging mithilfe der Azure CLI beschrieben. Vollständige Referenzen zur Gerätezwillings-CLI
Führen Sie an der Eingabeaufforderung den Anmeldebefehl aus:
az login
Befolgen Sie die Anweisungen zur Authentifizierung mit dem Code, und melden Sie sich in einem Webbrowser bei Ihrem Azure-Konto an.
Wenn Sie über mehrere Azure-Abonnements verfügen, erhalten Sie durch die Anmeldung bei Azure Zugriff auf alle Azure-Konten, die mit Ihren Anmeldeinformationen verknüpft sind. Verwenden Sie die az account list zum Anzeigen der vollständigen Liste von Konten:
az account list
Führen Sie den folgenden Befehl aus, um das Abonnement auszuwählen, das Sie zum Ausführen der Befehle zum Erstellen Ihres IoT Hubs verwenden möchten. Sie können entweder den Abonnementnamen oder die ID aus der Ausgabe des vorherigen Befehls verwenden:
az account set --subscription {your subscription name or id}
Der folgende Befehl aktiviert Dateibenachrichtigungen und legt die Dateibenachrichtigungseigenschaften auf ihre Standardwerte fest. (Der TTL-Wert für Dateiuploadbenachrichtigungen wird auf eine Stunde und die Sperrdauer auf 60 Sekunden festgelegt.)
az iot hub device-twin update -n {iothub_name} \ -d {device_id} --tags '{"country": "USA"}'
Sie können komplexe geschachtelte Tags hinzufügen, indem Sie eine JSON-Datei importieren oder JSON der Eingabe direkt hinzufügen:
az iot hub device-twin update --name {your iot hub name} \ -d {device_id} --tags /path/to/file
az iot hub device-twin update --name {your iot hub name} \ -d {device_id} --tags '{"country":{"county":"king"}}'
Verwenden Sie den Befehl für ein vorhandenes Tag, um den Wert zu aktualisieren:
az iot hub device-twin update --name {your iot hub name} \ -d {device_id} --tags '{"country": "Germany"}'
Mit dem folgenden Befehl wird das Tag entfernt, das durch Festlegen des Werts auf NULL hinzugefügt wurde.
az iot hub device-twin update --name {your iot hub name} \ -d {device_id} --tags '{"country": null}'
Hinweis
Wenn Sie PowerShell oder „CloudShell“>„PowerShell-Modus“ verwenden, müssen Sie einen Schrägstrich „\“ als Escapezeichen für alle doppelten Anführungszeichen hinzufügen. Beispiel: --tags '{\"country\":\"US\"}'
Erstellen von Aufträgen zum Festlegen von Tags mithilfe der Azure-Befehlszeilenschnittstelle (Azure CLI)
Vollständige Referenzen zur CLI für IoT Hub-Aufträge
Nächste Schritte
Nachdem Sie nun etwas über Gerätezwillinge erfahren haben, sind möglicherweise die folgenden Themen aus dem IoT Hub-Entwicklerhandbuch für Sie interessant:
- Verstehen und Verwenden von Modulzwillingen in IoT Hub
- Aufrufen einer direkten Methode auf einem Gerät
- Planen von Aufträgen auf mehreren Geräten
Um einige der in diesem Artikel beschriebenen Konzepte auszuprobieren, sehen Sie sich die folgenden IoT Hub-Tutorials an: