Partager via

az iot ops asset

  • Référence

Note

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 ressource az iot ops commande. En savoir plus sur les extensions.

Gestion des ressources.

Pour plus d’informations sur la gestion des ressources, consultez aka.ms/asset-overview.

Commandes

Nom Description Type État
az iot ops asset create

Créez une ressource.

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

Créez une ressource.

Pour obtenir des exemples de formats de fichier, consultez aka.ms/aziotops-assets.

az iot ops asset create --endpoint-profile
                        --instance
                        --name
                        --resource-group
                        [--attr]
                        [--dataset-publish-int]
                        [--dataset-queue-size]
                        [--dataset-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--ef]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--event]
                        [--hardware-revision]
                        [--ig]
                        [--instance-subscription]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]
                        [--topic-path]
                        [--topic-retain {Keep, Never}]

Exemples

Créez une ressource à l’aide de l’instance donnée dans le même groupe de ressources.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance

Créez une ressource à l’aide de l’instance donnée dans un autre groupe de ressources, mais le même abonnement. Notez que l’expérience d’exploitation numérique peut ne pas afficher la ressource si elle se trouve dans un abonnement différent de l’instance.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --instance-resource-group myinstanceresourcegroup

Créez une ressource désactivée à l’aide d’un fichier contenant des événements.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event-file /path/to/myasset_events.csv --disable

Créez une ressource avec les valeurs préremplies données.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event event_notifier=EventNotifier1 name=myEvent1 observability_mode=log sampling_interval=10 queue_size=2 --event event_notifier=EventNotifier2 name=myEvent2 --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50 --description 'Description for a test asset.' --documentation-uri www.contoso.com --external-asset-id 000-000-1234 --hardware-revision 10.0 --product-code XXX100 --software-revision 0.1 --manufacturer Contoso --manufacturer-uri constoso.com --model AssetModel --serial-number 000-000-ABC10 --custom-attribute work_location=factory

Paramètres obligatoires

--endpoint-profile --ep

Nom du profil de point de terminaison de ressource.

--instance

Nom de l’instance à laquelle associer la ressource créée.

--name -n

Nom de la ressource.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

--attr --custom-attribute

Paires clé=valeur séparées par espace correspondant à des attributs personnalisés supplémentaires pour la ressource. Ce paramètre peut être utilisé plusieurs fois.

--dataset-publish-int --dpi

Intervalle de publication par défaut pour les jeux de données.

Valeur par défaut: 1000
--dataset-queue-size --dqs

Taille de file d’attente par défaut pour les jeux de données.

Valeur par défaut: 1
--dataset-sample-int --dsi

Intervalle d’échantillonnage par défaut (en millisecondes) pour les jeux de données.

Valeur par défaut: 500
--description -d

Description.

--disable

Désactivez une ressource.

Valeurs acceptées: false, true
Valeur par défaut: False
--display-name --dn

Nom complet.

--documentation-uri --du

URI de documentation.

--eai --external-asset-id

ID de ressource externe.

--ef --event-file

Chemin d’accès du fichier contenant les événements. Les types de fichiers suivants sont pris en charge : json, csv, yaml.

--epi --event-publish-int

Intervalle de publication par défaut pour les événements.

Valeur par défaut: 1000
--eqs --event-queue-size

Taille de file d’attente par défaut pour les événements.

Valeur par défaut: 1
--esi --event-sample-int

Intervalle d’échantillonnage par défaut (en millisecondes) pour les événements.

Valeur par défaut: 500
--event

Paires clé=valeur séparées par l’espace correspondant aux propriétés de l’événement à créer. Les valeurs de clé suivantes sont prises en charge : event_notifier (obligatoire), name (obligatoire), observability_mode (aucun ou journal), sampling_interval (int), queue_size (int). --event peut être utilisé 1 ou plusieurs fois. Passez en revue les exemples d’aide pour une utilisation complète des paramètres.

--hardware-revision --hr

Révision matérielle.

--ig --instance-resource-group

Groupe de ressources d’instance. S’il n’est pas fourni, le groupe de ressources de ressource sera utilisé.

--instance-subscription --is
Déprécié

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

ID d’abonnement de l’instance. S’il n’est pas fourni, l’ID d’abonnement aux ressources est utilisé.

--location -l

Emplacement. Valeurs de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--manufacturer

Fabricant.

--manufacturer-uri --mu

URI du fabricant.

--model

Modèle.

--pc --product-code

Code de produit.

--serial-number --sn

Matricule.

--software-revision --sr

Révision logicielle.

--tags

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

--topic-path --tp

Chemin d’accès à la rubrique par défaut.

--topic-retain --tr

La rubrique par défaut conserve la stratégie.

Valeurs acceptées: Keep, Never
Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az iot ops asset delete

Supprimez une ressource.

az iot ops asset delete --name
                        --resource-group

Exemples

Supprimez une ressource.

az iot ops asset delete --name myasset -g myresourcegroup

Paramètres obligatoires

--name -n

Nom de la ressource.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az iot ops asset query

Interrogez Resource Graph pour les ressources.

az iot ops asset query [--cq]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name]
                       [--documentation-uri]
                       [--eai]
                       [--endpoint-profile]
                       [--hardware-revision]
                       [--ig]
                       [--instance]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri]
                       [--model]
                       [--name]
                       [--pc]
                       [--resource-group]
                       [--serial-number]
                       [--software-revision]
                       [--topic-path]
                       [--topic-retain {Keep, Never}]

Exemples

Recherchez les ressources désactivées dans un groupe de ressources donné.

az iot ops asset query -g myresourcegroup --disabled

Recherchez les ressources qui ont le modèle, le fabricant et le numéro de série donnés.

az iot ops asset query --model model1 --manufacturer contoso --serial-number 000-000-ABC10

Paramètres facultatifs

--cq --custom-query

Requête personnalisée à utiliser. Tous les autres arguments de requête sont ignorés.

--description -d

Description.

--disabled

État de la ressource.

Valeurs acceptées: false, true
--display-name --dn

Nom complet.

--documentation-uri --du

URI de documentation.

--eai --external-asset-id

ID de ressource externe.

--endpoint-profile --ep

Nom du profil de point de terminaison de ressource.

--hardware-revision --hr

Révision matérielle.

--ig --instance-resource-group

Groupe de ressources d’instance. S’il n’est pas fourni, le groupe de ressources de ressource sera utilisé.

--instance

Nom de l’instance à laquelle associer la ressource créée.

--location -l

Emplacement. Valeurs de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--manufacturer

Fabricant.

--manufacturer-uri --mu

URI du fabricant.

--model

Modèle.

--name -n

Nom de la ressource.

--pc --product-code

Code de produit.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--serial-number --sn

Matricule.

--software-revision --sr

Révision logicielle.

--topic-path --tp

Chemin d’accès à la rubrique par défaut.

--topic-retain --tr

La rubrique par défaut conserve la stratégie.

Valeurs acceptées: Keep, Never
Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az iot ops asset show

Afficher une ressource.

az iot ops asset show --name
                      --resource-group

Exemples

Afficher les détails d’une ressource.

az iot ops asset show --name myasset -g myresourcegroup

Paramètres obligatoires

--name -n

Nom de la ressource.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az iot ops asset update

Mettez à jour une ressource.

Pour mettre à jour des jeux de données et des événements, utilisez les groupes de commandes az iot ops asset dataset et az iot ops asset event respectivement.

az iot ops asset update --name
                        --resource-group
                        [--attr]
                        [--dataset-publish-int]
                        [--dataset-queue-size]
                        [--dataset-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--hardware-revision]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]
                        [--topic-path]
                        [--topic-retain {Keep, Never}]

Exemples

Mettez à jour le jeu de données et les événements d’une ressource par défaut.

az iot ops asset update --name myasset -g myresourcegroup --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50

Mettez à jour la description d’une ressource, l’URI de documentation, la révision matérielle, le code de produit et la révision logicielle.

az iot ops asset update --name myasset -g myresourcegroup --description "Updated test asset description." --documentation-uri www.contoso.com --hardware-revision 11.0 --product-code XXX102 --software-revision 0.2

Mettez à jour le fabricant, l’URI du fabricant, le modèle, le numéro de série et l’attribut personnalisé d’une ressource.

az iot ops asset update --name myasset -g myresourcegroup --manufacturer Contoso --manufacturer-uri constoso2.com --model NewAssetModel --serial-number 000-000-ABC11 --custom-attribute work_location=new_factory --custom-attribute secondary_work_location=factory

Désactivez une ressource et supprimez un attribut personnalisé appelé « work_site ».

az iot ops asset update --name myasset -g myresourcegroup --disable --custom-attribute work_site=""

Paramètres obligatoires

--name -n

Nom de la ressource.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

--attr --custom-attribute

Paires clé=valeur séparées par espace correspondant à des attributs personnalisés supplémentaires pour la ressource. Ce paramètre peut être utilisé plusieurs fois. Pour supprimer un attribut personnalisé, définissez la valeur de l’attribut sur « ».

--dataset-publish-int --dpi

Intervalle de publication par défaut pour les jeux de données.

--dataset-queue-size --dqs

Taille de file d’attente par défaut pour les jeux de données.

--dataset-sample-int --dsi

Intervalle d’échantillonnage par défaut (en millisecondes) pour les jeux de données.

--description -d

Description.

--disable

Désactivez une ressource.

Valeurs acceptées: false, true
--display-name --dn

Nom complet.

--documentation-uri --du

URI de documentation.

--epi --event-publish-int

Intervalle de publication par défaut pour les événements.

--eqs --event-queue-size

Taille de file d’attente par défaut pour les événements.

--esi --event-sample-int

Intervalle d’échantillonnage par défaut (en millisecondes) pour les événements.

--hardware-revision --hr

Révision matérielle.

--manufacturer

Fabricant.

--manufacturer-uri --mu

URI du fabricant.

--model

Modèle.

--pc --product-code

Code de produit.

--serial-number --sn

Matricule.

--software-revision --sr

Révision logicielle.

--tags

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

--topic-path --tp

Chemin d’accès à la rubrique par défaut.

--topic-retain --tr

La rubrique par défaut conserve la stratégie.

Valeurs acceptées: Keep, Never
Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.