Share via

az iot du device group

  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.37.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az iot du Device Group-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Gerätegruppenverwaltung.

Bei einer Gerätegruppe handelt es sich um eine Sammlung verwandter Geräte. Gerätegruppen bieten eine Möglichkeit zum Skalieren von Bereitstellungen auf viele Geräten. Jedes Gerät gehört jeweils zu genau einer Gerätegruppe. Eine Gerätegruppe wird automatisch erstellt, wenn ein Geräteupdate-fähiges Gerät mit dem Hub verbunden ist, und meldet dessen Eigenschaften.

Befehle

Name Beschreibung Typ Status
az iot du device group delete

Löschen sie eine Gerätegruppe.

 Durchwahl Allgemein verfügbar
az iot du device group list

Auflisten von Gerätegruppen innerhalb einer Instanz.

 Durchwahl Allgemein verfügbar
az iot du device group show

Zeigen Sie Details zu einer Gerätegruppe an, einschließlich der besten Update- und Updatecompliance.

 Durchwahl Allgemein verfügbar

az iot du device group delete

Löschen sie eine Gerätegruppe.

Gerätegruppen werden nicht automatisch sauber, sondern für Verlaufszwecke aufbewahrt. Dieser Vorgang kann verwendet werden, wenn die Gruppe nicht benötigt wird oder der Verlauf beibehalten werden muss. Wenn ein Gerät jemals erneut für eine Gruppe verbunden ist, nachdem die Gruppe gelöscht wurde, wird es automatisch ohne Verlauf neu erstellt.

az iot du device group delete --account
                              --gid
                              --instance
                              [--resource-group]
                              [--yes {false, true}]

Beispiele

Löschen sie eine Gerätegruppe.

az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id}

Löschen Sie eine Gerätegruppe, die die Bestätigungsaufforderung überspringt.

az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id} -y

Erforderliche Parameter

--account -n

Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>.

--gid --group-id

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.

--instance -i

Name der Geräteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>.

Optionale Parameter

--resource-group -g

Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name> konfigurieren.

--yes -y

Benutzeraufforderungen überspringen. Gibt die Annahme der Aktion an. Wird hauptsächlich für Automatisierungsszenarien verwendet. Standardwert: false.

Zulässige Werte: false, true
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot du device group list

Auflisten von Gerätegruppen innerhalb einer Instanz.

az iot du device group list --account
                            --instance
                            [--order-by]
                            [--resource-group]

Beispiele

Gerätegruppen auflisten.

az iot du device group list -n {account_name} -i {instance_name}

Auflisten von Gerätegruppen in einer gewünschten Reihenfolge, in diesem Fall nach deviceCount.

az iot du device group list -n {account_name} -i {instance_name} --order-by deviceCount

Erforderliche Parameter

--account -n

Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>.

--instance -i

Name der Geräteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>.

Optionale Parameter

--order-by

Sortiert die Gruppe der zurückgegebenen Gruppen. Sie können nach "groupId", "deviceCount", "createdDateTime", "subgroupsWithNewUpdatesAvailableCount", "subgroupsWithUpdatesInProgressCount" oder "subgroupsWithOnLatestUpdateCount" sortieren.

--resource-group -g

Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot du device group show

Zeigen Sie Details zu einer Gerätegruppe an, einschließlich der besten Update- und Updatecompliance.

az iot du device group show --account
                            --gid
                            --instance
                            [--best-updates {false, true}]
                            [--resource-group]
                            [--update-compliance {false, true}]

Beispiele

Anzeigen einer Gerätegruppe.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id}

Zeigen Sie die besten Updates an, die für eine Gerätegruppe verfügbar sind. Mit diesem Flag wird der Befehl so geändert, dass eine Liste zurückgegeben wird.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --best-updates

Aktualisierungscompliance für eine Gerätegruppe anzeigen.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --update-compliance

Erforderliche Parameter

--account -n

Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>.

--gid --group-id

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.

--instance -i

Name der Geräteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>.

Optionale Parameter

--best-updates

Flag, das angibt, dass der Befehl die besten verfügbaren Updates für die Gerätegruppe abrufen sollte, einschließlich der Anzahl der Geräte, die jedes Update benötigen. Ein optimales Update ist das neueste Update, das alle Kompatibilitätsspezifikationen einer Geräteklasse erfüllt.

Zulässige Werte: false, true
--resource-group -g

Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name> konfigurieren.

--update-compliance

Flag, das angibt, dass der Befehl Gerätegruppenaktualisierungscomplianceinformationen abrufen soll, z. B. wie viele Geräte auf ihrem neuesten Update sind, wie viele neue Updates benötigen und wie viele beim Empfang eines neuen Updates ausgeführt werden.

Zulässige Werte: false, true
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.