az iot central device-group
Hinweis
Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.30.0 oder höher). Die Erweiterung installiert automatisch beim ersten Ausführen eines az iot-zentralen Gerätegruppenbefehls . Weitere Informationen zu Erweiterungen
Verwalten und Konfigurieren von IoT Central-Gerätegruppen
Befehle
| az iot central device-group create |
Gerätegruppe erstellen. |
| az iot central device-group delete |
Löschen einer Gerätegruppe |
| az iot central device-group list |
Rufen Sie die Liste der Gerätegruppen für eine IoT Central-Anwendung ab. |
| az iot central device-group show |
Rufen Sie die Gerätegruppe nach ID ab. |
| az iot central device-group update |
Aktualisieren einer vorhandenen Gerätegruppe. |
az iot central device-group create
Gerätegruppe erstellen.
Hinweis: Heute wird nur eine Organisation unterstützt, werden in Kürze mehrere Organisationen unterstützt.
az iot central device-group create --app-id
--device-group-id
--display-name
--filter
[--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
[--central-api-uri]
[--description]
[--organizations]
[--token]Beispiele
Gerätegruppe erstellen.
az iot central device-group create --app-id {appid} --device-group-id {devicegroupid} --display-name "DeviceGroup1" --filter "SELECT * FROM devices WHERE $provisioned = true" --description "This is a default device group." --organizations {organization}Erforderliche Parameter
Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Info" für Ihre Anwendung im Hilfemenü.
Eindeutige ID der Gerätegruppe.
Anzeigename der Gerätegruppe.
Abfrage, die definiert, welche Geräte in dieser Gruppe enthalten sein sollen. [Abfragefilterbeispiel: SELECT * FROM devices WHERE $template = "dtmi:modelDefinition:dtdlv2"].
Optionale Parameter
Die API-Version für den angeforderten Vorgang.
Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.
Kurze Zusammenfassung der Gerätegruppe.
Liste der Organisations-IDs der Gerätegruppe.
Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich gegen die Azure CLI zu authentifizieren, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.
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 central device-group delete
Löschen einer Gerätegruppe
az iot central device-group delete --app-id
--device-group-id
[--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
[--central-api-uri]
[--token]Beispiele
Löschen einer Gerätegruppe
az iot central device-group delete --app-id {appid} --device-group-id {devicegroupid}Erforderliche Parameter
Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Info" für Ihre Anwendung im Hilfemenü.
Eindeutige ID der Gerätegruppe.
Optionale Parameter
Die API-Version für den angeforderten Vorgang.
Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.
Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich gegen die Azure CLI zu authentifizieren, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.
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 central device-group list
Rufen Sie die Liste der Gerätegruppen für eine IoT Central-Anwendung ab.
az iot central device-group list --app-id
[--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
[--central-api-uri]
[--token]Beispiele
Auflisten von Gerätegruppen in einer Anwendung
az iot central device-group list --app-id {appid}Erforderliche Parameter
Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Info" für Ihre Anwendung im Hilfemenü.
Optionale Parameter
Die API-Version für den angeforderten Vorgang.
Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.
Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich gegen die Azure CLI zu authentifizieren, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.
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 central device-group show
Rufen Sie die Gerätegruppe nach ID ab.
az iot central device-group show --app-id
--device-group-id
[--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
[--central-api-uri]
[--token]Beispiele
Rufen Sie die Gerätegruppe nach ID ab.
az iot central device-group show --app-id {appid} --device-group-id {devicegroupid}Erforderliche Parameter
Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Info" für Ihre Anwendung im Hilfemenü.
Eindeutige ID der Gerätegruppe.
Optionale Parameter
Die API-Version für den angeforderten Vorgang.
Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.
Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich gegen die Azure CLI zu authentifizieren, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.
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 central device-group update
Aktualisieren einer vorhandenen Gerätegruppe.
Hinweis: Heute wird nur eine Organisation unterstützt, werden in Kürze mehrere Organisationen unterstützt.
az iot central device-group update --app-id
--device-group-id
[--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
[--central-api-uri]
[--description]
[--display-name]
[--filter]
[--organizations]
[--token]Beispiele
Aktualisieren einer Gerätegruppe über Patch
az iot central device-group update --app-id {appid} --device-group-id {devicegroupid} --display-name {displayname} --filter {filter} --description {description} --organizations {organization}Erforderliche Parameter
Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Info" für Ihre Anwendung im Hilfemenü.
Eindeutige ID der Gerätegruppe.
Optionale Parameter
Die API-Version für den angeforderten Vorgang.
Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.
Kurze Zusammenfassung der Gerätegruppe.
Anzeigename der Gerätegruppe.
Abfrage, die definiert, welche Geräte in dieser Gruppe enthalten sein sollen. [Abfragefilterbeispiel: SELECT * FROM devices WHERE $template = "dtmi:modelDefinition:dtdlv2"].
Liste der Organisations-IDs der Gerätegruppe.
Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich gegen die Azure CLI zu authentifizieren, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.
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
Feedback senden und anzeigen für