az iot du device class
Hinweis
Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.46.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az iot du Device Class-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen
Geräteklasse und Geräteklassen-Untergruppenverwaltung.
Eine Geräteklasse beschreibt eine Gruppe von Geräten, die einen gemeinsamen Satz von Attributen über Gruppen hinweg gemeinsam nutzen, während eine Untergruppe einer Geräteklasse eine Teilmenge von Geräten in einer Gruppe ist, die dieselbe Geräteklassen-ID gemeinsam verwenden. Geräteklassen werden automatisch erstellt, wenn geräteupdatefähige Geräte mit dem Hub verbunden sind.
Befehle
Name | Beschreibung | Typ | Status |
---|---|---|---|
az iot du device class delete |
Löschen Einer Geräteklasse oder Geräteklassenuntergruppe. |
Erweiterung | Allgemein verfügbar |
az iot du device class list |
Auflisten von Geräteklassen oder Untergruppen der Geräteklasse. |
Erweiterung | Allgemein verfügbar |
az iot du device class show |
Zeigen Sie Details zu einer Untergruppe der Geräteklasse oder Geräteklasse an, einschließlich installierbarer Updates, der besten Update- und Updatecompliance. |
Erweiterung | Allgemein verfügbar |
az iot du device class update |
Aktualisieren sie eine Geräteklasse. |
Erweiterung | Allgemein verfügbar |
az iot du device class delete
Löschen Einer Geräteklasse oder Geräteklassenuntergruppe.
Geräteklassen werden automatisch erstellt, wenn geräteupdatefähige Geräte mit dem Hub verbunden sind, aber nicht automatisch bereinigt werden, da sie von Untergruppen der Geräteklasse referenziert werden. Wenn alle Geräteklassenuntergruppen für eine Zielgeräteklasse gelöscht werden, kann die Geräteklasse selbst auch gelöscht werden, um die Datensätze aus dem System zu entfernen und die Kompatibilität der Geräteklasse mit neuen Updates zu beenden. Wenn ein Gerät jemals erneut verbunden wird, wird seine Geräteklasse erneut erstellt, wenn es nicht vorhanden ist.
az iot du device class delete --account
--cid
--instance
[--gid]
[--resource-group]
[--yes {false, true}]
Beispiele
Löschen sie eine Geräteklasse.
az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id}
Löschen Sie eine Geräteklasse, und überspringen Sie die Bestätigungsaufforderung.
az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} -y
Löschen sie eine Untergruppe der Geräteklasse.
az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id}
Erforderliche Parameter
Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>
.
Geräteklassen-ID. Dies wird aus der Modell-ID und den compat-Eigenschaften generiert, die vom Geräteupdate-Agent in der Device Update PnP-Schnittstelle im IoT Hub gemeldet werden. Es handelt sich um einen hexcodierten SHA1-Hash.
Name der Geräteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>
.
Optionale Parameter
Gerätegruppen-ID. Dies wird aus dem Wert des ADUGroup-Tags im verbundenen IoT Hub-Gerät/Modul twin oder $default für Geräte ohne Tag erstellt.
Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name>
konfigurieren.
Benutzeraufforderungen überspringen. Gibt die Annahme der Aktion an. Wird hauptsächlich für Automatisierungsszenarien verwendet. Standardwert: false.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az iot du device class list
Auflisten von Geräteklassen oder Untergruppen der Geräteklasse.
az iot du device class list --account
--instance
[--filter]
[--gid]
[--resource-group]
Beispiele
Auflisten von Geräteklassen innerhalb einer Instanz.
az iot du device class list -n {account_name} -i {instance_name}
Listeninstanzgeräteklassen nach Anzeigenamen gefiltert.
az iot du device class list -n {account_name} -i {instance_name} --filter "friendlyName eq 'my-favorite-class'"
Auflisten von Geräteklassenuntergruppen für die Gruppe.
az iot du device class list -n {account_name} -i {instance_name} --group-id {device_group_id}
Auflisten von Geräteklassenuntergruppen für die Gruppe, gefiltert nach compatProperties/manufacturer.
az iot du device class list -n {account_name} -i {instance_name} --group-id {device_group_id} --filter "compatProperties/manufacturer eq 'Contoso'"
Erforderliche Parameter
Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>
.
Name der Geräteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>
.
Optionale Parameter
Wenn sie mit "--group-id" bereitgestellt werden, unterstützt die Filterung basierend auf Den Namen und Werten der Geräteklasse. Beispiel: "compatProperties/manufacturer eq 'Contoso'". Unterstützt andernfalls das Filtern nach Anzeigenamen der Klasse.
Gerätegruppen-ID. Dies wird aus dem Wert des ADUGroup-Tags im verbundenen IoT Hub-Gerät/Modul twin oder $default für Geräte ohne Tag erstellt.
Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name>
konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az iot du device class show
Zeigen Sie Details zu einer Untergruppe der Geräteklasse oder Geräteklasse an, einschließlich installierbarer Updates, der besten Update- und Updatecompliance.
az iot du device class show --account
--cid
--instance
[--best-update {false, true}]
[--gid]
[--installable-updates {false, true}]
[--resource-group]
[--update-compliance {false, true}]
Beispiele
Anzeigen einer Geräteklasse.
az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id}
Zeigen Sie installierbare Updates für die Geräteklasse an. Mit diesem Flag wird der Befehl so geändert, dass eine Liste zurückgegeben wird.
az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --installable-updates
Anzeigen einer Untergruppe der Geräteklasse.
az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id}
Zeigen Sie das beste Update an, das für eine Untergruppe der Geräteklasse verfügbar ist.
az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id} --best-update
Aktualisierungscompliance für eine Untergruppe der Geräteklasse anzeigen.
az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id} --update-compliance
Erforderliche Parameter
Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>
.
Geräteklassen-ID. Dies wird aus der Modell-ID und den compat-Eigenschaften generiert, die vom Geräteupdate-Agent in der Device Update PnP-Schnittstelle im IoT Hub gemeldet werden. Es handelt sich um einen hexcodierten SHA1-Hash.
Name der Geräteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>
.
Optionale Parameter
Flag, das angibt, dass der Befehl das beste verfügbare Update für die Untergruppe der Geräteklasse abrufen sollte, einschließlich der Anzahl der Geräte, die das Update benötigen. Die Gruppen-ID ist für dieses Flag erforderlich. Ein optimales Update ist das neueste Update, das alle Kompatibilitätsspezifikationen einer Geräteklasse erfüllt.
Gerätegruppen-ID. Dies wird aus dem Wert des ADUGroup-Tags im verbundenen IoT Hub-Gerät/Modul twin oder $default für Geräte ohne Tag erstellt.
Flag, das angibt, dass der Befehl installierbare Updates für die Geräteklasse abrufen soll.
Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name>
konfigurieren.
Flag, das angibt, dass der Befehl Informationen zur Geräteklasse-Untergruppenaktualisierung abrufen soll, z. B. wie viele Geräte auf ihrem neuesten Update vorhanden sind, wie viele neue Updates benötigen und wie viele beim Empfang eines neuen Updates in Bearbeitung sind. Die Gruppen-ID ist für dieses Flag erforderlich.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az iot du device class update
Aktualisieren sie eine Geräteklasse.
az iot du device class update --account
--cid
--instance
[--friendly-name]
[--resource-group]
Beispiele
Aktualisieren Sie den Anzeigenamen der Geräteklasse.
az iot du device class update -n {account_name} -i {instance_name} --class-id {device_class_id} --friendly-name "EU-region"
Erforderliche Parameter
Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>
.
Geräteklassen-ID. Dies wird aus der Modell-ID und den compat-Eigenschaften generiert, die vom Geräteupdate-Agent in der Device Update PnP-Schnittstelle im IoT Hub gemeldet werden. Es handelt sich um einen hexcodierten SHA1-Hash.
Name der Geräteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>
.
Optionale Parameter
Der Anzeigename der Geräteklasse. Der Anzeigename muss 1 bis 100 Zeichen lang sein und unterstützt alphanumerische, Punkt- und Strichwerte.
Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name>
konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für