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.