az iot du update

  • 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 update-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Geräteupdate-Updateverwaltung.

Befehle

Name Beschreibung Typ Status
az iot du update calculate-hash

Berechnen Sie die base64-Hashdarstellung einer Datei.

 Durchwahl Allgemein verfügbar
az iot du update delete

Löschen Sie eine bestimmte Updateversion.

 Durchwahl Allgemein verfügbar
az iot du update file

Aktualisieren von Dateivorgängen.

 Durchwahl Allgemein verfügbar
az iot du update file list

Auflisten von Updatedatei-IDs in Bezug auf Updateanbieter, Name und Version.

 Durchwahl Allgemein verfügbar
az iot du update file show

Zeigen Sie die Details einer bestimmten Updatedatei in Bezug auf Updateanbieter, Name und Version an.

 Durchwahl Allgemein verfügbar
az iot du update import

Importieren Sie eine neue Updateversion in die Device Update-Instanz.

 Durchwahl Allgemein verfügbar
az iot du update init

Hilfsprogramm für die Importmanifestinitialisierung.

 Durchwahl Vorschau
az iot du update init v5

Initialisieren Sie ein v5-Importmanifest mit dem gewünschten Zustand.

 Durchwahl Vorschau
az iot du update list

Auflisten von Updates, die in die Device Update-Instanz importiert wurden.

 Durchwahl Allgemein verfügbar
az iot du update show

Zeigen Sie eine bestimmte Updateversion an.

 Durchwahl Allgemein verfügbar
az iot du update stage

Stellen Sie ein Update für den Import in eine Zielinstanz bereit.

 Durchwahl Vorschau

az iot du update calculate-hash

Berechnen Sie die base64-Hashdarstellung einer Datei.

az iot du update calculate-hash --file-path
                                [--hash-algo {sha256}]

Beispiele

Berechnen Sie die Base64-Darstellung eines Sha256-Digests für eine Zielaktualisierungsdatei.

az iot du update calculate-hash --file-path /path/to/file

Berechnen Sie die Base64-Darstellung eines Sha256-Digests für mehrere Zielaktualisierungsdateien.

az iot du update calculate-hash --file-path /path/to/file1 --file-path /path/to/file2 --file-path /path/to/file3

Erforderliche Parameter

--file-path -f

Lokaler Pfad zur Zieldatei für Hashberechnung. --file-path kann 1 oder mehr verwendet werden.

Optionale Parameter

--hash-algo

Kryptografiealgorithmus, der für hashing verwendet werden soll.

Zulässige Werte: sha256
Standardwert: sha256
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 update delete

Löschen Sie eine bestimmte Updateversion.

az iot du update delete --account
                        --instance
                        --un
                        --up
                        --update-version
                        [--no-wait]
                        [--resource-group]
                        [--yes {false, true}]

Beispiele

Löschen Sie ein Zielupdate in Bezug auf Updateanbieter, Name und Version.

az iot du update delete -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

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

--un --update-name

Der Updatename.

--up --update-provider

Der Updateanbieter.

--update-version --uv

Die Updateversion.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--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 update import

Importieren Sie eine neue Updateversion in die Device Update-Instanz.

Dieser Befehl unterstützt die --defer Funktion. Wenn der Befehl verwendet wird, speichert die Objektnutzlast, die an Azure gesendet werden soll, in einem lokalen Cache. Die nächste Verwendung dieses Befehls, ohne --defer die neue Anforderungsnutzlast mit den zwischengespeicherten Objekten zu kombinieren, die sie zusammen senden.

Bei Erfolg wird der entsprechende lokale Cacheeintrag gelöscht. Wenn ein Fehler auftritt, werden zwischengespeicherte Inhalte nicht entfernt. Verwenden Sie az cache Befehle, um lokale Cacheeinträge unabhängig voneinander zu verwalten.

Die Zurückstellungsunterstützung ist in erster Linie für Updates mit mehreren Referenzschritten vorgesehen, sodass übergeordnete und untergeordnete Updates zusammen übermittelt werden können.

az iot du update import --account
                        --instance
                        --url
                        [--defer]
                        [--file]
                        [--friendly-name]
                        [--hashes]
                        [--no-wait]
                        [--resource-group]
                        [--size]

Beispiele

Importieren Sie ein Update mit zwei verwandten Dateien und keine Referenzschritte, und stellen Sie explizit Manifesthashwert und Manifestgröße in Byte bereit.

az iot du update import -n {account_name} -i {instance_name} --hashes sha256={hash_value} --size {size_in_bytes} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Importieren Sie ein Update mit zwei verwandten Dateien und keine Referenzschritte, sodass die CLI den Importmanifesthashwert und die Größe in Bytes berechnen kann.

az iot du update import -n {account_name} -i {instance_name} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Importieren Sie ein übergeordnetes Update mit zwei untergeordneten Updateverweisschritten, wobei alle drei Importmanifeste über eine zugehörige Datei verfügen. Ermöglicht der CLI die Berechnung des Hashwerts und der Größe in Byte für alle. Dieser Vorgang basiert auf der Funktion "--defer".

az iot du update import -n {account_name} -i {instance_name} --url {parent_manifest_location} --file filename={parent_file_name} url={parent_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child1_manifest_location} --file filename={child1_file_name} url={child1_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child2_manifest_location} --file filename={child2_file_name} url={child2_file_url}

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

--url

Routingfähiger Speicherort, von dem das Importmanifest von Device Update für IoT Hub heruntergeladen werden kann. Dies ist in der Regel eine schreibgeschützte SAS-geschützte BLOB-URL mit einem Ablaufsatz auf mindestens 3 Stunden.

Optionale Parameter

--defer

Speichert das Objekt temporär im lokalen Cache, anstatt es an Azure zu senden. Verwenden Sie az cache Befehle zum Anzeigen/Löschen.

--file

Leerzeichentrennte Schlüssel-Wertpaare, die dem Importieren von Eigenschaften der Manifestmetadatendatei entsprechen. Erforderliche Schlüssel umfassen Dateinamen und URL. --file kann 1 oder mehr verwendet werden.

--friendly-name

Anzeigename, der der Updatedefinition zugeordnet ist.

--hashes

Leerzeichentrennte Schlüssel=Wertpaare, wobei der Schlüssel der verwendete Hashalgorithmus ist und der Wert der base64-codierte Importmanifestdateihash ist. Mindestens ein Sha256-Eintrag ist erforderlich. Wenn sie nicht angegeben wird, wird sie anhand der bereitgestellten URL berechnet.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--resource-group -g

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

--size

Dateigröße in Byte Wenn sie nicht angegeben wird, wird sie anhand der bereitgestellten URL berechnet.

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 update list

Auflisten von Updates, die in die Device Update-Instanz importiert wurden.

Beim Auflisten von Updateanbietern muss zusätzlich zu den allgemeinen Nachschlageargumenten nur das Flag "-by-provider" angegeben werden. Beim Auflisten von Updatenamen muss der Updateanbieter angegeben werden. Beim Auflisten von Updateversionen muss der Updateanbieter und der Updatename angegeben werden.

az iot du update list --account
                      --instance
                      [--by-provider {false, true}]
                      [--filter]
                      [--resource-group]
                      [--search]
                      [--un]
                      [--up]

Beispiele

Alle Updates auflisten.

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

Listet alle Updates auf, die einen Freitext-Suchkriterien erfüllen, in diesem Fall der Updateanbieter von Contoso.

az iot du update list -n {account_name} -i {instance_name} --search 'Contoso'

Listet alle Updates auf, die einen odata-Filter erfüllen, in diesem Fall nach nicht bereitgestellten Updates.

az iot du update list -n {account_name} -i {instance_name} --filter 'isDeployable eq false'

Listet alle Updateanbieter auf.

az iot du update list -n {account_name} -i {instance_name} --by-provider

Listet alle Updatenamen nach Updateanbieter auf.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name}

Listet alle Updateversionen nach Updateanbieter und Updatename auf.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name}

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

--by-provider

Flag, das angibt, dass das Resultset auf Updateanbieter beschränkt werden soll.

Zulässige Werte: false, true
--filter

Schränkt den Satz von Updates ein, die von Eigenschaftswerten zurückgegeben werden. Unterstützt beim Auflisten von Updates ohne Einschränkungen oder beim Auflisten nach Version.

--resource-group -g

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

--search

Fordern Sie Aktualisierungen an, die einem Freitext-Suchausdruck entsprechen. Wird unterstützt, wenn Updates ohne Einschränkungen aufgelistet werden.

--un --update-name

Der Updatename.

--up --update-provider

Der Updateanbieter.

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 update show

Zeigen Sie eine bestimmte Updateversion an.

az iot du update show --account
                      --instance
                      --un
                      --up
                      --update-version
                      [--resource-group]

Beispiele

Zeigen Sie ein bestimmtes Update in Bezug auf Updateanbieter, Name und Version an.

az iot du update show -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

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

--un --update-name

Der Updatename.

--up --update-provider

Der Updateanbieter.

--update-version --uv

Die Updateversion.

Optionale Parameter

--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 update stage

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Stellen Sie ein Update für den Import in eine Zielinstanz bereit.

Das Staging eines Updates bezieht sich auf die Beschleunigung der erforderlichen Schritte zum Importieren eines Updates in eine Zielinstanz. Für ein bestimmtes Importmanifest bestimmt der Prozess relevante Dateien, pusht sie an einen gewünschten Speichercontainer, generiert SAS-URIs und deckt andere Vorbereitungsschritte für einen erfolgreichen Import ab.

Dieser Befehl hängt von einer konventionsbasierten Organisation von Updatedateien ab. Es wird erwartet, dass alle Updatedateien für ein Zielmanifest im selben Verzeichnis enthalten sind, in dem sich das Importmanifest befindet.

Schlüsselbasierter Zugriff wird verwendet, um BLOB-Artefakte hochzuladen und SAS-URIs mit Lesezugriff zu generieren.

Wenn --then-import die Kennzeichnung angegeben wird, importiert der Befehl das mehrstufige Update. Andernfalls ist das Ergebnis dieses Vorgangs ein Importbefehl, der ausgeführt werden soll, um dasselbe Ergebnis zu einem späteren Zeitpunkt zu erzielen.

Mit diesem Befehl werden alle lokalen Cacheeinträge für die Zielinstanz gelöscht und aktualisiert.

az iot du update stage --account
                       --instance
                       --manifest-path
                       --storage-account
                       --storage-container
                       [--friendly-name]
                       [--overwrite {false, true}]
                       [--resource-group]
                       [--storage-subscription]
                       [--then-import {false, true}]

Beispiele

Stufen Sie ein eigenständiges Update auf. Aktualisierungsdateien werden voraussichtlich im selben Verzeichnis wie das Manifest gespeichert. Der resultierende Importbefehl kann zu einem späteren Zeitpunkt ausgeführt werden, um den Import des mehrstufigen Updates vor dem ABLAUF des SAS-Tokens zu initiieren.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json

Stufen Sie ein eigenständiges Update auf. Importieren Sie nach dem Staging das Update mithilfe eines gewünschten Anzeigenamens in die Instanz.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json --then-import --friendly-name myAptUpdate

Stufen Sie ein Mehrverweisupdate auf. Updatedateien werden in einen Speicher-BLOB-Container hochgeladen, der sich in einem anderen Abonnement des Updatekontos befindet.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --storage-subscription {storage_account_subscription} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json

Stellen Sie ein Update mit mehreren Verweisen fest, wobei vorhandene Blobs überschrieben werden, sofern vorhanden. Importieren Sie nach dem Staging das Update in die Instanz.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json --then-import --overwrite

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

--manifest-path

Lokaler Dateipfad zum Importmanifest, das stufend sein soll. Kann 1 oder mehr mal verwendet werden.

--storage-account

Der gewünschte Speicherkontoname zum Stufenimportmanifestartefakte.

--storage-container

Der gewünschte Speichercontainername zum Stufenimportmanifestartefakte.

Optionale Parameter

--friendly-name

Anzeigename, der der Updatedefinition zugeordnet ist.

--overwrite

Flag, das angibt, ob vorhandene Blobs überschrieben werden sollen, wenn ein Konflikt vorhanden ist.

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

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

--storage-subscription

Gewünschtes Speicherkontoabonnement zum Stufenimportmanifestartefakte. Gilt, wenn sich die Speicher- und Geräteaktualisierungskonten in verschiedenen Abonnements befinden.

--then-import

Flag, das angibt, ob das Update nach dem Staging importiert werden soll.

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.