Partager via


az iot ops ns device

Remarque

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 d’appareil az iot ops ns . Apprenez-en davantage sur les extensions.

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

Gérer les appareils dans les espaces de noms Device Registry.

Commandes

Nom Description Type Statut
az iot ops ns device create

Créez un appareil dans un espace de noms Device Registry.

Extension APERÇU
az iot ops ns device delete

Supprimez un appareil d’un espace de noms Device Registry.

Extension APERÇU
az iot ops ns device endpoint

Gérez les points de terminaison des appareils dans les espaces de noms Device Registry.

Extension APERÇU
az iot ops ns device endpoint inbound

Gérer les points de terminaison entrants pour les appareils dans les espaces de noms Device Registry.

Extension APERÇU
az iot ops ns device endpoint inbound add

Ajoutez des points de terminaison entrants aux appareils dans les espaces de noms Device Registry.

Extension APERÇU
az iot ops ns device endpoint inbound add custom

Ajoutez un point de terminaison entrant personnalisé à un appareil dans un espace de noms Device Registry.

Extension APERÇU
az iot ops ns device endpoint inbound add media

Ajoutez un point de terminaison entrant multimédia à un appareil dans un espace de noms Device Registry.

Extension APERÇU
az iot ops ns device endpoint inbound add mqtt

Ajoutez un point de terminaison entrant MQTT à un appareil dans un espace de noms Device Registry.

Extension APERÇU
az iot ops ns device endpoint inbound add onvif

Ajoutez un point de terminaison entrant ONVIF à un appareil dans un espace de noms Device Registry.

Extension APERÇU
az iot ops ns device endpoint inbound add opcua

Ajoutez un point de terminaison entrant OPC UA à un appareil dans un espace de noms Device Registry.

Extension APERÇU
az iot ops ns device endpoint inbound add rest

Ajoutez un point de terminaison entrant repos à un appareil dans un espace de noms Device Registry.

Extension APERÇU
az iot ops ns device endpoint inbound add sse

Ajoutez un point de terminaison entrant SSE à un appareil dans un espace de noms Device Registry.

Extension APERÇU
az iot ops ns device endpoint inbound list

Répertorier les points de terminaison entrants d’un appareil dans un espace de noms Device Registry.

Extension APERÇU
az iot ops ns device endpoint inbound remove

Supprimez les points de terminaison entrants d’un appareil dans un espace de noms Device Registry.

Extension APERÇU
az iot ops ns device endpoint list

Répertoriez tous les points de terminaison d’un appareil dans un espace de noms Device Registry.

Extension APERÇU
az iot ops ns device query

Interroger des appareils dans des espaces de noms Device Registry.

Extension APERÇU
az iot ops ns device show

Afficher les détails d’un appareil dans un espace de noms Device Registry.

Extension APERÇU
az iot ops ns device update

Mettez à jour un appareil dans un espace de noms Device Registry.

Extension APERÇU

az iot ops ns device create

Aperçu

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

Créez un appareil dans un espace de noms Device Registry.

L’appareil est lié à une instance Azure IoT Operations.

az iot ops ns device create --instance
                            --name
                            --resource-group
                            [--attr --custom-attribute]
                            [--disabled {false, true}]
                            [--manufacturer]
                            [--model]
                            [--os]
                            [--os-version --osv]
                            [--tags]

Exemples

Créer un appareil avec une configuration minimale

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup

Créer un appareil avec des attributs personnalisés

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --attr location=building1 floor=3

Créer un appareil avec les informations du fabricant et les détails du système d’exploitation

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --manufacturer "Contoso" --model "Gateway X1" --os "Linux" --os-version "4.15"

Créer un appareil désactivé avec des balises

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --disabled --tags environment=test criticality=low

Paramètres requis

--instance -i

Nom de l’instance Azure IoT Operations.

--name -n

Nom de l’appareil à créer.

--resource-group -g

Groupe de ressources de l’instance Azure IoT Operations.

Paramètres optionnels

Les paramètres suivants sont facultatifs, mais selon le contexte, un ou plusieurs d’entre eux peuvent être nécessaires pour que la commande s’exécute correctement.

--attr --custom-attribute

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

--disabled

Désactivez l’appareil.

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

Fabricant de l’appareil.

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

Modèle d’appareil.

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

Système d’exploitation de l’appareil.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--os-version --osv

Version du système d’exploitation de l’appareil.

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

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

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

--only-show-errors

Affiche 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 ns device delete

Aperçu

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

Supprimez un appareil d’un espace de noms Device Registry.

az iot ops ns device delete --instance
                            --name
                            --resource-group
                            [--yes {false, true}]

Exemples

Supprimer un appareil

az iot ops ns device delete --name mydevice --instance myInstance -g myInstanceResourceGroup

Paramètres requis

--instance -i

Nom de l’instance Azure IoT Operations.

--name -n

Nom de l’appareil à créer.

--resource-group -g

Groupe de ressources de l’instance Azure IoT Operations.

Paramètres optionnels

Les paramètres suivants sont facultatifs, mais selon le contexte, un ou plusieurs d’entre eux peuvent être nécessaires pour que la commande s’exécute correctement.

--yes -y

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

Propriété Valeur
Valeur par défaut: False
Valeurs acceptées: false, true
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-le.

--only-show-errors

Affiche 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 ns device query

Aperçu

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

Interroger des appareils dans des espaces de noms Device Registry.

Interrogez des appareils entre des espaces de noms en fonction de différents critères de recherche, notamment le nom de l’appareil, le fabricant, le modèle et bien plus encore.

az iot ops ns device query [--cq --custom-query]
                           [--disabled {false, true}]
                           [--instance]
                           [--manufacturer]
                           [--model]
                           [--name]
                           [--os]
                           [--os-version --osv]
                           [--resource-group]

Exemples

Rechercher des appareils dans une instance IoT Operations

az iot ops ns device query --instance myInstance -g myInstanceResourceGroup

Rechercher un appareil spécifique par nom

az iot ops ns device query --name mydevice

Rechercher des appareils à partir d’un fabricant spécifique

az iot ops ns device query --manufacturer "Contoso"

Utiliser une requête personnalisée pour rechercher des appareils

az iot ops ns device query --custom-query "where tags.environment=='production'"

Paramètres optionnels

Les paramètres suivants sont facultatifs, mais selon le contexte, un ou plusieurs d’entre eux 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, à part le nom de l’instance et le groupe de ressources, sont ignorés.

--disabled

État de la ressource.

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

Nom de l’instance Azure IoT Operations.

--manufacturer

Fabricant de l’appareil.

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

Modèle d’appareil.

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

Nom de l’appareil à créer.

--os

Système d’exploitation de l’appareil.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
--os-version --osv

Version du système d’exploitation de l’appareil.

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

Groupe de ressources de l’instance Azure IoT Operations.

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

--only-show-errors

Affiche 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 ns device show

Aperçu

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

Afficher les détails d’un appareil dans un espace de noms Device Registry.

az iot ops ns device show --instance
                          --name
                          --resource-group

Exemples

Afficher les détails d’un appareil

az iot ops ns device show --name mydevice --instance myInstance -g myInstanceResourceGroup

Paramètres requis

--instance -i

Nom de l’instance Azure IoT Operations.

--name -n

Nom de l’appareil à créer.

--resource-group -g

Groupe de ressources de l’instance Azure IoT Operations.

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

--only-show-errors

Affiche 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 ns device update

Aperçu

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

Mettez à jour un appareil dans un espace de noms Device Registry.

az iot ops ns device update --instance
                            --name
                            --resource-group
                            [--attr --custom-attribute]
                            [--disabled {false, true}]
                            [--os-version --osv]
                            [--tags]

Exemples

Mettre à jour les attributs personnalisés de l’appareil

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --attr location=building2 floor=5

Mettre à jour la version du système d’exploitation

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --os-version "4.18"

Désactiver un appareil

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --disabled

Mettre à jour les balises d’appareil

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --tags environment=production criticality=high

Paramètres requis

--instance -i

Nom de l’instance Azure IoT Operations.

--name -n

Nom de l’appareil à créer.

--resource-group -g

Groupe de ressources de l’instance Azure IoT Operations.

Paramètres optionnels

Les paramètres suivants sont facultatifs, mais selon le contexte, un ou plusieurs d’entre eux peuvent être nécessaires pour que la commande s’exécute correctement.

--attr --custom-attribute

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

--disabled

Désactivez l’appareil.

Propriété Valeur
Groupe de paramètres: Additional Info Arguments
Valeurs acceptées: false, true
--os-version --osv

Version du système d’exploitation de l’appareil.

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

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

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

--only-show-errors

Affiche 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