az iot du device deployment
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 Deployment-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen
Gerätebereitstellungsverwaltung.
Bereitstellungen wenden ein gewünschtes kompatibles Update für eine Zielgerätegruppe an, die das Update über Geräteklassen innerhalb der Gruppe verteilt. Die in der Cloud initiierte Rollbackrichtlinie kann optional konfiguriert werden.
Befehle
Name | Beschreibung | Typ | Status |
---|---|---|---|
az iot du device deployment cancel |
Abbrechen einer Geräteklassenuntergruppenbereitstellung. |
Erweiterung | Allgemein verfügbar |
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. |
Erweiterung | Allgemein verfügbar |
az iot du device deployment delete |
Löschen Sie eine Bereitstellung nach Gerätegruppe oder Geräteklassenuntergruppe. |
Erweiterung | Allgemein verfügbar |
az iot du device deployment list |
Auflisten von Bereitstellungen für eine Gerätegruppe oder Geräteklassenuntergruppe. |
Erweiterung | Allgemein verfügbar |
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. |
Erweiterung | Allgemein verfügbar |
az iot du device deployment retry |
Wiederholen Sie die Bereitstellung einer Geräteklassenuntergruppe. |
Erweiterung | Allgemein verfügbar |
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. |
Erweiterung | Allgemein verfügbar |
az iot du device deployment cancel
Abbrechen einer Geräteklassenuntergruppenbereitstellung.
az iot du device deployment cancel --account
--cid
--deployment-id
--gid
--instance
[--resource-group]
Beispiele
Abbrechen der Bereitstellung der Untergruppenbereitstellung der Zielgeräteklasse.
az iot du device deployment cancel -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_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.
Die vom Aufrufer bereitgestellte Bereitstellungs-ID. Dies darf nicht länger als 73 Zeichen sein, muss kleingeschrieben sein und darf nicht '&', '^', '[', ']', '{', '}', '|', '', '<>', Schrägstrich, umgekehrter Schrägstrich oder doppeltes Anführungszeichen enthalten.
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äteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>
.
Optionale Parameter
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 deployment create
Erstellen Sie eine Bereitstellung für eine Gerätegruppe. Die Bereitstellung wird für jede Geräteklassenuntergruppe innerhalb der Zielgruppe multicasten.
az iot du device deployment create --account
--deployment-id
--gid
--instance
--un
--up
--update-version
[--failed-count]
[--failed-percentage]
[--rbun]
[--rbup]
[--rbuv]
[--resource-group]
[--start-time]
Beispiele
Erstellen Sie eine Gerätegruppenbereitstellung, die für den sofortigen Start geplant ist (im Hinblick auf UTC-Zeit).
az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version}
Erstellen Sie eine Gerätegruppenbereitstellung, die für den Start auf einer gewünschten iso-8601-kompatiblen Datumszeit geplant ist.
az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --start-time "2022-12-20T01:00:00"
Erstellen Sie eine Gerätegruppenbereitstellung, die für den sofortigen Start mit einer definierten cloudinitiierten Rollbackrichtlinie geplant ist. Das Cloudrollback wird initiiert, wenn fehleranzahl oder fehlgeschlagene Prozentziele erreicht werden.
az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --failed-count 10 --failed-percentage 5 --rollback-update-name {rollback_update_name} --rollback-update-provider {rollback_update_provider} --rollback-update-version {rollback_update_version}
Erforderliche Parameter
Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>
.
Die vom Aufrufer bereitgestellte Bereitstellungs-ID. Dies darf nicht länger als 73 Zeichen sein, muss kleingeschrieben sein und darf nicht '&', '^', '[', ']', '{', '}', '|', '', '<>', Schrägstrich, umgekehrter Schrägstrich oder doppeltes Anführungszeichen enthalten.
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äteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>
.
Der Updatename.
Der Updateanbieter.
Die Updateversion.
Optionale Parameter
Ganze Zahl, die die Anzahl der fehlgeschlagenen Geräte in einer Bereitstellung darstellt, bevor ein in der Cloud initiertes Rollback auftritt. Erforderlich beim Definieren der Rollbackrichtlinie.
Ganze Zahl, die den Prozentsatz der fehlgeschlagenen Geräte in einer Bereitstellung darstellt, bevor ein in der Cloud initiertes Rollback auftritt. Erforderlich beim Definieren der Rollbackrichtlinie.
Der Rollbackaktualisierungsname.
Der Rollbackupdateanbieter.
Die Rollbackupdateversion.
Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name>
konfigurieren.
Die iso-8601-kompatible Startzeit für die Bereitstellung. Wenn kein Wert angegeben wird, wird der entsprechende Wert für UTC 'now' verwendet.
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 deployment delete
Löschen Sie eine Bereitstellung nach Gerätegruppe oder Geräteklassenuntergruppe.
az iot du device deployment delete --account
--deployment-id
--gid
--instance
[--cid]
[--resource-group]
[--yes {false, true}]
Beispiele
Löschen Sie die Bereitstellung der Zielgerätegruppe.
az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id}
Löschen Sie die Bereitstellung der Untergruppenbereitstellung der Zielgeräteklasse.
az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}
Erforderliche Parameter
Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>
.
Die vom Aufrufer bereitgestellte Bereitstellungs-ID. Dies darf nicht länger als 73 Zeichen sein, muss kleingeschrieben sein und darf nicht '&', '^', '[', ']', '{', '}', '|', '', '<>', Schrägstrich, umgekehrter Schrägstrich oder doppeltes Anführungszeichen enthalten.
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äteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>
.
Optionale Parameter
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ä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 deployment list
Auflisten von Bereitstellungen für eine Gerätegruppe oder Geräteklassenuntergruppe.
az iot du device deployment list --account
--gid
--instance
[--cid]
[--order-by]
[--resource-group]
Beispiele
Auflisten von Bereitstellungen für eine Gerätegruppe.
az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id}
Auflisten von Bereitstellungen für die Ergebnisse der Gerätegruppenbestellung nach absteigender StartDateTime.
az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --order-by "startDateTime desc"
Auflisten von Bereitstellungen für eine Untergruppe der Geräteklasse.
az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id}
Erforderliche Parameter
Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>
.
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äteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>
.
Optionale Parameter
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.
Sortiert die zurückgegebenen Bereitstellungen. Sie können mit startDateTime [desc/asc] bestellen.
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 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.
az iot du device deployment list-devices --account
--cid
--deployment-id
--gid
--instance
[--filter]
[--resource-group]
Beispiele
Auflisten von Geräten in einer Untergruppenbereitstellung der Geräteklasse.
az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}
Auflisten von Geräten in einer Geräteklasse-Untergruppenbereitstellung nach deviceId und deviceState.
az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --filter "deviceId eq 'd0' and deviceState eq 'InProgress'"
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.
Die vom Aufrufer bereitgestellte Bereitstellungs-ID. Dies darf nicht länger als 73 Zeichen sein, muss kleingeschrieben sein und darf nicht '&', '^', '[', ']', '{', '}', '|', '', '<>', Schrägstrich, umgekehrter Schrägstrich oder doppeltes Anführungszeichen enthalten.
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äteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>
.
Optionale Parameter
Schränkt die zurückgegebenen Bereitstellungsgerätezustände ein. Sie können nach deviceId und moduleId und/oder deviceState filtern.
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 deployment retry
Wiederholen Sie die Bereitstellung einer Geräteklassenuntergruppe.
az iot du device deployment retry --account
--cid
--deployment-id
--gid
--instance
[--resource-group]
Beispiele
Wiederholen Sie die Bereitstellung der Untergruppenbereitstellung der Zielgeräteklasse.
az iot du device deployment retry -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_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.
Die vom Aufrufer bereitgestellte Bereitstellungs-ID. Dies darf nicht länger als 73 Zeichen sein, muss kleingeschrieben sein und darf nicht '&', '^', '[', ']', '{', '}', '|', '', '<>', Schrägstrich, umgekehrter Schrägstrich oder doppeltes Anführungszeichen enthalten.
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äteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>
.
Optionale Parameter
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 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.
az iot du device deployment show --account
--deployment-id
--gid
--instance
[--cid]
[--resource-group]
[--status {false, true}]
Beispiele
Anzeigen einer Bereitstellung für eine Gerätegruppe.
az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id}
Zeigt den Status einer Gerätegruppenbereitstellung an.
az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --status
Anzeigen einer Bereitstellung für eine Untergruppe der Geräteklasse.
az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}
Zeigt den Status einer Geräteklassenuntergruppenbereitstellung an.
az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --status
Erforderliche Parameter
Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>
.
Die vom Aufrufer bereitgestellte Bereitstellungs-ID. Dies darf nicht länger als 73 Zeichen sein, muss kleingeschrieben sein und darf nicht '&', '^', '[', ']', '{', '}', '|', '', '<>', Schrägstrich, umgekehrter Schrägstrich oder doppeltes Anführungszeichen enthalten.
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äteaktualisierungsinstanz. Sie können den Standardinstanznamen mithilfe von az config set defaults.adu_instance=<name>
.
Optionale Parameter
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äteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name>
konfigurieren.
Ruft den Status einer Bereitstellung ab, einschließlich einer Aufschlüsselung der Anzahl der Geräte, die in der Bereitstellung ausgeführt, abgeschlossen oder fehlgeschlagen sind.
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.