Partager via


az iot ops asset

Note

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

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

az iot ops asset create --endpoint-profile --ep
                        --instance
                        --name
                        --resource-group
                        [--attr --custom-attribute]
                        [--dataset-publish-int --dpi]
                        [--dataset-queue-size --dqs]
                        [--dataset-sample-int --dsi]
                        [--description]
                        [--disable {false, true}]
                        [--display-name --dn]
                        [--documentation-uri --du]
                        [--eai --external-asset-id]
                        [--ef --event-file]
                        [--epi --event-publish-int]
                        [--eqs --event-queue-size]
                        [--esi --event-sample-int]
                        [--event]
                        [--hardware-revision --hr]
                        [--ig --instance-resource-group]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri --mu]
                        [--model]
                        [--pc --product-code]
                        [--serial-number --sn]
                        [--software-revision --sr]
                        [--tags]
                        [--topic-path --tp]
                        [--topic-retain --tr {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

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

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

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--dataset-publish-int --dpi

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

Propriété Valeur
Groupe de paramètres: Dataset Default Arguments
Valeur par défaut: 1000
--dataset-queue-size --dqs

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

Propriété Valeur
Groupe de paramètres: Dataset Default Arguments
Valeur par défaut: 1
--dataset-sample-int --dsi

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

Propriété Valeur
Groupe de paramètres: Dataset Default Arguments
Valeur par défaut: 500
--description -d

Description.

--disable

Désactivez une ressource.

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

Nom complet.

--documentation-uri --du

URI de documentation.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--eai --external-asset-id

ID de ressource externe.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--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.

Propriété Valeur
Groupe de paramètres: Event Arguments
--epi --event-publish-int

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

Propriété Valeur
Groupe de paramètres: Event Default Arguments
Valeur par défaut: 1000
--eqs --event-queue-size

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

Propriété Valeur
Groupe de paramètres: Event Default Arguments
Valeur par défaut: 1
--esi --event-sample-int

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

Propriété Valeur
Groupe de paramètres: Event Default Arguments
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), (int), sampling_intervalqueue_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.

Propriété Valeur
Groupe de paramètres: Event Arguments
--hardware-revision --hr

Révision matérielle.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--ig --instance-resource-group

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

--location -l

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

--manufacturer

Manufacturer.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--manufacturer-uri --mu

URI du fabricant.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--model

Model.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--pc --product-code

Code de produit.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--serial-number --sn

Matricule.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--software-revision --sr

Révision logicielle.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--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.

Propriété Valeur
Groupe de paramètres: MQTT Topic Default Arguments
--topic-retain --tr

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

Propriété Valeur
Groupe de paramètres: MQTT Topic Default Arguments
Valeurs acceptées: Keep, Never
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--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 le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

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 verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--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 le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az iot ops asset query

Interrogez Resource Graph pour les ressources.

az iot ops asset query [--cq --custom-query]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name --dn]
                       [--documentation-uri --du]
                       [--eai --external-asset-id]
                       [--endpoint-profile --ep]
                       [--hardware-revision --hr]
                       [--ig --instance-resource-group]
                       [--instance]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri --mu]
                       [--model]
                       [--name]
                       [--pc --product-code]
                       [--resource-group]
                       [--serial-number --sn]
                       [--software-revision --sr]
                       [--topic-path --tp]
                       [--topic-retain --tr {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

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

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

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
Valeurs acceptées: false, true
--display-name --dn

Nom complet.

--documentation-uri --du

URI de documentation.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--eai --external-asset-id

ID de ressource externe.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--endpoint-profile --ep

Nom du profil de point de terminaison de ressource.

--hardware-revision --hr

Révision matérielle.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--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

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

--manufacturer

Manufacturer.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--manufacturer-uri --mu

URI du fabricant.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--model

Model.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--name -n

Nom de la ressource.

--pc --product-code

Code de produit.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--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.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--software-revision --sr

Révision logicielle.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--topic-path --tp

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

Propriété Valeur
Groupe de paramètres: MQTT Topic Default Arguments
--topic-retain --tr

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

Propriété Valeur
Groupe de paramètres: MQTT Topic Default Arguments
Valeurs acceptées: Keep, Never
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--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 le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

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 verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--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 le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az iot ops asset update

Mettez à jour une ressource.

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

az iot ops asset update --name
                        --resource-group
                        [--attr --custom-attribute]
                        [--dataset-publish-int --dpi]
                        [--dataset-queue-size --dqs]
                        [--dataset-sample-int --dsi]
                        [--description]
                        [--disable {false, true}]
                        [--display-name --dn]
                        [--documentation-uri --du]
                        [--epi --event-publish-int]
                        [--eqs --event-queue-size]
                        [--esi --event-sample-int]
                        [--hardware-revision --hr]
                        [--manufacturer]
                        [--manufacturer-uri --mu]
                        [--model]
                        [--pc --product-code]
                        [--serial-number --sn]
                        [--software-revision --sr]
                        [--tags]
                        [--topic-path --tp]
                        [--topic-retain --tr {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

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

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

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--dataset-publish-int --dpi

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

Propriété Valeur
Groupe de paramètres: Dataset Default Arguments
--dataset-queue-size --dqs

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

Propriété Valeur
Groupe de paramètres: Dataset Default Arguments
--dataset-sample-int --dsi

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

Propriété Valeur
Groupe de paramètres: Dataset Default Arguments
--description -d

Description.

--disable

Désactivez une ressource.

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

Nom complet.

--documentation-uri --du

URI de documentation.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--epi --event-publish-int

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

Propriété Valeur
Groupe de paramètres: Event Default Arguments
--eqs --event-queue-size

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

Propriété Valeur
Groupe de paramètres: Event Default Arguments
--esi --event-sample-int

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

Propriété Valeur
Groupe de paramètres: Event Default Arguments
--hardware-revision --hr

Révision matérielle.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--manufacturer

Manufacturer.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--manufacturer-uri --mu

URI du fabricant.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--model

Model.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--pc --product-code

Code de produit.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--serial-number --sn

Matricule.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--software-revision --sr

Révision logicielle.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--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.

Propriété Valeur
Groupe de paramètres: MQTT Topic Default Arguments
--topic-retain --tr

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

Propriété Valeur
Groupe de paramètres: MQTT Topic Default Arguments
Valeurs acceptées: Keep, Never
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--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 le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False