Partager via

az iot ops asset endpoint

  • Préversion
  • Référence

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 asset endpoint . En savoir plus sur les extensions.

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

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

Commandes

Nom Description Type État
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 endpoint create

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

Créez un point de terminaison de ressource.

Un emplacement personnalisé ou un nom de cluster doit être fourni. Cette commande vérifie l’existence de l’emplacement personnalisé et du cluster associés et vérifie que les deux sont correctement configurés avec l’extension microsoft.deviceregistry.assets.

Azure IoT OPC Répartiteur Agent utilisateur (préversion) utilise le même certificat client pour tous les canaux sécurisés entre lui-même et les serveurs OPC Agent utilisateur auxquels il se connecte.

az iot ops asset endpoint create --name
                                 --resource-group
                                 --ta
                                 [--ac]
                                 [--cert]
                                 [--cert-ref]
                                 [--cg]
                                 [--cl]
                                 [--clg]
                                 [--cls]
                                 [--cluster]
                                 [--cluster-subscription]
                                 [--location]
                                 [--password-ref]
                                 [--tags]
                                 [--ur]

Exemples

Créez un point de terminaison de ressource avec l’authentification utilisateur anonyme à l’aide de l’emplacement personnalisé donné.

az iot ops asset endpoint create --name {asset_endpoint} -g {resource_group} --custom-location {custom_location} --target-address {target_address}

Créez un point de terminaison de ressource avec l’authentification utilisateur anonyme à l’aide de l’emplacement personnalisé et du groupe de ressources donnés pour l’emplacement personnalisé. Le groupe de ressources doit être inclus s’il existe plusieurs emplacements personnalisés portant le même nom dans un abonnement.

az iot ops asset endpoint create --name {asset_endpoint} -g {resource_group} --custom-location {custom_location} --custom-location-resource-group {custom_location_resource_group} --target-address {target_address}

Créez un point de terminaison de ressource avec l’authentification utilisateur par mot de passe du nom d’utilisateur et des certificats détenus préconfigurés avec des valeurs préremplies. Les références de nom d’utilisateur et de mot de passe sont définies via le pilote azure Keyvault Container Storage Interface.

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --cert secret=aio-opc-ua-broker-client-certificate thumbprint=000000000000000000 password=aio-opc-ua-broker-client-certificate-password

Créez un point de terminaison de ressource avec l’authentification utilisateur par mot de passe du nom d’utilisateur et une configuration supplémentaire avec des valeurs préremplies (exemple de syntaxe PowerShell).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config '{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}'

Créez un point de terminaison de ressource avec l’authentification utilisateur par mot de passe du nom d’utilisateur et une configuration supplémentaire avec des valeurs préremplies (exemple de syntaxe cmd).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config "{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}"

Créez un point de terminaison de ressource avec l’authentification utilisateur par mot de passe du nom d’utilisateur et une configuration supplémentaire avec des valeurs préremplies (exemple de syntaxe bash).

az iot ops asset endpoint create --name myAssetEndpoint -g myRG --cluster myCluster --target-address "opc.tcp://opcplc-000000:50000" --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password" --additional-config '{"applicationName": "opcua-connector", "defaults": { "publishingIntervalMilliseconds": 100,  "samplingIntervalMilliseconds": 500,  "queueSize": 15,}, "session": {"timeout": 60000}, "subscription": {"maxItems": 1000}, "security": { "autoAcceptUntrustedServerCertificates": true}}'

Paramètres obligatoires

--name -n

Nom du point de terminaison de ressource.

--resource-group -g

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

--ta --target-address

Adresse cible. Doit être une adresse locale valide.

Paramètres facultatifs

--ac --additional-config

Configuration supplémentaire pour le type de connectivité (par exemple, OPC UA, Modbus, ONVIF).

--cert

Paires clé=valeur séparées par l’espace correspondant aux certificats associés au point de terminaison. Les valeurs de clé suivantes sont prises en charge : secret (obligatoire), thumbprint (obligatoire), password.--cert peut être utilisé 1 ou plusieurs fois. Passez en revue les exemples d’aide pour une utilisation complète des paramètres.

--cert-ref --certificate-ref --cr

Référence pour le certificat utilisé dans l’authentification. Cette méthode d’authentification utilisateur n’est pas encore prise en charge.

--cg --cluster-resource-group

Groupe de ressources pour le cluster.

--cl --custom-location

Emplacement personnalisé utilisé pour associer le point de terminaison de ressource au cluster.

--clg --custom-location-resource-group

Groupe de ressources pour l’emplacement personnalisé.

--cls --custom-location-subscription

ID d’abonnement pour l’emplacement personnalisé.

--cluster -c

Cluster à associer à la ressource.

--cluster-subscription --cs

ID d’abonnement pour le cluster.

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--password-ref --pr

Référence pour le mot de passe utilisé dans l’authentification.

--tags

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

--ur --username-reference

Référence pour le nom d’utilisateur utilisé dans l’authentification.

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 asset endpoint 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 un point de terminaison de ressource.

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

Exemples

Supprimez un point de terminaison de ressource.

az iot ops asset endpoint delete --name {asset_endpoint} -g {resource_group}

Paramètres obligatoires

--name -n

Nom du point de terminaison de ressource.

--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 asset endpoint query

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

Interrogez Resource Graph pour les points de terminaison de ressources.

az iot ops asset endpoint query [--ac]
                                [--am]
                                [--cl]
                                [--location]
                                [--resource-group]
                                [--ta]

Exemples

Recherchez les points de terminaison de ressources qui haïssent l’authentification anonyme.

az iot ops asset endpoint query --authentication-mode Anonymous

Recherchez les points de terminaison de ressources qui ont l’adresse cible donnée et l’emplacement personnalisé.

az iot ops asset endpoint query --target-address {target_address} --custom-location {custom_location}

Paramètres facultatifs

--ac --additional-config

Configuration supplémentaire pour le type de connectivité (par exemple, OPC UA, Modbus, ONVIF).

--am --authentication-mode

Mode d’authentification.

--cl --custom-location

Emplacement personnalisé utilisé pour associer le point de terminaison de ressource au cluster.

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--resource-group -g

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

--ta --target-address

Adresse cible. Doit être une adresse locale valide.

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 asset endpoint 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 un point de terminaison de ressource.

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

Exemples

Affichez les détails d’un point de terminaison de ressource.

az iot ops asset endpoint show --name {asset_endpoint} -g {resource_group}

Paramètres obligatoires

--name -n

Nom du point de terminaison de ressource.

--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 asset endpoint 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 un point de terminaison de ressource.

Pour mettre à jour les certificats détenus, utilisez le groupe az iot ops asset endpoint certificatede commandes .

az iot ops asset endpoint update --name
                                 --resource-group
                                 [--ac]
                                 [--am]
                                 [--cert-ref]
                                 [--password-ref]
                                 [--ta]
                                 [--tags]
                                 [--ur]

Exemples

Mettez à jour le mode d’authentification d’un point de terminaison de ressource pour utiliser l’authentification utilisateur anonyme.

az iot ops asset endpoint update --name {asset_endpoint} -g {resource_group} --authentication-mode Anonymous

Mettez à jour la référence de nom d’utilisateur et de mot de passe d’un point de terminaison de ressource avec des valeurs préremplies. Cela transforme le mode d’authentification en nom d’utilisateur-mot de passe s’il n’est pas déjà fait.

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --username-ref "aio-opc-ua-broker-user-authentication/opc-plc-username" --password-ref "aio-opc-ua-broker-user-authentication/opc-plc-password"

Mettez à jour l’adresse cible d’un point de terminaison de ressource et une configuration supplémentaire avec des valeurs préremplies (exemple de syntaxe PowerShell).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config '{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}'

Mettez à jour l’adresse cible d’un point de terminaison de ressource et une configuration supplémentaire avec des valeurs préremplies (exemple de syntaxe cmd).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config "{\"applicationName\": \"opcua-connector\", \"defaults\": { \"publishingIntervalMilliseconds\": 100,  \"samplingIntervalMilliseconds\": 500,  \"queueSize\": 15,}, \"session\": {\"timeout\": 60000}, \"subscription\": {\"maxItems\": 1000}, \"security\": { \"autoAcceptUntrustedServerCertificates\": true}}"

Mettez à jour l’adresse cible d’un point de terminaison de ressource et une configuration supplémentaire avec des valeurs préremplies (exemple de syntaxe bash).

az iot ops asset endpoint update --name myAssetEndpoint -g myRG --target-address "opc.tcp://opcplc-000000:50000" --additional-config '{"applicationName": "opcua-connector", "defaults": { "publishingIntervalMilliseconds": 100,  "samplingIntervalMilliseconds": 500,  "queueSize": 15,}, "session": {"timeout": 60000}, "subscription": {"maxItems": 1000}, "security": { "autoAcceptUntrustedServerCertificates": true}}'

Paramètres obligatoires

--name -n

Nom du point de terminaison de ressource.

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

--ac --additional-config

Configuration supplémentaire pour le type de connectivité (par exemple, OPC UA, Modbus, ONVIF).

--am --authentication-mode

Mode d’authentification.

--cert-ref --certificate-ref --cr

Référence pour le certificat utilisé dans l’authentification. Cette méthode d’authentification utilisateur n’est pas encore prise en charge.

--password-ref --pr

Référence pour le mot de passe utilisé dans l’authentification.

--ta --target-address

Adresse cible. Doit être une adresse locale valide.

--tags

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

--ur --username-reference

Référence pour le nom d’utilisateur utilisé dans l’authentification.

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.