az iot ops

Remarque

Cette référence fait partie de l’extension azure-iot-ops pour Azure CLI (version 2.53.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az iot ops . 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

Gérer les opérations Azure IoT.

Azure IoT Operations est un ensemble de services Kubernetes hautement alignés, mais faiblement couplés, qui vous permettent d’agréger des données à partir de ressources locales dans un répartiteur MQTT de niveau industriel, d’ajouter un calcul de périphérie et de configurer un flux de données bidirectionnel avec un large éventail de services dans le cloud.

Par défaut, les commandes CLI IoT Operations vérifient régulièrement si une nouvelle version d’extension est disponible. Ce comportement peut être désactivé avec az config set iotops.check_latest=false.

Commandes

Nom Description Type État
az iot ops asset

Gérer les ressources.

Extension Aperçu
az iot ops asset create

Créez un élément multimédia.

Extension Aperçu
az iot ops asset data-point

Gérer les points de données dans une ressource.

Extension Aperçu
az iot ops asset data-point add

Ajoutez un point de données à une ressource.

Extension Aperçu
az iot ops asset data-point export

Exportez des points de données dans une ressource.

Extension Aperçu
az iot ops asset data-point import

Importez des points de données dans une ressource.

Extension Aperçu
az iot ops asset data-point list

Répertorier les points de données d’une ressource.

Extension Aperçu
az iot ops asset data-point remove

Supprimez un point de données dans une ressource.

Extension Aperçu
az iot ops asset delete

Supprimez une ressource.

Extension Aperçu
az iot ops asset endpoint

Gérer les profils de point de terminaison de ressource.

Extension Aperçu
az iot ops asset endpoint certificate

Gérer les certificats détenus dans un point de terminaison de ressource.

Extension Aperçu
az iot ops asset endpoint certificate add

Ajoutez un certificat appartenant à un point de terminaison de ressource.

Extension Aperçu
az iot ops asset endpoint certificate list

Répertoriez les certificats détenus dans un point de terminaison de ressource.

Extension Aperçu
az iot ops asset endpoint certificate remove

Supprimez un certificat appartenant à un point de terminaison de ressource.

Extension Aperçu
az iot ops asset endpoint create

Créez un point de terminaison de ressource.

Extension Aperçu
az iot ops asset endpoint delete

Supprimez un point de terminaison de ressource.

Extension Aperçu
az iot ops asset endpoint query

Interrogez Resource Graph pour les points de terminaison de ressources.

Extension Aperçu
az iot ops asset endpoint show

Afficher un point de terminaison de ressource.

Extension Aperçu
az iot ops asset endpoint update

Mettez à jour un point de terminaison de ressource.

Extension Aperçu
az iot ops asset event

Gérer les événements dans une ressource.

Extension Aperçu
az iot ops asset event add

Ajoutez un événement à une ressource.

Extension Aperçu
az iot ops asset event export

Exporter des événements dans une ressource.

Extension Aperçu
az iot ops asset event import

Importer des événements dans une ressource.

Extension Aperçu
az iot ops asset event list

Répertorier les événements d’une ressource.

Extension Aperçu
az iot ops asset event remove

Supprimez un événement dans une ressource.

Extension Aperçu
az iot ops asset query

Interrogez Resource Graph pour les ressources.

Extension Aperçu
az iot ops asset show

Afficher une ressource.

Extension Aperçu
az iot ops asset update

Mettez à jour une ressource.

Extension Aperçu
az iot ops broker

Gestion et opérations du répartiteur Mqtt.

Extension Aperçu
az iot ops broker authn

Gestion de l’authentification broker.

Extension Aperçu
az iot ops broker authn list

Répertoriez les ressources d’authentification du répartiteur mqtt associées à une instance.

Extension Aperçu
az iot ops broker authn show

Afficher les détails d’une ressource d’authentification du répartiteur mqtt.

Extension Aperçu
az iot ops broker authz

Gestion des autorisations du répartiteur.

Extension Aperçu
az iot ops broker authz list

Répertorier les ressources d’autorisation du répartiteur mqtt associées à une instance.

Extension Aperçu
az iot ops broker authz show

Afficher les détails d’une ressource d’autorisation du répartiteur mqtt.

Extension Aperçu
az iot ops broker list

Répertorier les répartiteurs mqtt associés à une instance.

Extension Aperçu
az iot ops broker listener

Gestion de l’écouteur broker.

Extension Aperçu
az iot ops broker listener list

Répertorier les écouteurs du répartiteur mqtt associés à un répartiteur.

Extension Aperçu
az iot ops broker listener show

Afficher les détails d’un écouteur de répartiteur mqtt.

Extension Aperçu
az iot ops broker show

Afficher les détails d’un répartiteur mqtt.

Extension Aperçu
az iot ops broker stats

Afficher les statistiques dmqtt en cours d’exécution.

Extension Aperçu
az iot ops check

Évaluez l’intégrité du runtime côté cluster des services IoT Operations déployés.

Extension Aperçu
az iot ops dataflow

Gestion des flux de données.

Extension Aperçu
az iot ops dataflow endpoint

Gestion des points de terminaison de flux de données.

Extension Aperçu
az iot ops dataflow endpoint list

Répertorier les ressources de point de terminaison de flux de données associées à une instance.

Extension Aperçu
az iot ops dataflow endpoint show

Afficher les détails d’une ressource de point de terminaison de flux de données.

Extension Aperçu
az iot ops dataflow list

Répertorier les dataflows associés à un profil de flux de données.

Extension Aperçu
az iot ops dataflow profile

Gestion des profils de flux de données.

Extension Aperçu
az iot ops dataflow profile list

Répertorier les profils de flux de données associés à une instance.

Extension Aperçu
az iot ops dataflow profile show

Afficher les détails d’un profil de flux de données.

Extension Aperçu
az iot ops dataflow show

Afficher les détails d’un dataflow associé à un profil de flux de données.

Extension Aperçu
az iot ops delete

Supprimez les opérations IoT du cluster.

Extension Aperçu
az iot ops init

Démarrez, configurez et déployez des opérations IoT sur le cluster cible avec Arc.

Extension Aperçu
az iot ops list

Répertorier les instances d’opérations IoT.

Extension Aperçu
az iot ops show

Afficher une instance d’opérations IoT.

Extension Aperçu
az iot ops support

Les opérations IoT prennent en charge l’espace de commande.

Extension Aperçu
az iot ops support create-bundle

Crée une archive zip de prise en charge standard pour une utilisation dans la résolution des problèmes et les diagnostics.

Extension Aperçu
az iot ops update

Mettez à jour une instance d’opérations IoT.

Extension Aperçu
az iot ops verify-host

Exécute un ensemble de vérifications de l’hôte de cluster pour la compatibilité du déploiement d’IoT Operations.

Extension Aperçu

az iot ops check

Préversion

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

Évaluez l’intégrité du runtime côté cluster des services IoT Operations déployés.

La commande affiche par défaut une vue récapitulative conviviale du service sélectionné. Plus de détails peuvent être demandés via --detail-level.

{API de service prises en charge}

  • akri.sh/[v0]
  • deviceregistry.microsoft.com/[v1beta1]
  • mqttbroker.iotoperations.azure.com/[v1beta1]
  • opcuabroker.iotoperations.azure.com/[v1beta1]

Pour plus d’informations sur les exigences en matière de cluster, consultez https://aka.ms/iot-ops-cluster-requirements.

az iot ops check [--as-object {false, true}]
                 [--context]
                 [--detail-level {0, 1, 2}]
                 [--ops-service {akri, broker, deviceregistry, opcua}]
                 [--post {false, true}]
                 [--pre {false, true}]
                 [--resource-name]
                 [--resources {asset, assetendpointprofile, assettype, broker, brokerlistener, configuration, instance}]

Exemples

Utilisation de base. Vérifie l’intégrité du « répartiteur » avec une sortie récapitulative.

az iot ops check

Évalue « broker » comme exemple précédent, mais la sortie est optimisée pour CI.

az iot ops check --as-object

Vérifie l’intégrité et la configuration d’opcua avec une sortie détaillée.

az iot ops check --svc opcua --detail-level 1

Vérifie l’intégrité de « deviceregistry », mais limite les résultats aux ressources « asset ».

az iot ops check --svc deviceregistry --detail-level 1 --resources asset

Utilisez le nom de ressource pour limiter les résultats aux ressources « asset » avec le préfixe de nom « my-asset- »

az iot ops check --svc deviceregistry --resources asset --resource-name 'my-asset-*'

Paramètres facultatifs

--as-object

Vérifiez le contenu et les validations de sortie dans une structure de données conviviale CI.

Valeurs acceptées: false, true
--context

Nom de contexte Kubeconfig à utiliser pour la communication de cluster k8s. Si aucun contexte n’est fourni current_context est utilisé.

--detail-level

Contrôle le niveau de détail affiché dans la sortie de vérification. Choisissez 0 pour une vue récapitulative (sortie minimale), 1 pour une vue détaillée (informations plus complètes) ou 2 pour une vue détaillée (toutes les informations disponibles).

Valeurs acceptées: 0, 1, 2
Valeur par défaut: 0
--ops-service --svc

Déploiement du service IoT Operations qui sera évalué.

Valeurs acceptées: akri, broker, deviceregistry, opcua
Valeur par défaut: broker
--post

Exécutez des vérifications post-déploiement.

Valeurs acceptées: false, true
--pre

Exécutez des vérifications préalables pour déterminer si les exigences minimales d’un déploiement de service sont remplies.

Valeurs acceptées: false, true
--resource-name --rn

Exécutez uniquement des vérifications pour le nom de ressource spécifique. Le nom ne respecte pas la casse. Les modèles Glob '' et ' ?' sont pris en charge. Remarque : Seuls les caractères alphanumériques, les traits d’union, « ? » et « » sont autorisés.

--resources

Exécutez uniquement des vérifications sur des types de ressources spécifiques. Utilisez des valeurs séparées par des espaces.

Valeurs acceptées: asset, assetendpointprofile, assettype, broker, brokerlistener, configuration, instance
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 ops delete

Préversion

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

Supprimez les opérations IoT du cluster.

L’opération utilise Azure Resource Graph pour déterminer les ressources corrélées. Resource Graph étant finalement cohérent ne garantit pas un état synchronisé au moment de l’exécution.

az iot ops delete --cluster
                  --resource-group
                  [--force {false, true}]
                  [--no-progress {false, true}]
                  [--yes {false, true}]

Exemples

Entrée minimale pour la suppression complète.

az iot ops delete --cluster mycluster -g myresourcegroup

Ignorez l’invite de confirmation et passez au processus de suppression. Utile pour les scénarios CI.

az iot ops delete --cluster mycluster -g myresourcegroup -y

Forcer la suppression indépendamment des avertissements. Peut entraîner des erreurs.

az iot ops delete --cluster mycluster -g myresourcegroup --force

Paramètres obligatoires

--cluster

Nom du cluster cible pour la suppression des opérations IoT.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--force

Forcer l’exécution de l’opération.

Valeurs acceptées: false, true
--no-progress

Désactivez la représentation visuelle du travail.

Valeurs acceptées: false, true
--yes -y

Confirmez [y]es sans invite. Utile pour les scénarios CI et Automation.

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 ops init

Préversion

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

Démarrez, configurez et déployez des opérations IoT sur le cluster cible avec Arc.

Pour obtenir des ressources supplémentaires, notamment la façon d’activer un cluster Arc, consultez https://video2.skills-academy.com/en-us/azure/iot-operations/deploy-iot-ops/howto-prepare-cluster

Les opérations IoT dépendent d’un principal de service (SP) pour la synchronisation des secrets du pilote CSI Key Vault.

Par défaut, init fonctionne dans la création et la configuration d’une inscription d’application appropriée via Microsoft Graph, puis l’applique au cluster.

Vous pouvez court-circuiter ce travail en précréant une inscription d’application, puis en fournissant des valeurs pour --sp-app-id, --sp-object-id et --sp-secret. En fournissant les champs du fournisseur de services, aucun travail supplémentaire n’est effectué via les opérations Microsoft Graph.

La création préalable d’une inscription d’application est utile lorsque le principal connecté a des autorisations Entra Id limitées. Par exemple, dans les scénarios CI/Automation, ou dans une organisation, la séparation de la responsabilité des utilisateurs.

az iot ops init --cluster
                --resource-group
                [--add-insecure-listener {false, true}]
                [--bfr]
                [--bfw]
                [--broker]
                [--broker-authn]
                [--broker-backend-part]
                [--broker-backend-rf]
                [--broker-backend-workers]
                [--broker-config-file]
                [--broker-listener]
                [--broker-mem-profile {High, Low, Medium, Tiny}]
                [--broker-service-type {ClusterIp, LoadBalancer, NodePort}]
                [--ca-dir]
                [--ca-file]
                [--ca-key-file]
                [--ca-valid-days]
                [--cluster-namespace]
                [--context]
                [--csi-config]
                [--csi-ver]
                [--custom-location]
                [--desc]
                [--df-profile-instances]
                [--disable-rotation {false, true}]
                [--disable-rsync-rules {false, true}]
                [--ensure-latest {false, true}]
                [--kubernetes-distro {k3s, k8s, microk8s}]
                [--kv-id]
                [--kv-spc-secret-name]
                [--location]
                [--name]
                [--no-block {false, true}]
                [--no-deploy {false, true}]
                [--no-progress {false, true}]
                [--no-tls {false, true}]
                [--rotation-int]
                [--runtime-socket]
                [--show-template {false, true}]
                [--simulate-plc {false, true}]
                [--sp-app-id]
                [--sp-object-id]
                [--sp-secret]
                [--sp-secret-valid-days]

Exemples

Entrée minimale pour la configuration complète. Cela inclut la configuration key Vault, le déploiement du pilote CSI, la configuration TLS et le déploiement des opérations IoT.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id /subscriptions/2cb3a427-1abc-48d0-9d03-dd240819742a/resourceGroups/myresourcegroup/providers/Microsoft.KeyVault/vaults/mykeyvault

Même configuration que l’exemple précédent, à l’exception de l’utilisation d’un ID d’application existant et d’un indicateur pour inclure un serveur PLC simulé dans le cadre du déploiement. L’inclusion de l’ID d’application empêche l’init de créer une inscription d’application.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --simulate-plc

Pour ignorer le déploiement et vous concentrer uniquement sur le pilote CSI Key Vault et les flux de travail de configuration TLS, passez simplement --no-deploy. Cela peut être utile lorsque vous souhaitez déployer à partir d’un autre outil tel que Portail.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --no-deploy

Pour déployer uniquement des opérations IoT sur un cluster qui a déjà été prédéfini, omettez simplement --kv-id et incluez --no-tls.

az iot ops init --cluster mycluster -g myresourcegroup --no-tls

Utilisez --no-block pour effectuer d’autres tâches pendant que le déploiement est en cours et attend que le déploiement se termine avant de démarrer l’autre travail.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --no-block

Cet exemple montre comment fournir des valeurs pour --sp-app-id, --sp-object-id et --sp-secret. Ces valeurs doivent refléter le principal de service souhaité qui sera utilisé pour la synchronisation des secrets du pilote CSI Key Vault. Pour plus d’informations, consultez le résumé de la commande.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --sp-object-id 224a7a3f-c63d-4923-8950-c4a85f0d2f29 --sp-secret $SP_SECRET

Pour personnaliser la configuration du runtime du pilote CSI Key Vault, --csi-config peut être utilisé. Par exemple, définir des limites de ressources sur la dépendance de conteneur telegraf.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --csi-config telegraf.resources.limits.memory=500Mi telegraf.resources.limits.cpu=100m

Paramètres obligatoires

--cluster

Nom du cluster cible pour le déploiement d’Opérations IoT.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--add-insecure-listener

Lorsque le déploiement du répartiteur mqtt est activé, il inclut un écouteur lié au port 1883 sans authentification ni authZ.Pour les charges de travail hors production uniquement.

Valeurs acceptées: false, true
--bfr --broker-frontend-replicas

Réplicas frontaux du répartiteur Mqtt.

Valeur par défaut: 2
--bfw --broker-frontend-workers

Travailleurs frontaux du répartiteur Mqtt.

Valeur par défaut: 2
--broker

Nom du répartiteur mqtt.

Valeur par défaut: broker
--broker-authn

Nom de l’authentification du répartiteur mqtt.

Valeur par défaut: authn
--broker-backend-part

Partitions principales du répartiteur Mqtt.

Valeur par défaut: 2
--broker-backend-rf

Facteur de redondance du serveur principal du répartiteur Mqtt.

Valeur par défaut: 2
--broker-backend-workers

Travailleurs principaux du répartiteur Mqtt.

Valeur par défaut: 2
--broker-config-file

Chemin d’accès à un fichier json avec des propriétés de configuration de répartiteur personnalisées. Utile pour les scénarios avancés. Le format attendu est décrit à https://aka.ms/aziotops-broker-config.

--broker-listener

Nom de l’écouteur du répartiteur mqtt.

Valeur par défaut: listener
--broker-mem-profile

Profil mémoire du répartiteur Mqtt.

Valeurs acceptées: High, Low, Medium, Tiny
Valeur par défaut: Medium
--broker-service-type

Type de service Broker Mqtt.

Valeurs acceptées: ClusterIp, LoadBalancer, NodePort
Valeur par défaut: ClusterIp
--ca-dir

Le répertoire local dans lequel l’autorité de certification de test générée et la clé privée sont placées. Si aucun répertoire n’est fourni, aucun fichier n’est écrit sur le disque. Applicable quand aucun fichier --ca-file et --ca-key-file sont fournis.

--ca-file

Chemin d’accès au fichier d’autorité de certification souhaité au format PEM.

--ca-key-file

Chemin d’accès au fichier de clé privée de l’autorité de certification au format PEM. ! Obligatoire! quand --ca-file est fourni.

--ca-valid-days

Option permettant de contrôler la durée en jours de l’autorité de certification x509 générée par l’init. Applicable si --ca-file et --ca-key-file ne sont pas fournis.

Valeur par défaut: 365
--cluster-namespace

L’infrastructure IoT Operations de l’espace de noms du cluster sera déployée. Il doit être en minuscules.

Valeur par défaut: azure-iot-operations
--context

Nom de contexte Kubeconfig à utiliser pour la communication de cluster k8s. Si aucun contexte n’est fourni current_context est utilisé.

--csi-config

Configuration personnalisée de l’extension de pilote CSI. Le format est des paires clé=valeur séparées par un espace. --csi-config peut être utilisé une ou plusieurs fois.

--csi-ver

Version de l’extension du pilote CSI.

Valeur par défaut: 1.5.6
--custom-location

Nom d’emplacement personnalisé correspondant au déploiement des opérations IoT. La valeur par défaut est « {cluster_name}-{token}-ops-init-cl ».

--desc

Description de l’instance IoT Operations.

--df-profile-instances

Nombre d’instances associé au profil de flux de données par défaut.

Valeur par défaut: 1
--disable-rotation

Indicateur pour désactiver la rotation des secrets.

Valeurs acceptées: false, true
--disable-rsync-rules

Les règles de synchronisation des ressources ne seront pas incluses dans le déploiement des opérations IoT.

Valeurs acceptées: false, true
--ensure-latest

Vérifiez que la dernière interface CLI IoT Ops est utilisée, ce qui génère une erreur si une mise à niveau est disponible.

Valeurs acceptées: false, true
--kubernetes-distro

Distribution Kubernetes à utiliser pour la configuration Akri. La distribution sélectionnée implique le chemin du socket d’exécution du conteneur par défaut quand aucune valeur --runtime-socket n’est fournie.

Valeurs acceptées: k3s, k8s, microk8s
Valeur par défaut: k8s
--kv-id

ID de ressource ARM Key Vault. La fourniture de cet ID de ressource permet au client de configurer toutes les ressources nécessaires et la configuration côté cluster pour activer le pilote CSI Key Vault pour les opérations IoT.

--kv-spc-secret-name

Nom du secret Key Vault à utiliser comme secret SPC par défaut. Si le secret n’existe pas, il est créé avec une valeur d’espace réservé sécurisée par chiffrement.

Valeur par défaut: azure-iot-operations
--location

Emplacement ARM qui sera utilisé pour les garanties RPSaaS approvisionnées. Si l’emplacement du cluster connecté n’est pas fourni, il est utilisé.

--name -n

Nom de l’instance Des opérations IoT. La valeur par défaut est « {cluster_name}-ops-instance ».

--no-block

Retournez immédiatement après le démarrage du déploiement des opérations IoT.

Valeurs acceptées: false, true
--no-deploy

Le flux de travail de déploiement Des opérations IoT est ignoré.

Valeurs acceptées: false, true
--no-progress

Désactivez la représentation visuelle du travail.

Valeurs acceptées: false, true
--no-tls

Le flux de travail de configuration TLS est ignoré.

Valeurs acceptées: false, true
--rotation-int

Intervalle de sondage de rotation.

Valeur par défaut: 1h
--runtime-socket

Chemin du nœud par défaut du socket d’exécution du conteneur. S’il n’est pas fourni (valeur par défaut), le chemin du socket est déterminé par --kubernetes-distro.

--show-template

Indicateur lorsqu’il est défini, génère le modèle destiné au déploiement.

Valeurs acceptées: false, true
--simulate-plc

Indicateur quand il est défini, configure le programme d’installation du répartiteur OPC-UA pour faire tourner un serveur PLC.

Valeurs acceptées: false, true
--sp-app-id

ID d’application du principal de service. Si fourni sera utilisé pour la configuration du pilote CSI. Sinon, une inscription d’application est créée. Obligatoire si le principal connecté n’a pas les autorisations nécessaires pour interroger le graphe.

--sp-object-id

ID d’objet principal de service (sp). Si fourni sera utilisé pour la configuration du pilote CSI. Sinon, l’ID d’objet est interrogé à partir de l’ID d’application : création du sp s’il n’existe pas. Obligatoire si le principal connecté n’a pas les autorisations nécessaires pour interroger le graphe. Permet az ad sp show --id <app Id> --query id -o tsv de produire l’ID d’objet approprié. Vous pouvez également utiliser le portail pour accéder aux applications d’entreprise dans votre locataire Entra Id.

--sp-secret

Secret correspondant à l’ID d’application du principal de service fourni. Si fourni sera utilisé pour la configuration du pilote CSI. Sinon, un nouveau secret sera créé. Obligatoire si le principal connecté n’a pas les autorisations nécessaires pour interroger le graphe.

--sp-secret-valid-days

Option permettant de contrôler la durée en jours du secret du principal de service généré par l’init. Applicable si --sp-secret n’est pas fourni.

Valeur par défaut: 365
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 ops list

Préversion

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

Répertorier les instances d’opérations IoT.

Utilisez --query avec la syntaxe JMESPath souhaitée pour interroger le résultat.

az iot ops list [--resource-group]

Exemples

Répertoriez toutes les instances de l’abonnement.

az iot ops list

Répertorier toutes les instances d’un groupe de ressources particulier.

az iot ops list -g myresourcegroup

Répertoriez les instances de l’abonnement qui ont une valeur d’étiquette particulière.

az iot ops list -g myresourcegroup --query "[?tags.env == 'prod']"

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults 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 ops show

Préversion

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

Afficher une instance d’opérations IoT.

Si vous le souhaitez, la commande peut générer une arborescence des ressources associées représentant le déploiement des opérations IoT sur le cluster de stockage.

az iot ops show --name
                --resource-group
                [--tree {false, true}]

Exemples

Utilisation de base pour afficher une instance.

az iot ops show --name myinstance -g myresourcegroup

Sortie d’une arborescence de ressources associées représentant le déploiement des opérations IoT.

az iot ops show --name myinstance -g myresourcegroup --tree

Paramètres obligatoires

--name -n

Nom de l’instance Des opérations IoT.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--tree

Permet de visualiser le déploiement des opérations IoT sur le cluster de stockage.

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

Préversion

Le groupe de commandes « iot ops » 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 instance d’opérations IoT.

Actuellement, les balises d’instance et la description peuvent être mises à jour.

az iot ops update --name
                  --resource-group
                  [--desc]
                  [--tags]

Exemples

Mettez à jour les balises d’instance. Cela équivaut à un remplacement.

az iot ops update --name myinstance -g myresourcegroup --tags a=b c=d

Supprimez les balises d’instance.

az iot ops update --name myinstance -g myresourcegroup --tags ""

Mettez à jour la description de l’instance.

az iot ops update --name myinstance -g myresourcegroup --desc "Fabrikam Widget Factory B42"

Paramètres obligatoires

--name -n

Nom de l’instance Des opérations IoT.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--desc

Description de l’instance IoT Operations.

--tags

Balises d’instance. Conteneur de propriétés dans des paires clé-valeur au format suivant : a=b c=d.

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 ops verify-host

Préversion

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

Exécute un ensemble de vérifications de l’hôte de cluster pour la compatibilité du déploiement d’IoT Operations.

Destiné à être exécuté directement sur un hôte de cluster cible. La commande peut inviter à appliquer un ensemble d’actions privilégiées telles que l’installation d’une dépendance. Dans ce cas, l’interface CLI doit être exécutée avec des autorisations élevées. Par exemple, sudo AZURE_EXTENSION_DIR=~/.azure/cliextensions az iot ops verify-host.

az iot ops verify-host [--no-progress {false, true}]

Paramètres facultatifs

--no-progress

Désactivez la représentation visuelle du travail.

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.