Freigeben über

az iot du device deployment

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 ein az iot du Device Deployment Befehl ausführen. Erfahren Sie mehr über 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.

 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 deployment cancel

Abbrechen einer Geräteklassenuntergruppenbereitstellung.

az iot du device deployment cancel --account
                                   --cid --class-id
                                   --deployment-id --did
                                   --gid --group-id
                                   --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

--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
--cid --class-id

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.

--deployment-id --did

Die vom Aufrufer bereitgestellte Bereitstellungs-ID. Dies darf nicht länger als 73 Zeichen sein, muss kleingeschrieben sein und darf keine Anführungszeichen enthalten &, ^, [, ]{}|<, >schräg, umgekehrter Schrägstrich oder doppeltes Anführungszeichen.

--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}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

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 --did
                                   --gid --group-id
                                   --instance
                                   --un --update-name
                                   --up --update-provider
                                   --update-version --uv
                                   [--failed-count --fc]
                                   [--failed-percentage --fp]
                                   [--rbun --rollback-update-name]
                                   [--rbup --rollback-update-provider]
                                   [--rbuv --rollback-update-version]
                                   [--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

--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
--deployment-id --did

Die vom Aufrufer bereitgestellte Bereitstellungs-ID. Dies darf nicht länger als 73 Zeichen sein, muss kleingeschrieben sein und darf keine Anführungszeichen enthalten &, ^, [, ]{}|<, >schräg, umgekehrter Schrägstrich oder doppeltes Anführungszeichen.

--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}konfigurieren.

Eigenschaft Wert
Parametergruppe: Account Identifier Arguments
--un --update-name

Der Updatename.

Eigenschaft Wert
Parametergruppe: Update Id Arguments
--up --update-provider

Der Updateanbieter.

Eigenschaft Wert
Parametergruppe: Update Id Arguments
--update-version --uv

Die Updateversion.

Eigenschaft Wert
Parametergruppe: Update Id 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.

--failed-count --fc

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.

Eigenschaft Wert
Parametergruppe: Update Rollback Policy Arguments
--failed-percentage --fp

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.

Eigenschaft Wert
Parametergruppe: Update Rollback Policy Arguments
--rbun --rollback-update-name

Der Rollbackaktualisierungsname.

Eigenschaft Wert
Parametergruppe: Update Rollback Policy Arguments
--rbup --rollback-update-provider

Der Rollbackupdateanbieter.

Eigenschaft Wert
Parametergruppe: Update Rollback Policy Arguments
--rbuv --rollback-update-version

Die Rollbackupdateversion.

Eigenschaft Wert
Parametergruppe: Update Rollback Policy Arguments
--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
--start-time

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
--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 deployment delete

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

az iot du device deployment delete --account
                                   --deployment-id --did
                                   --gid --group-id
                                   --instance
                                   [--cid --class-id]
                                   [--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

--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
--deployment-id --did

Die vom Aufrufer bereitgestellte Bereitstellungs-ID. Dies darf nicht länger als 73 Zeichen sein, muss kleingeschrieben sein und darf keine Anführungszeichen enthalten &, ^, [, ]{}|<, >schräg, umgekehrter Schrägstrich oder doppeltes Anführungszeichen.

--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}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.

--cid --class-id

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.

--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
--yes -y

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

Eigenschaft Wert
Zulässige Werte: false, true
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 deployment list

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

az iot du device deployment list --account
                                 --gid --group-id
                                 --instance
                                 [--cid --class-id]
                                 [--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

--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
--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}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.

--cid --class-id

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.

--order-by

Sortiert die zurückgegebenen Bereitstellungen. Sie können mit startDateTime [desc/asc] bestellen.

--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 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 --class-id
                                         --deployment-id --did
                                         --gid --group-id
                                         --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

--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
--cid --class-id

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.

--deployment-id --did

Die vom Aufrufer bereitgestellte Bereitstellungs-ID. Dies darf nicht länger als 73 Zeichen sein, muss kleingeschrieben sein und darf keine Anführungszeichen enthalten &, ^, [, ]{}|<, >schräg, umgekehrter Schrägstrich oder doppeltes Anführungszeichen.

--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}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 die zurückgegebenen Bereitstellungsgerätezustände ein. Sie können nach deviceId und moduleId und/oder deviceState 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 deployment retry

Wiederholen Sie die Bereitstellung einer Geräteklassenuntergruppe.

az iot du device deployment retry --account
                                  --cid --class-id
                                  --deployment-id --did
                                  --gid --group-id
                                  --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

--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
--cid --class-id

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.

--deployment-id --did

Die vom Aufrufer bereitgestellte Bereitstellungs-ID. Dies darf nicht länger als 73 Zeichen sein, muss kleingeschrieben sein und darf keine Anführungszeichen enthalten &, ^, [, ]{}|<, >schräg, umgekehrter Schrägstrich oder doppeltes Anführungszeichen.

--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}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

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 --did
                                 --gid --group-id
                                 --instance
                                 [--cid --class-id]
                                 [--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

--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
--deployment-id --did

Die vom Aufrufer bereitgestellte Bereitstellungs-ID. Dies darf nicht länger als 73 Zeichen sein, muss kleingeschrieben sein und darf keine Anführungszeichen enthalten &, ^, [, ]{}|<, >schräg, umgekehrter Schrägstrich oder doppeltes Anführungszeichen.

--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}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.

--cid --class-id

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.

--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
--status

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.

Eigenschaft Wert
Zulässige Werte: false, true
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