Freigeben über


az iot du device

Note

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.67.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az iot du device Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Geräteupdate-Geräteverwaltung.

Befehle

Name Beschreibung Typ Status
az iot du device class

Geräteklasse und Geräteklassen-Untergruppenverwaltung.

Extension GA
az iot du device class delete

Löschen Einer Geräteklasse oder Geräteklassenuntergruppe.

Extension GA
az iot du device class list

Auflisten von Geräteklassen oder Untergruppen der Geräteklasse.

Extension GA
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.

Extension GA
az iot du device class update

Aktualisieren sie eine Geräteklasse.

Extension GA
az iot du device compliance

Dienstprogramme für die Gerätekompatibilität in der Instanzansicht.

Extension GA
az iot du device compliance show

Ruft die Aufschlüsselung der Anzahl der Geräte auf ihrem neuesten Update ab, haben neue Updates zur Verfügung oder werden gerade neue Updates empfangen.

Extension GA
az iot du device deployment

Gerätebereitstellungsverwaltung.

Extension GA
az iot du device deployment cancel

Abbrechen einer Geräteklassenuntergruppenbereitstellung.

Extension GA
az iot du device deployment create

Erstellen Sie eine Bereitstellung für eine Gerätegruppe. Die Bereitstellung wird für jede Geräteklassenuntergruppe innerhalb der Zielgruppe multicasten.

Extension GA
az iot du device deployment delete

Löschen Sie eine Bereitstellung nach Gerätegruppe oder Geräteklassenuntergruppe.

Extension GA
az iot du device deployment list

Auflisten von Bereitstellungen für eine Gerätegruppe oder Geräteklassenuntergruppe.

Extension GA
az iot du device deployment list-devices

Auflisten von Geräten in einer Untergruppenbereitstellung der Geräteklasse zusammen mit ihrem Status. Nützlich für das Abrufen einer Liste der fehlgeschlagenen Geräte.

Extension GA
az iot du device deployment retry

Wiederholen Sie die Bereitstellung einer Geräteklassenuntergruppe.

Extension GA
az iot du device deployment show

Zeigen Sie eine Bereitstellung für eine Gerätegruppe oder Geräteklassenuntergruppe an, einschließlich des Status, der eine Aufschlüsselung der Anzahl der in der Bereitstellung ausgeführten, abgeschlossenen oder fehlgeschlagenen Geräte enthält.

Extension GA
az iot du device group

Gerätegruppenverwaltung.

Extension GA
az iot du device group delete

Löschen sie eine Gerätegruppe.

Extension GA
az iot du device group list

Auflisten von Gerätegruppen innerhalb einer Instanz.

Extension GA
az iot du device group show

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

Extension GA
az iot du device health

Dienstprogramme für die Geräteintegritätsprüfung.

Extension GA
az iot du device health list

Geräteintegrität im Hinblick auf einen Zielfilter auflisten.

Extension GA
az iot du device import

Importieren Sie Geräte und Module aus einem verknüpften IoT Hub in die Device Update-Instanz.

Extension GA
az iot du device list

Auflisten von Geräteidentitäten, die in einer Instanz enthalten sind.

Extension GA
az iot du device log

Instanzprotokollsammlungsverwaltung.

Extension GA
az iot du device log collect

Konfigurieren sie einen Protokollauflistungsvorgang für Gerätediagnose auf bestimmten Geräten.

Extension GA
az iot du device log list

Listeninstanz-Diagnoseprotokollsammlungsvorgänge.

Extension GA
az iot du device log show

Anzeigen eines bestimmten Instanzdiagnoseprotokollsammlungsvorgangs.

Extension GA
az iot du device module

Gerätemodulverwaltung.

Extension GA
az iot du device module show

Anzeigen einer in die Instanz importierten Gerätemodulidentität.

Extension GA
az iot du device show

Anzeigen einer Geräteidentität, die in einer Instanz enthalten ist.

Extension GA

az iot du device import

Importieren Sie Geräte und Module aus einem verknüpften IoT Hub in die Device Update-Instanz.

az iot du device import --account
                        --instance
                        [--import-type --it {All, Devices, Modules}]
                        [--resource-group]

Beispiele

Importieren Sie Geräte und Module in eine Zielinstanz.

az iot du device import -n {account_name} -i {instance_name}

Importieren Sie nur Geräte.

az iot du device import -n {account_name} -i {instance_name} --import-type Devices

Importieren Sie nur Module.

az iot du device import -n {account_name} -i {instance_name} --import-type Modules

Erforderliche Parameter

--account -n

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

Eigenschaft Wert
Parametergruppe: Account Identifier Arguments
--instance -i

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

Eigenschaft Wert
Parametergruppe: Account Identifier Arguments

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--import-type --it

Die Gerätetypen, die aus IoT Hub importiert werden sollen.

Eigenschaft Wert
Standardwert: All
Zulässige Werte: All, Devices, Modules
--resource-group -g

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

Eigenschaft Wert
Parametergruppe: Account Identifier Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az iot du device list

Auflisten von Geräteidentitäten, die in einer Instanz enthalten sind.

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

Beispiele

Auflisten von Geräteidentitäten innerhalb einer Zielinstanz.

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

Auflisten von Geräteidentitäten innerhalb einer Zielinstanz, die nach einer gewünschten Gruppen-ID gefiltert wird.

az iot du device list -n {account_name} -i {instance_name} --filter "groupId eq 'myDeviceGroup'"

Erforderliche Parameter

--account -n

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

Eigenschaft Wert
Parametergruppe: Account Identifier Arguments
--instance -i

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

Eigenschaft Wert
Parametergruppe: Account Identifier Arguments

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--filter

Schränkt den zurückgegebenen Satz von Geräten ein. Sie können nach groupId, deviceClassId oder groupId und deploymentStatus filtern.

--resource-group -g

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

Eigenschaft Wert
Parametergruppe: Account Identifier Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az iot du device show

Anzeigen einer Geräteidentität, die in einer Instanz enthalten ist.

az iot du device show --account
                      --device-id
                      --instance
                      [--resource-group]

Beispiele

Anzeigen einer Geräteidentität innerhalb einer Zielinstanz.

az iot du device show -n {account_name} -i {instance_name} -d {device_id}

Erforderliche Parameter

--account -n

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

Eigenschaft Wert
Parametergruppe: Account Identifier Arguments
--device-id -d

Zielgeräte-ID.

--instance -i

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

Eigenschaft Wert
Parametergruppe: Account Identifier Arguments

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--resource-group -g

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

Eigenschaft Wert
Parametergruppe: Account Identifier Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False