Partager via

az iot du update init

  • Préversion
  • 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 init . En savoir plus sur les extensions.

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

Utilitaire pour l’initialisation du manifeste d’importation.

Commandes

Nom Description Type Statut
az iot du update init v5

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

 Extension Aperçu

az iot du update init v5

Préversion

Le groupe de commandes « iot du update init » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

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

Cette commande prend en charge tous les attributs du manifeste d’importation v5. Notez qu’il existe une sensibilité positionnelle entre --step et --file, ainsi que --file et --related-file. Passez en revue des exemples et des descriptions de paramètres pour plus d’informations sur l’utilisation complète de l’opération.

En savoir plus sur l’utilisation de guillemets et de caractères d’échappement dans différents interpréteurs de commandes ici : https://aka.ms/aziotcli-json.

az iot du update init v5 --compat
                         --step
                         --update-name
                         --update-provider
                         --update-version
                         [--description]
                         [--file]
                         [--is-deployable {false, true}]
                         [--no-validation {false, true}]
                         [--related-file]

Exemples

Initialisez un manifeste d’importation à contenu minimal. Json inline optimisé pour « bash ».

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{"installedCriteria": "1.0"}' --file path=/my/apt/manifest/file

Initialisez un manifeste d’importation à contenu minimal. Json inline optimisé pour « powershell ».

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{\"installedCriteria\": \"1.0\"}' --file path=/my/apt/manifest/file

Initialisez un manifeste d’importation à contenu minimal. Json inline optimisé pour « cmd ».

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="{\"installedCriteria\": \"1.0\"}" --file path=/my/apt/manifest/file

Initialisez un manifeste d’importation à contenu minimal. Utilisez l’entrée de fichier pour json.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="@/path/to/file" --file path=/my/apt/manifest/file

Initialisez une mise à jour feuille non déployable à référencer dans une mise à jour groupée. Json inline optimisé pour « bash ».

az iot du update init v5 --update-provider Microsoft --update-name mySwUpdate --update-version 1.1.0 --compat manufacturer=Contoso model=Microphone --step handler=microsoft/swupdate:1 description="Deploy Update" properties='{"installedCriteria": "1.0"}' --file path=/my/update/image/file1 --file path=/my/update/image/file2 --is-deployable false

Initialisez une mise à jour groupée référençant une mise à jour feuille, ainsi que la définition d’étapes indépendantes. Exemple optimisé pour « bash » à l’aide de la continuation de commande pour délimiter les segments de manifeste d’importation.

az iot du update init v5 \
--update-provider Microsoft --update-name myBundled --update-version 2.0 \
--compat manufacturer=Contoso model=SpaceStation \
--step handler=microsoft/script:1 properties='{"arguments": "--pre"}' description="Pre-install script" \
--file path=/my/update/scripts/preinstall.sh downloadHandler=microsoft/delta:1 \
--related-file path=/my/update/scripts/related_preinstall.json properties='{"microsoft.sourceFileHashAlgorithm": "sha256"}' \
--step updateId.provider=Microsoft updateId.name=SwUpdate updateId.version=1.1 \
--step handler=microsoft/script:1 properties='{"arguments": "--post"}' description="Post-install script" \
--file path=/my/update/scripts/postinstall.sh

Paramètres obligatoires

--compat

Paires clé=valeur séparées par l’espace correspondant aux propriétés d’un appareil avec lequel cette mise à jour est compatible. Généralement utilisé pour définir des propriétés telles que le fabricant et le modèle. --compat peut être utilisé 1 ou plusieurs fois.

--step

Paires clé=valeur séparées par espace correspondant aux propriétés d’élément « instructions.steps ». Le client détermine si une étape est une étape inline ou une étape de référence basée sur les paires clé-valeur fournies. Si l’étape inline ou référence peut être satisfaite, l’étape de référence est hiérarchisée. L’utilisation de --file est associée à l’entrée inline la plus proche ,-step, dérivant la valeur pour « files ». Les clés d’étape de référence suivantes sont prises en charge : updateId.provider, updateId.nameupdateId.version et description. Les clés d’étape inline suivantes sont prises en charge : handler (par exemple , « microsoft/script :1 » ou « microsoft/swupdate :1 » ou « microsoft/apt :1 »), properties (objet json en ligne que l’agent passe au gestionnaire) et description. --l’étape peut être utilisée 1 ou plusieurs fois.

--update-name

Nom de mise à jour en tant que composant de updateId.

--update-provider

Fournisseur de mise à jour en tant que composant de updateId.

--update-version

Version de mise à jour en tant que composant de updateId.

Paramètres facultatifs

--description

Description du manifeste d’importation.

--file

Paires clé=valeur séparées par espace correspondant aux propriétés d’élément « files ». Une entrée --file peut inclure les entrées de fichier --related-file les plus proches si elles sont fournies. Les clés suivantes sont prises en charge : path [obligatoire] chemin d’accès de fichier local pour mettre à jour le fichier, downloadHandler (par exemple, « microsoft/delta :1 ») pour utiliser les fichiers associés pour télécharger le fichier de charge utile, properties (objet json en ligne que l’agent transmet au gestionnaire). --file peut être utilisé 1 ou plusieurs fois.

--is-deployable

Indique si la mise à jour est déployable indépendamment.

valeurs acceptées: false, true
--no-validation

Désactive la validation de schéma json côté client du contenu du manifeste d’importation.

valeurs acceptées: false, true
--related-file

Paires clé=valeur séparées par espace correspondant aux propriétés d’élément 'files[*].relatedFiles'. Une entrée --related-file est associée à l’entrée --file la plus proche si elle existe. Les clés suivantes sont prises en charge : path [obligatoire] chemin d’accès au fichier de mise à jour associé, properties (objet json en ligne transmis au gestionnaire de téléchargement). --related-file peut être utilisé 1 ou plusieurs fois.

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.