az dt

Remarque

Cette référence fait partie de l’extension azure-iot pour Azure CLI (version 2.46.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az dt . En savoir plus sur les extensions.

Gérer les solutions et l’infrastructure Azure Digital Twins.

Commandes

Nom	Description	Type	Statut
az dt create	Créez ou mettez à jour une instance Digital Twins.	Extension	GA
az dt data-history	Gérez et configurez l’historique des données.	Extension	GA
az dt data-history connection	Gérez et configurez les connexions d’historique des données.	Extension	GA
az dt data-history connection create	Crée une connexion d’historique des données entre une instance Digital Twins et des ressources prises en charge.	Extension	GA
az dt data-history connection create adx	Crée une connexion d’historique des données entre une instance Digital Twins et une base de données Azure Data Explorer. Nécessite des ressources Azure Data Explorer et Event Hub précréée.	Extension	GA
az dt data-history connection delete	Supprimez une connexion d’historique des données configurée sur une instance Digital Twins.	Extension	GA
az dt data-history connection list	Répertoriez toutes les connexions d’historique des données configurées sur une instance Digital Twins.	Extension	GA
az dt data-history connection show	Afficher les détails d’une connexion d’historique des données configurée sur une instance Digital Twins.	Extension	GA
az dt data-history connection wait	Attendez qu’une opération sur une connexion d’historique des données soit terminée.	Extension	GA
az dt delete	Supprimez une instance Digital Twins existante.	Extension	GA
az dt endpoint	Gérez et configurez les points de terminaison d’instance Digital Twins.	Extension	GA
az dt endpoint create	Ajoutez des points de terminaison de sortie à une instance Digital Twins.	Extension	GA
az dt endpoint create eventgrid	Ajoute un point de terminaison de rubrique EventGrid à une instance Digital Twins. Nécessite une ressource précréé.	Extension	GA
az dt endpoint create eventhub	Ajoute un point de terminaison EventHub à une instance Digital Twins.	Extension	GA
az dt endpoint create servicebus	Ajoute un point de terminaison de rubrique ServiceBus à une instance Digital Twins.	Extension	GA
az dt endpoint delete	Supprimez un point de terminaison d’une instance Digital Twins.	Extension	GA
az dt endpoint list	Répertoriez tous les points de terminaison de sortie configurés sur une instance Digital Twins.	Extension	GA
az dt endpoint show	Afficher les détails d’un point de terminaison configuré sur une instance Digital Twins.	Extension	GA
az dt endpoint wait	Attendez qu’une opération de point de terminaison soit terminée.	Extension	GA
az dt identity	Gérer les identites d’une instance Digital Twins.	Extension	GA
az dt identity assign	Affectez des identités managées à une instance Digital Twins.	Extension	GA
az dt identity remove	Supprimez les identités managées d’une instance Digital Twins.	Extension	GA
az dt identity show	Afficher les propriétés d’identité d’une instance Digital Twins.	Extension	GA
az dt job	Gérez et configurez des travaux pour une instance de jumeau numérique.	Extension	GA
az dt job deletion	Gérez et configurez des travaux pour supprimer des données de modèle, de jumeau et de relations dans une instance de jumeau numérique.	Extension	GA
az dt job deletion create	Créez et exécutez un travail de suppression sur une instance de jumeau numérique.	Extension	GA
az dt job deletion list	Répertoriez tous les travaux de suppression exécutés sur une instance de jumeaux numériques.	Extension	GA
az dt job deletion show	Afficher les détails d’un travail de suppression exécuté sur une instance de jumeaux numériques.	Extension	GA
az dt job import	Gérez et configurez des travaux pour l’importation de données de modèle, de jumeau et de relations vers une instance de jumeau numérique.	Extension	GA
az dt job import cancel	Annulez un travail d’importation de données exécuté sur une instance de jumeaux numériques.	Extension	GA
az dt job import create	Créez et exécutez un travail d’importation de données sur une instance de jumeau numérique.	Extension	GA
az dt job import delete	Supprimez un travail d’importation de données exécuté sur une instance de jumeaux numériques.	Extension	GA
az dt job import list	Répertoriez tous les travaux d’importation de données exécutés sur une instance de jumeaux numériques.	Extension	GA
az dt job import show	Afficher les détails d’un travail d’importation de données exécuté sur une instance de jumeaux numériques.	Extension	GA
az dt list	Répertoriez la collection d’instances Digital Twins par abonnement ou groupe de ressources.	Extension	GA
az dt model	Gérez les modèles et définitions DTDL sur une instance Digital Twins.	Extension	GA
az dt model create	Charge un ou plusieurs modèles.	Extension	GA
az dt model delete	Supprimer un modèle. Un modèle ne peut être supprimé que si aucun autre modèle ne le référence.	Extension	GA
az dt model delete-all	Supprimez tous les modèles d’une instance Digital Twins.	Extension	GA
az dt model list	Répertorier les métadonnées du modèle, les définitions et les dépendances.	Extension	GA
az dt model show	Récupérez un modèle cible ou une définition de modèle.	Extension	GA
az dt model update	Met à jour les métadonnées d’un modèle. Actuellement, un modèle ne peut être décommisionné que.	Extension	GA
az dt network	Gérez la configuration réseau Digital Twins, y compris les liaisons privées et les connexions de point de terminaison.	Extension	GA
az dt network private-endpoint	Gérer les points de terminaison privés de l’instance Digital Twins.	Extension	GA
az dt network private-endpoint connection	Gérer les connexions de point de terminaison privé de l’instance Digital Twins.	Extension	GA
az dt network private-endpoint connection delete	Supprimez une connexion de point de terminaison privé associée à l’instance Digital Twins.	Extension	GA
az dt network private-endpoint connection list	Répertorier les connexions de point de terminaison privé associées à l’instance Digital Twins.	Extension	GA
az dt network private-endpoint connection set	Définissez l’état d’une connexion de point de terminaison privé associée à l’instance Digital Twins.	Extension	GA
az dt network private-endpoint connection show	Afficher une connexion de point de terminaison privé associée à l’instance Digital Twins.	Extension	GA
az dt network private-endpoint connection wait	Attendez qu’une opération sur une connexion de point de terminaison privé soit terminée.	Extension	GA
az dt network private-link	Gérer les opérations de liaison privée de l’instance Digital Twins.	Extension	GA
az dt network private-link list	Répertorier les liens privés associés à l’instance Digital Twins.	Extension	GA
az dt network private-link show	Afficher une liaison privée associée à l’instance.	Extension	GA
az dt reset	Réinitialisez une instance Digital Twins existante en supprimant les ressources associées. Actuellement, il prend uniquement en charge la suppression de modèles et de jumeaux.	Extension	Déprécié
az dt role-assignment	Gérez les attributions de rôles RBAC pour une instance Digital Twins.	Extension	GA
az dt role-assignment create	Affectez un utilisateur, un groupe ou un principal de service à un rôle sur une instance Digital Twins.	Extension	GA
az dt role-assignment delete	Supprimez une attribution de rôle d’utilisateur, de groupe ou de principal de service d’une instance Digital Twins.	Extension	GA
az dt role-assignment list	Répertoriez les attributions de rôles existantes d’une instance Digital Twins.	Extension	GA
az dt route	Gérer et configurer des itinéraires d’événements.	Extension	GA
az dt route create	Ajoutez un itinéraire d’événement à une instance Digital Twins.	Extension	GA
az dt route delete	Supprimez un itinéraire d’événement d’une instance Digital Twins.	Extension	GA
az dt route list	Répertoriez les itinéraires d’événements configurés d’une instance Digital Twins.	Extension	GA
az dt route show	Afficher les détails d’un itinéraire d’événement configuré sur une instance Digital Twins.	Extension	GA
az dt show	Afficher une instance Digital Twins existante.	Extension	GA
az dt twin	Gérez et configurez les jumeaux numériques d’une instance Digital Twins.	Extension	GA
az dt twin component	Affichez et mettez à jour les composants de jumeau numérique d’une instance Digital Twins.	Extension	GA
az dt twin component show	Afficher les détails d’un composant de jumeau numérique.	Extension	GA
az dt twin component update	Mettez à jour un composant de jumeau numérique via la spécification de correctif JSON.	Extension	GA
az dt twin create	Créez un jumeau numérique sur une instance.	Extension	GA
az dt twin delete	Supprimez un jumeau numérique. Toutes les relations faisant référence à ce jumeau doivent déjà être supprimées.	Extension	GA
az dt twin delete-all	Supprime tous les jumeaux numériques au sein d’une instance Digital Twins, y compris toutes les relations pour ces jumeaux.	Extension	GA
az dt twin query	Interrogez les jumeaux numériques d’une instance. Permet de parcourir les relations et de filtrer par valeurs de propriété.	Extension	GA
az dt twin relationship	Gérez et configurez les relations de jumeau numérique d’une instance Digital Twins.	Extension	GA
az dt twin relationship create	Créez une relation entre les jumeaux numériques source et cible.	Extension	GA
az dt twin relationship delete	Supprimez une relation de jumeau numérique sur une instance Digital Twins.	Extension	GA
az dt twin relationship delete-all	Supprime toutes les relations de jumeaux numériques au sein d’une instance Digital Twins, y compris les relations entrantes.	Extension	GA
az dt twin relationship list	Répertorier les relations d’un jumeau numérique.	Extension	GA
az dt twin relationship show	Afficher les détails d’une relation de jumeau numérique.	Extension	GA
az dt twin relationship update	Met à jour les propriétés d’une relation entre deux jumeaux numériques via la spécification de correctif JSON.	Extension	GA
az dt twin show	Afficher les détails d’un jumeau numérique.	Extension	GA
az dt twin telemetry	Testez et validez les itinéraires d’événements et les points de terminaison d’une instance Digital Twins.	Extension	GA
az dt twin telemetry send	Envoie des données de télémétrie pour le compte d’un jumeau numérique. Si le chemin du composant est fourni, la télémétrie émise est au nom du composant.	Extension	GA
az dt twin update	Mettez à jour un jumeau numérique d’instance via la spécification des correctifs JSON.	Extension	GA
az dt wait	Attendez qu’une opération sur une instance Digital Twins soit terminée.	Extension	GA

az dt create

Créez ou mettez à jour une instance Digital Twins.

az dt create --dt-name
             --resource-group
             [--assign-identity {false, true}]
             [--location]
             [--mi-system-assigned {false, true}]
             [--mi-user-assigned]
             [--no-wait]
             [--pna {Disabled, Enabled}]
             [--role]
             [--scopes]
             [--tags]

Exemples

Créez une instance dans le groupe de ressources cible à l’aide de l’emplacement du groupe de ressources.

az dt create -n {instance_name} -g {resouce_group}

Créez une instance dans le groupe de ressources cible avec l’emplacement et les balises spécifiés.

az dt create -n {instance_name} -g {resouce_group} -l westus --tags a=b c=d

Créez une instance dans le groupe de ressources cible avec une identité managée système.

az dt create -n {instance_name} -g {resouce_group} --mi-system-assigned

Créez une instance dans le groupe de ressources cible avec une identité managée par l’utilisateur.

az dt create -n {instance_name} -g {resouce_group} --mi-user-assigned {resource_id}

Créez une instance dans le groupe de ressources cible avec une identité managée système et plusieurs identités managées par l’utilisateur.

az dt create -n {instance_name} -g {resouce_group} --mi-system-assigned --mi-user-assigned {resource_id} {resource_id}

Créez une instance dans le groupe de ressources cible avec une identité managée système, puis attribuez l’identité à une ou plusieurs étendues (séparées par l’espace) avec le rôle Contributeur.

az dt create -n {instance_name} -g {resouce_group} --mi-system-assigned --scopes "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.EventHub/namespaces/myEventHubNamespace/eventhubs/myEventHub" "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.ServiceBus/namespaces/myServiceBusNamespace/topics/myTopic"

Créez une instance dans le groupe de ressources cible avec une identité managée système, puis attribuez l’identité à une ou plusieurs étendues avec un rôle spécifié personnalisé.

az dt create -n {instance_name} -g {resouce_group} --mi-system-assigned --scopes "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.EventHub/namespaces/myEventHubNamespace/eventhubs/myEventHub" "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.ServiceBus/namespaces/myServiceBusNamespace/topics/myTopic" --role MyCustomRole

Mettez à jour une instance dans le groupe de ressources cible avec de nouvelles valeurs d’étiquette et désactivez l’accès au réseau public.

az dt create -n {instance_name} -g {resouce_group} --tags env=prod --public-network-access Disabled

Paramètres obligatoires

--dt-name --dtn -n

Nom de l’instance Digital Twins.

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--assign-identity

Déprécié

L’argument 'assign_identity' a été déconseillé et sera supprimé dans une prochaine version. Utilisez plutôt « --mi-system-assigned ».

Affectez une identité générée par le système à l’instance Digital Twins.

valeurs acceptées: false, true

--location -l

Emplacement de l’instance Digital Twins. Si aucun emplacement n’est fourni, l’emplacement du groupe de ressources est utilisé. Vous pouvez configurer l’emplacement par défaut à l’aide az configure --defaults location=<name>de .

--mi-system-assigned

Affectez une identité générée par le système à cette instance Digital Twins.

valeurs acceptées: false, true

--mi-user-assigned

ID de ressource d’identité utilisateur séparés par l’espace à ajouter à l’instance Digital Twins.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False

--pna --public-network-access

Détermine si l’instance Digital Twins est accessible à partir d’un réseau public.

valeurs acceptées: Disabled, Enabled

valeur par défaut: Enabled

--role

Le nom du rôle ou l’ID de l’identité affectée par le système aura.

valeur par défaut: Contributor

--scopes

Les étendues séparées par l’espace peuvent accéder à l’identité affectée par le système. Impossible d’utiliser --no-wait.

--tags

Balises d’instance Digital Twins. Conteneur de propriétés dans des paires clé-valeur au format suivant : a=b c=d.

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

Supprimez une instance Digital Twins existante.

az dt delete --dt-name
             [--no-wait]
             [--resource-group]
             [--yes]

Exemples

Supprimez une instance arbitraire de manière bloquante à l’aide d’une invite de confirmation.

az dt delete -n {instance_name}

Supprimez une instance arbitraire sans blocage ni invite.

az dt delete -n {instance_name} -y --no-wait

Paramètres obligatoires

--dt-name --dtn -n

Nom de l’instance Digital Twins.

Paramètres facultatifs

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

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

Répertoriez la collection d’instances Digital Twins par abonnement ou groupe de ressources.

az dt list [--resource-group]

Exemples

Répertorier toutes les instances de l’abonnement actuel.

az dt list

Répertorier toutes les instances dans le groupe de ressources cible et la sortie au format de table.

az dt list -g {resource_group} --output table

Répertoriez toutes les instances de l’abonnement qui répondent à une condition.

az dt list --query "[?contains(name, 'Production')]"

Compter les instances qui répondent à la condition.

az dt list --query "length([?contains(name, 'Production')])"

Paramètres facultatifs

--resource-group -g

Groupe de ressources d’instance Digital Twins. 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 dt reset

Déprécié

Cette commande a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « az dt job delete-all create ».

Réinitialisez une instance Digital Twins existante en supprimant les ressources associées. Actuellement, il prend uniquement en charge la suppression de modèles et de jumeaux.

az dt reset --dt-name
            [--resource-group]
            [--yes]

Exemples

Réinitialisez toutes les ressources d’une instance Digital Twins.

az dt reset -n {instance_name}

Paramètres obligatoires

--dt-name --dtn -n

Nom de l’instance Digital Twins.

Paramètres facultatifs

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False

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

Afficher une instance Digital Twins existante.

az dt show --dt-name
           [--resource-group]

Exemples

Afficher une instance.

az dt show -n {instance_name}

Afficher une instance et projeter certaines propriétés.

az dt show -n {instance_name} --query "{Endpoint:hostName, Location:location}"

Paramètres obligatoires

--dt-name --dtn -n

Nom de l’instance Digital Twins.

Paramètres facultatifs

--resource-group -g

Groupe de ressources d’instance Digital Twins. 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 dt wait

Attendez qu’une opération sur une instance Digital Twins soit terminée.

az dt wait --dt-name
           [--created]
           [--custom]
           [--deleted]
           [--exists]
           [--interval]
           [--resource-group]
           [--timeout]

Exemples

Attendez qu’une instance arbitraire soit créée.

az dt wait -n {instance_name} --created

Attendez la suppression d’une instance existante.

az dt wait -n {instance_name} --deleted

Attendez que la propriété publicNetworkAccess d’une instance existante soit activée

az dt wait -n {instance_name} --custom "publicNetworkAccess=='Enabled'"

Paramètres obligatoires

--dt-name --dtn -n

Nom de l’instance Digital Twins.

Paramètres facultatifs

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

valeur par défaut: False

--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

--deleted

Attendez la suppression.

valeur par défaut: False

--exists

Attendez que la ressource existe.

valeur par défaut: False

--interval

Intervalle d’interrogation en secondes.

valeur par défaut: 30

--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--timeout

Délai maximal d’attente en secondes.

valeur par défaut: 3600

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.