Partager via


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 . Apprenez-en davantage sur les extensions.

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

Gestion des ressources.

Extension GA
az iot ops asset create

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

Extension GA
az iot ops asset dataset

Gérez les jeux de données dans une ressource.

Extension GA
az iot ops asset dataset list

Répertorier les jeux de données au sein d’une ressource.

Extension GA
az iot ops asset dataset point

Gérez les points de données dans un jeu de données d’éléments multimédias.

Extension GA
az iot ops asset dataset point add

Ajoutez un point de données à un jeu de données de ressources.

Extension GA
az iot ops asset dataset point export

Exportez des points de données dans un jeu de données de ressources.

Extension GA
az iot ops asset dataset point import

Importez des points de données dans un jeu de données de ressources.

Extension GA
az iot ops asset dataset point list

Répertorier les points de données dans un jeu de données d’éléments multimédias.

Extension GA
az iot ops asset dataset point remove

Supprimez un point de données dans un jeu de données de ressources.

Extension GA
az iot ops asset dataset show

Afficher un jeu de données au sein d’une ressource.

Extension GA
az iot ops asset delete

Supprimez une ressource.

Extension GA
az iot ops asset endpoint

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

Extension GA
az iot ops asset endpoint create

Créez des profils de point de terminaison de ressource.

Extension GA
az iot ops asset endpoint create opcua

Créez un profil de point de terminaison de ressource avec un connecteur OPCUA.

Extension GA
az iot ops asset endpoint delete

Supprimez un profil de point de terminaison de ressource.

Extension GA
az iot ops asset endpoint query

Interrogez Resource Graph pour obtenir des profils de point de terminaison de ressource.

Extension GA
az iot ops asset endpoint show

Afficher un profil de point de terminaison de ressource.

Extension GA
az iot ops asset endpoint update

Mettez à jour un profil de point de terminaison de ressource.

Extension GA
az iot ops asset event

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

Extension GA
az iot ops asset event add

Ajoutez un événement à une ressource.

Extension GA
az iot ops asset event export

Exporter des événements dans une ressource.

Extension GA
az iot ops asset event import

Importer des événements dans une ressource.

Extension GA
az iot ops asset event list

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

Extension GA
az iot ops asset event remove

Supprimez un événement dans une ressource.

Extension GA
az iot ops asset query

Interrogez Resource Graph pour les ressources.

Extension GA
az iot ops asset show

Afficher une ressource.

Extension GA
az iot ops asset update

Mettez à jour une ressource.

Extension GA
az iot ops broker

Gestion du répartiteur Mqtt.

Extension GA
az iot ops broker authn

Gestion de l’authentification broker.

Extension GA
az iot ops broker authn delete

Supprimez une ressource d’authentification du répartiteur mqtt.

Extension GA
az iot ops broker authn list

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

Extension GA
az iot ops broker authn show

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

Extension GA
az iot ops broker authz

Gestion des autorisations du répartiteur.

Extension GA
az iot ops broker authz delete

Supprimez une ressource d’autorisation du répartiteur mqtt.

Extension GA
az iot ops broker authz list

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

Extension GA
az iot ops broker authz show

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

Extension GA
az iot ops broker delete

Supprimez un répartiteur mqtt.

Extension GA
az iot ops broker list

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

Extension GA
az iot ops broker listener

Gestion de l’écouteur broker.

Extension GA
az iot ops broker listener delete

Supprimez un écouteur de répartiteur mqtt.

Extension GA
az iot ops broker listener list

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

Extension GA
az iot ops broker listener show

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

Extension GA
az iot ops broker show

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

Extension GA
az iot ops check

Évaluez la préparation côté cluster et l’intégrité du runtime des services d’opérations IoT déployés.

Extension Aperçu
az iot ops connector

Gestion des connecteurs.

Extension Aperçu
az iot ops connector opcua

Gestion des connecteurs OPC UA.

Extension Aperçu
az iot ops connector opcua client

Gérer le certificat d’instance d’application cliente de niveau entreprise pour opc UA Broker.

Extension Aperçu
az iot ops connector opcua client add

Ajoutez un certificat d’instance d’application cliente de niveau entreprise.

Extension Aperçu
az iot ops connector opcua client remove

Supprimez le certificat d’instance d’application cliente du répartiteur OPC UA.

Extension Aperçu
az iot ops connector opcua client show

Affichez les détails de la ressource secretsync « aio-opc-ua-broker-client-certificate ».

Extension Aperçu
az iot ops connector opcua issuer

Gérer les certificats d’émetteur pour opc UA Broker.

Extension Aperçu
az iot ops connector opcua issuer add

Ajoutez un certificat d’émetteur à la liste des certificats d’émetteur d’OPC UA Broker.

Extension Aperçu
az iot ops connector opcua issuer remove

Supprimez le ou les certificats approuvés de la liste des certificats émetteur d’OPC UA Broker.

Extension Aperçu
az iot ops connector opcua issuer show

Affichez les détails de la ressource secretsync « aio-opc-ua-broker-issuer-list ».

Extension Aperçu
az iot ops connector opcua trust

Gérer les certificats approuvés pour le répartiteur OPC UA.

Extension Aperçu
az iot ops connector opcua trust add

Ajoutez un certificat approuvé à la liste des certificats approuvés d’OPC UA Broker.

Extension Aperçu
az iot ops connector opcua trust remove

Supprimez les certificats approuvés de la liste des certificats approuvés d’OPC UA Broker.

Extension Aperçu
az iot ops connector opcua trust show

Afficher les détails de la ressource secretsync « aio-opc-ua-broker-trust-list ».

Extension Aperçu
az iot ops create

Créez une instance d’opérations IoT.

Extension GA
az iot ops dataflow

Gestion des flux de données.

Extension GA
az iot ops dataflow endpoint

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

Extension GA
az iot ops dataflow endpoint list

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

Extension GA
az iot ops dataflow endpoint show

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

Extension GA
az iot ops dataflow list

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

Extension GA
az iot ops dataflow profile

Gestion des profils de flux de données.

Extension GA
az iot ops dataflow profile list

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

Extension GA
az iot ops dataflow profile show

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

Extension GA
az iot ops dataflow show

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

Extension GA
az iot ops delete

Supprimez les opérations IoT du cluster.

Extension GA
az iot ops identity

Gestion des identités d’instance.

Extension GA
az iot ops identity assign

Attribuez une identité managée affectée par l’utilisateur avec l’instance.

Extension GA
az iot ops identity remove

Supprimez une identité managée affectée par l’utilisateur de l’instance.

Extension GA
az iot ops identity show

Afficher les identités d’instance.

Extension GA
az iot ops init

Démarrez le cluster avec Arc pour le déploiement d’Opérations IoT.

Extension GA
az iot ops list

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

Extension GA
az iot ops schema

Gestion des schémas et des registres.

Extension Aperçu
az iot ops schema create

Créez un schéma dans un registre de schémas.

Extension Aperçu
az iot ops schema delete

Supprimez un schéma cible dans un registre de schémas.

Extension Aperçu
az iot ops schema list

Répertorier les schémas dans un registre de schémas.

Extension Aperçu
az iot ops schema registry

Gestion du Registre de schémas.

Extension Aperçu
az iot ops schema registry create

Créer un registre de schémas

Extension Aperçu
az iot ops schema registry delete

Supprimez un registre de schémas cible.

Extension Aperçu
az iot ops schema registry list

Répertorier les registres de schémas dans un groupe de ressources ou un abonnement.

Extension Aperçu
az iot ops schema registry show

Afficher les détails d’un registre de schémas.

Extension Aperçu
az iot ops schema show

Afficher les détails d’un schéma dans un registre de schémas.

Extension Aperçu
az iot ops schema show-dataflow-refs

Afficher les références de schéma utilisées pour les flux de données.

Extension Expérimental
az iot ops schema version

Gestion des versions de schéma.

Extension Aperçu
az iot ops schema version add

Ajoutez une version de schéma à un schéma.

Extension Aperçu
az iot ops schema version list

Répertorier les versions de schéma d’un schéma spécifique.

Extension Aperçu
az iot ops schema version remove

Supprimez une version de schéma cible.

Extension Aperçu
az iot ops schema version show

Afficher les détails d’une version de schéma.

Extension Aperçu
az iot ops secretsync

Gestion de la synchronisation des secrets d’instance.

Extension Aperçu
az iot ops secretsync disable

Désactivez la synchronisation des secrets pour une instance.

Extension Aperçu
az iot ops secretsync enable

Activez la synchronisation des secrets pour une instance.

Extension Aperçu
az iot ops secretsync list

Répertoriez les configurations de synchronisation secrète associées à une instance.

Extension Aperçu
az iot ops show

Afficher une instance d’opérations IoT.

Extension GA
az iot ops support

Les opérations ioT prennent en charge les opérations.

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 GA
az iot ops upgrade

Mettez à niveau une instance IoT Operations vers la dernière version.

Extension Obsolescent

az iot ops check

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

Évaluez la préparation côté cluster et l’intégrité du runtime des services d’opérations IoT déployés.

La commande par défaut affiche une vue récapitulative conviviale de haut niveau de tous les services. Utilisez l’option « --svc » pour spécifier les vérifications d’un seul service et configurer la détail par le biais de l’argument --detail-level . Remarque : le filtrage du type de ressource (--resources) et du nom (--resource-name) ne peut être utilisé qu’avec l’argument « --svc ».

{API de service prises en charge}

  • deviceregistry.microsoft.com/[v1]
  • mqttbroker.iotoperations.azure.com/[v1]
  • opcuabroker.iotoperations.azure.com/[v1beta1]
  • connectivity.iotoperations.azure.com/[v1]

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, dataflow, deviceregistry, opcua}]
                 [--post {false, true}]
                 [--pre {false, true}]
                 [--resource-name]
                 [--resources {asset, assetendpointprofile, assettype, broker, brokerlistener, dataflow, dataflowendpoint, dataflowprofile}]

Exemples

Utilisation de base. Vérifie l’intégrité globale des opérations IoT avec une sortie récapitulative.

az iot ops check

Vérifie l’intégrité et la configuration du service « broker » avec une sortie détaillée.

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

Évaluez uniquement le service « dataflow » avec une sortie optimisée pour l’intégration continue.

az iot ops check --svc dataflow --as-object

Vérifie l’intégrité de « deviceregistry » avec une sortie détaillée, mais limite les résultats aux ressources « asset ».

az iot ops check --svc deviceregistry --detail-level 2 --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, dataflow, deviceregistry, opcua
--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, dataflow, dataflowendpoint, dataflowprofile
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 create

Créez une instance d’opérations IoT.

Une exécution réussie de l’init est requise avant d’exécuter cette commande.

Le résultat de la commande nets une instance IoT Operations avec un ensemble de ressources par défaut configurées pour une fonction cohésive.

az iot ops create --cluster
                  --name
                  --resource-group
                  --sr-resource-id
                  [--add-insecure-listener {false, true}]
                  [--bp]
                  [--br]
                  [--broker-backend-workers]
                  [--broker-config-file]
                  [--broker-frontend-replicas]
                  [--broker-frontend-workers]
                  [--broker-listener-type {ClusterIp, LoadBalancer, NodePort}]
                  [--broker-mem-profile {High, Low, Medium, Tiny}]
                  [--cluster-namespace]
                  [--custom-location]
                  [--description]
                  [--df-profile-instances]
                  [--enable-rsync {false, true}]
                  [--kubernetes-distro {K3s, K8s, MicroK8s}]
                  [--location]
                  [--no-progress {false, true}]
                  [--ops-config]
                  [--ops-train]
                  [--ops-version]
                  [--runtime-socket]
                  [--tags]
                  [--trust-settings]

Exemples

Créez l’instance cible avec une entrée minimale.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID

L’exemple suivant ajoute la personnalisation à la ressource d’instance broker par défaut, ainsi qu’une description et des balises d’instance.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --broker-mem-profile High --broker-backend-workers 4 --description 'Contoso Factory' --tags tier=testX1

Cet exemple montre le déploiement d’un écouteur broker non sécurisé (aucune authentification ou authentification) configuré pour le port 1883 de l’équilibreur de charge de type de service. Utile pour les tests et/ou démonstrations. N’utilisez pas l’option non sécurisée en production.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --add-insecure-listener

Ce formulaire montre comment activer la synchronisation des ressources pour le déploiement d’instance. Pour activer l’écriture d’attribution de rôle de synchronisation des ressources, il est nécessaire sur le groupe de ressources cible.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --enable-rsync

Cet exemple met en évidence les paramètres d’approbation pour une configuration de gestionnaire de certificats fournie par l’utilisateur. Notez que le cluster doit avoir été initialisé avec « --user-trust » et qu’un déploiement de gestionnaire de certificats utilisateur doit être présent.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --trust-settings configMapName=example-bundle configMapKey=trust-bundle.pem issuerKind=ClusterIssuer issuerName=trust-manager-selfsigned-issuer

Paramètres obligatoires

--cluster

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

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

--sr-resource-id

ID de ressource du registre de schémas à utiliser avec Les opérations IoT.

Paramètres facultatifs

--add-insecure-listener

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

Valeurs acceptées: false, true
--bp --broker-backend-part

Partitions principales du répartiteur Mqtt. Valeur minimale : 1, valeur maximale : 16.

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

Facteur de redondance du serveur principal du répartiteur Mqtt. Valeur minimale : 1, valeur maximale : 5.

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

Travailleurs principaux du répartiteur Mqtt. Valeur minimale : 1, valeur maximale : 16.

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. Le contenu de configuration de fichier est utilisé sur des paramètres de configuration de répartiteur individuels. Utile pour les scénarios avancés. Le format attendu est décrit à https://aka.ms/aziotops-broker-config.

--broker-frontend-replicas --fr

Réplicas frontaux du répartiteur Mqtt. Valeur minimale : 1, valeur maximale : 16.

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

Travailleurs frontaux du répartiteur Mqtt. Valeur minimale : 1, valeur maximale : 16.

Valeur par défaut: 2
--broker-listener-type --lt

Type de service associé à l’écouteur broker mqtt par défaut.

Valeurs acceptées: ClusterIp, LoadBalancer, NodePort
Valeur par défaut: ClusterIp
--broker-mem-profile --mp

Profil mémoire du répartiteur Mqtt.

Valeurs acceptées: High, Low, Medium, Tiny
Valeur par défaut: Medium
--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
--custom-location

Nom d’emplacement personnalisé correspondant au déploiement des opérations IoT. La valeur par défaut se trouve sous la forme « location-{hash(5)} ».

--description

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
--enable-rsync

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

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

Région qui sera utilisée pour les garanties de ressources approvisionnées. Si l’emplacement du cluster connecté n’est pas fourni, il est utilisé.

--no-progress

Désactivez la représentation visuelle du travail.

Valeurs acceptées: false, true
--ops-config

Configuration personnalisée de l’extension IoT Operations arc. Le format est des paires clé=valeur séparées par un espace. --ops-config peut être utilisé une ou plusieurs fois. Pour les cas d’usage avancés.

--ops-train
Déprécié

L’argument 'ops_train' a été déconseillé et sera supprimé dans une version ultérieure.

Permet de remplacer le train de mise en production d’extension IoT Operations Arc intégré.

--ops-version
Déprécié

L’argument 'ops_version' a été déconseillé et sera supprimé dans une prochaine version.

Permet de remplacer la version intégrée de l’extension IoT Operations Arc.

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

--tags

Balises d’instance. Conteneur de propriétés dans des paires clé-valeur au format suivant : a=b c=d. Utilisez --tags «  » pour supprimer toutes les balises.

--trust-settings

Paramètres du bundle d’approbation fourni par l’utilisateur. Utilisé pour le protocole TLS du composant. Le format est des paires clé=valeur séparées par un espace. Les clés suivantes sont requises : issuerName, , configMapKeyissuerKind, configMapName. S’il n’est pas utilisé, un bundle d’approbation auto-signé fourni par le système est configuré.

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

Supprimez les opérations IoT du cluster.

Le nom de l’instance ou du cluster doit être fourni.

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 --resource-group
                  [--cluster]
                  [--force {false, true}]
                  [--include-deps {false, true}]
                  [--name]
                  [--no-progress {false, true}]
                  [--yes {false, true}]

Exemples

Entrée minimale pour la suppression complète.

az iot ops delete -n myinstance -g myresourcegroup

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

az iot ops delete -n myinstance -g myresourcegroup -y

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

az iot ops delete -n myinstance -g myresourcegroup --force

Utilisez le nom du cluster au lieu de l’instance pour la recherche.

az iot ops delete --cluster mycluster -g myresourcegroup

Application inverse de l’init.

az iot ops delete -n myinstance -g myresourcegroup --include-deps

Paramètres obligatoires

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

--cluster

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

--force

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

Valeurs acceptées: false, true
--include-deps

Indique que la commande doit supprimer les dépendances Des opérations IoT. Cette option est destinée à inverser l’application de l’init.

Valeurs acceptées: false, true
--name -n

Nom de l’instance Des opérations IoT.

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

Démarrez le cluster avec Arc pour le déploiement d’Opérations IoT.

Un cluster avec Arc est nécessaire pour déployer des opérations IoT. Pour plus d’informations https://aka.ms/aziotops-arcconnect, consultez la ressource suivante.

L’opération d’init fonctionne dans l’installation et la configuration d’une couche de base de services edge nécessaires pour le déploiement d’Opérations IoT.

Une fois la couche de base installée, la az iot ops create commande doit être utilisée pour déployer une instance.

az iot ops init --cluster
                --resource-group
                [--enable-fault-tolerance {false, true}]
                [--ensure-latest {false, true}]
                [--no-progress {false, true}]
                [--user-trust {false, true}]

Exemples

Utilisation avec entrée minimale. Ce formulaire déploie la couche de base Des opérations IoT.

az iot ops init --cluster mycluster -g myresourcegroup

Similaire à l’exemple précédent, mais avec la tolérance de panne du stockage de conteneurs Arc activée (nécessite au moins 3 nœuds).

az iot ops init --cluster mycluster -g myresourcegroup --enable-fault-tolerance

Cet exemple met en évidence l’activation des paramètres d’approbation utilisateur pour une configuration personnalisée de cert-manager. Cela ignore le déploiement du gestionnaire de certificats système et du gestionnaire de confiance.

az iot ops init --cluster mycluster -g myresourcegroup --user-trust

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

--enable-fault-tolerance

Active la tolérance de panne pour le stockage de conteneurs Azure Arc. Au moins 3 nœuds de cluster sont requis.

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
--no-progress

Désactivez la représentation visuelle du travail.

Valeurs acceptées: false, true
--user-trust --ut

Ignorez le déploiement du gestionnaire de certificats système et du gestionnaire de confiance en faveur d’une configuration fournie par l’utilisateur.

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 list

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

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

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
                  [--description]
                  [--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

--description

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. Utilisez --tags «  » pour supprimer toutes les balises.

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 upgrade

Déprécié

Cette commande a été déconseillée et sera supprimée dans une prochaine version.

Mettez à niveau une instance IoT Operations vers la dernière version.

AVERTISSEMENT : cette commande peut échouer et vous obliger à supprimer et recréer votre cluster et votre instance.

Mettez à niveau une instance d’opérations IoT, y compris la mise à jour des extensions vers les dernières versions. Utilisez cette commande si az iot ops show ou des commandes similaires échouent.

L’ID de ressource du Registre de schémas est un paramètre facultatif et peut être requis dans des scénarios spécifiques.

az iot ops upgrade --name
                   --resource-group
                   [--no-progress {false, true}]
                   [--sr-resource-id]
                   [--yes {false, true}]

Exemples

Mettez à niveau l’instance avec des entrées minimales.

az iot ops upgrade --name myinstance -g myresourcegroup

Ignorez l’invite de conformité pendant la mise à niveau de l’instance.

az iot ops upgrade --name myinstance -g myresourcegroup -y

Mettez à niveau l’instance et spécifiez l’ID de ressource du Registre de schémas.

az iot ops upgrade --name myinstance -g myresourcegroup --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID

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

--no-progress

Désactivez la représentation visuelle du travail.

Valeurs acceptées: false, true
--sr-resource-id

ID de ressource du registre de schémas à utiliser avec Les opérations IoT. Obligatoire si l’ID de ressource du Registre de schémas n’est plus trouvé dans les opérations IoT.

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