Partager via

az iot du update

  • Référence

Remarque

Cette référence fait partie de l’extension azure-iot pour Azure CLI (version 2.46.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az iot du update . En savoir plus sur les extensions.

Gestion des mises à jour des mises à jour de l’appareil.

Commandes

Nom Description Type État
az iot du update calculate-hash

Calculez la représentation hachée base64 d’un fichier.

 Extension GA
az iot du update delete

Supprimez une version de mise à jour spécifique.

 Extension GA
az iot du update file

Mettre à jour les opérations de fichier.

 Extension GA
az iot du update file list

Répertoriez les ID de fichier de mise à jour par rapport à la mise à jour du fournisseur, du nom et de la version.

 Extension GA
az iot du update file show

Affichez les détails d’un fichier de mise à jour spécifique en ce qui concerne le fournisseur, le nom et la version de mise à jour.

 Extension GA
az iot du update import

Importez une nouvelle version de mise à jour dans l’instance Device Update.

 Extension GA
az iot du update init

Utilitaire pour l’initialisation du manifeste d’importation.

 Extension Aperçu
az iot du update init v5

Initialisez un manifeste d’importation v5 avec l’état souhaité.

 Extension Aperçu
az iot du update list

Répertoriez les mises à jour qui ont été importées dans l’instance Device Update.

 Extension GA
az iot du update show

Afficher une version de mise à jour spécifique.

 Extension GA
az iot du update stage

Mettez à jour une mise à jour pour l’importation vers une instance cible.

 Extension Aperçu

az iot du update calculate-hash

Calculez la représentation hachée base64 d’un fichier.

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

Exemples

Calculez la représentation en base64 d’un digest sha256 pour un fichier de mise à jour cible.

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

Calculez la représentation en base64 d’un digest sha256 pour plusieurs fichiers de mise à jour cible.

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

Paramètres obligatoires

--file-path -f

Chemin d’accès local au fichier cible pour le calcul de hachage. --file-path peut être utilisé 1 ou plusieurs fois.

Paramètres facultatifs

--hash-algo

Algorithme de chiffrement à utiliser pour le hachage.

Valeurs acceptées: sha256
Valeur par défaut: sha256
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot du update delete

Supprimez une version de mise à jour spécifique.

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

Exemples

Supprimez une mise à jour cible par rapport à la mise à jour du fournisseur, du nom et de la version.

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

Paramètres obligatoires

--account -n

Nom du compte Device Update. Vous pouvez configurer le nom du compte par défaut à l’aide az config set defaults.adu_account=<name>de .

--instance -i

Nom de l’instance Device Update. Vous pouvez configurer le nom d’instance par défaut à l’aide az config set defaults.adu_instance=<name>de .

--un --update-name

Nom de la mise à jour.

--up --update-provider

Fournisseur de mise à jour.

--update-version --uv

Version de mise à jour.

Paramètres facultatifs

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Valeur par défaut: False
--resource-group -g

Nom du groupe de ressources du compte Device Update. Vous pouvez configurer le groupe par défaut en utilisant az config set defaults.adu_group=<name>.

--yes -y

Ignorez les invites de l’utilisateur. Indique l’acceptation de l’action. Utilisé principalement pour les scénarios d’automatisation. Valeur par défaut : false.

Valeurs acceptées: false, true
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot du update import

Importez une nouvelle version de mise à jour dans l’instance Device Update.

Cette commande prend en charge la --defer fonctionnalité. Lorsqu’elle est utilisée, la commande stocke la charge utile de l’objet destinée à être envoyée à Azure dans un cache local. L’utilisation suivante de cette commande sans --defer combiner la nouvelle charge utile de requête avec les objets mis en cache les envoyant ensemble.

En cas de réussite, l’entrée de cache locale correspondante sera vidée. Si l’échec se produit, le contenu mis en cache ne sera pas supprimé. Utilisez az cache des commandes pour gérer les entrées de cache locales indépendamment.

La prise en charge différée est destinée principalement aux mises à jour avec plusieurs étapes de référence, de sorte que les mises à jour parent et enfant puissent être soumises ensemble.

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

Exemples

Importez une mise à jour avec deux fichiers associés et aucune étape de référence, fournissant explicitement la valeur de hachage de manifeste et la taille du manifeste en octets.

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}

Importez une mise à jour avec deux fichiers associés et aucune étape de référence, ce qui permet à l’interface CLI de calculer la valeur de hachage et la taille du manifeste d’importation en octets.

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}

Importez une mise à jour parente avec deux étapes de référence de mise à jour enfant, où les trois manifestes d’importation ont un fichier associé. Laissez l’interface CLI calculer la valeur de hachage et la taille en octets pour tous. Cette opération s’appuie sur la fonctionnalité « --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}

Paramètres obligatoires

--account -n

Nom du compte Device Update. Vous pouvez configurer le nom du compte par défaut à l’aide az config set defaults.adu_account=<name>de .

--instance -i

Nom de l’instance Device Update. Vous pouvez configurer le nom d’instance par défaut à l’aide az config set defaults.adu_instance=<name>de .

--url

Emplacement routable à partir duquel le manifeste d’importation peut être téléchargé par Device Update pour IoT Hub. Il s’agit généralement d’une URL d’objet blob protégée par SAP en lecture seule avec une expiration définie sur au moins 3 heures.

Paramètres facultatifs

--defer

Stocker temporairement l’objet dans le cache local au lieu de l’envoyer à Azure. Utilisez az cache des commandes pour afficher/effacer.

--file

Paires clé=valeur séparées par l’espace correspondant aux propriétés du fichier de métadonnées de manifeste. Les clés requises incluent le nom de fichier et l’URL. --file peut être utilisé 1 ou plusieurs fois.

--friendly-name

Nom convivial associé à la définition de mise à jour.

--hashes

Paires clé=valeur séparées par l’espace, où la clé est l’algorithme de hachage utilisé et la valeur est le hachage de fichier manifeste d’importation encodé en base64. Au moins une entrée sha256 est requise. Si elle n’est pas fournie, elle est calculée à partir de l’URL fournie.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Valeur par défaut: False
--resource-group -g

Nom du groupe de ressources du compte Device Update. Vous pouvez configurer le groupe par défaut en utilisant az config set defaults.adu_group=<name>.

--size

Taille du fichier, en nombre d’octets. Si elle n’est pas fournie, elle est calculée à partir de l’URL fournie.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot du update list

Répertoriez les mises à jour qui ont été importées dans l’instance Device Update.

Lorsque vous répertoriez les fournisseurs de mise à jour, seul l’indicateur --by-provider doit être fourni en plus des arguments de recherche d’instance courants. Lors de la liste des noms de mises à jour, le fournisseur de mise à jour doit être fourni. Lors de la liste des versions de mise à jour, le fournisseur de mises à jour et le nom de mise à jour doivent être fournis.

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

Exemples

Répertorier toutes les mises à jour.

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

Répertoriez toutes les mises à jour répondant à des critères de recherche en texte libre, dans ce cas le fournisseur de mise à jour de Contoso.

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

Répertoriez toutes les mises à jour répondant à un filtre odata, dans ce cas le filtrage pour les mises à jour non déployables.

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

Répertorier tous les fournisseurs de mise à jour.

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

Répertoriez tous les noms de mises à jour par fournisseur de mise à jour.

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

Répertoriez toutes les versions de mise à jour par fournisseur de mise à jour et nom de mise à jour.

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

Paramètres obligatoires

--account -n

Nom du compte Device Update. Vous pouvez configurer le nom du compte par défaut à l’aide az config set defaults.adu_account=<name>de .

--instance -i

Nom de l’instance Device Update. Vous pouvez configurer le nom d’instance par défaut à l’aide az config set defaults.adu_instance=<name>de .

Paramètres facultatifs

--by-provider

Indicateur indiquant que le jeu de résultats doit être limité aux fournisseurs de mise à jour.

Valeurs acceptées: false, true
--filter

Limite l’ensemble des mises à jour retournées par les valeurs de propriété. Prise en charge lors de la liste des mises à jour sans contraintes ou lors de la description par version.

--resource-group -g

Nom du groupe de ressources du compte Device Update. Vous pouvez configurer le groupe par défaut en utilisant az config set defaults.adu_group=<name>.

--search

Les mises à jour de la demande correspondent à une expression de recherche en texte libre. Prise en charge lors de la liste des mises à jour sans contraintes.

--un --update-name

Nom de la mise à jour.

--up --update-provider

Fournisseur de mise à jour.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot du update show

Afficher une version de mise à jour spécifique.

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

Exemples

Afficher une mise à jour spécifique par rapport à la mise à jour du fournisseur, du nom et de la version.

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

Paramètres obligatoires

--account -n

Nom du compte Device Update. Vous pouvez configurer le nom du compte par défaut à l’aide az config set defaults.adu_account=<name>de .

--instance -i

Nom de l’instance Device Update. Vous pouvez configurer le nom d’instance par défaut à l’aide az config set defaults.adu_instance=<name>de .

--un --update-name

Nom de la mise à jour.

--up --update-provider

Fournisseur de mise à jour.

--update-version --uv

Version de mise à jour.

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources du compte Device Update. Vous pouvez configurer le groupe par défaut en utilisant az config set defaults.adu_group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot du update stage

Préversion

Cette commande est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Mettez à jour une mise à jour pour l’importation vers une instance cible.

La mise en lots d’une mise à jour fait référence à l’accélération des étapes préalables d’importation d’une mise à jour vers une instance cible. Pour un manifeste d’importation donné, le processus détermine les fichiers pertinents, les envoie (push) vers un conteneur de stockage souhaité, génère des URI SAP et couvre d’autres étapes de préparation pour une importation réussie.

Cette commande dépend d’une organisation basée sur une convention de fichiers de mise à jour. Tous les fichiers de mise à jour d’un manifeste cible sont censés se trouver dans le même répertoire dans lequel réside le manifeste d’importation.

L’accès en fonction de la clé est utilisé pour charger des artefacts d’objet blob et générer des URI SAP de 3 heures avec accès en lecture.

Si --then-import l’indicateur est fourni, la commande importe la mise à jour intermédiaire. Sinon, le résultat de cette opération est une commande d’importation à exécuter pour obtenir le même résultat ultérieurement.

Cette commande vide et actualise toute entrée de cache locale pour l’instance cible.

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

Exemples

Mettez en place une mise à jour autonome. Les fichiers de mise à jour sont censés résider dans le même répertoire que le manifeste. La commande d’importation résultante peut être exécutée ultérieurement pour lancer l’importation de la mise à jour intermédiaire avant l’expiration du jeton SAP.

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

Mettez en place une mise à jour autonome. Après la mise en lots, importez la mise à jour vers l’instance à l’aide d’un nom convivial souhaité.

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

Mettez en place une mise à jour multi-référence. Les fichiers de mise à jour seront chargés dans un conteneur d’objets blob de stockage résidant dans un autre abonnement au compte de mise à jour.

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

Effectuez une mise à jour multi-référence, en remplaçant les objets blob existants s’ils existent. Après la mise en lots, importez la mise à jour vers l’instance.

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

Paramètres obligatoires

--account -n

Nom du compte Device Update. Vous pouvez configurer le nom du compte par défaut à l’aide az config set defaults.adu_account=<name>de .

--instance -i

Nom de l’instance Device Update. Vous pouvez configurer le nom d’instance par défaut à l’aide az config set defaults.adu_instance=<name>de .

--manifest-path

Chemin d’accès du fichier local au manifeste d’importation qui doit être intermédiaire. Peut être utilisé 1 ou plusieurs fois.

--storage-account

Nom du compte de stockage souhaité pour l’étape de l’importation des artefacts de manifeste.

--storage-container

Nom du conteneur de stockage souhaité pour l’étape de l’importation des artefacts de manifeste.

Paramètres facultatifs

--friendly-name

Nom convivial associé à la définition de mise à jour.

--overwrite

Indicateur indiquant si des objets blob existants doivent être remplacés s’il existe un conflit.

Valeurs acceptées: false, true
Valeur par défaut: False
--resource-group -g

Nom du groupe de ressources du compte Device Update. Vous pouvez configurer le groupe par défaut en utilisant az config set defaults.adu_group=<name>.

--storage-subscription

Abonnement de compte de stockage souhaité pour l’étape de l’importation des artefacts de manifeste. Applicable lorsque les comptes de stockage et de mise à jour d’appareil se trouvent dans différents abonnements.

--then-import

Indicateur indiquant si la mise à jour doit être importée après la mise en lots.

Valeurs acceptées: false, true
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.