az dt

Nota:

Esta referencia forma parte de la extensión azure-iot para la CLI de Azure (versión 2.37.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az dt . Obtenga más información sobre las extensiones.

Administrar las soluciones y la infraestructura de Azure Digital Twins.

Comandos

Nombre	Description	Tipo	Estado
az dt create	Cree o actualice una instancia de Digital Twins.	Extensión	GA
az dt data-history	Administrar y configurar el historial de datos.	Extensión	GA
az dt data-history connection	Administrar y configurar conexiones del historial de datos.	Extensión	GA
az dt data-history connection create	Crea una conexión de historial de datos entre una instancia de Digital Twins y los recursos admitidos.	Extensión	GA
az dt data-history connection create adx	Crea una conexión de historial de datos entre una instancia de Digital Twins y una base de datos de Azure Data Explorer. Requiere recursos de Azure Data Explorer y Event Hubs creados previamente.	Extensión	GA
az dt data-history connection delete	Elimine una conexión del historial de datos configurada en una instancia de Digital Twins.	Extensión	GA
az dt data-history connection list	Enumere todas las conexiones del historial de datos configuradas en una instancia de Digital Twins.	Extensión	GA
az dt data-history connection show	Mostrar detalles de una conexión de historial de datos configurada en una instancia de Digital Twins.	Extensión	GA
az dt data-history connection wait	Espere hasta que se complete una operación en una conexión del historial de datos.	Extensión	GA
az dt delete	Elimine una instancia de Digital Twins existente.	Extensión	GA
az dt endpoint	Administrar y configurar puntos de conexión de instancia de Digital Twins.	Extensión	GA
az dt endpoint create	Agregue puntos de conexión de salida a una instancia de Digital Twins.	Extensión	GA
az dt endpoint create eventgrid	Agrega un punto de conexión de tema de EventGrid a una instancia de Digital Twins. Requiere un recurso creado previamente.	Extensión	GA
az dt endpoint create eventhub	Agrega un punto de conexión de EventHub a una instancia de Digital Twins.	Extensión	GA
az dt endpoint create servicebus	Agrega un punto de conexión de tema de ServiceBus a una instancia de Digital Twins.	Extensión	GA
az dt endpoint delete	Quite un punto de conexión de una instancia de Digital Twins.	Extensión	GA
az dt endpoint list	Enumere todos los puntos de conexión de salida configurados en una instancia de Digital Twins.	Extensión	GA
az dt endpoint show	Mostrar detalles de un punto de conexión configurado en una instancia de Digital Twins.	Extensión	GA
az dt endpoint wait	Espere hasta que se realice una operación de punto de conexión.	Extensión	GA
az dt identity	Administrar identidades de una instancia de Digital Twins.	Extensión	GA
az dt identity assign	Asigne identidades administradas a una instancia de Digital Twins.	Extensión	GA
az dt identity remove	Quite las identidades administradas de una instancia de Digital Twins.	Extensión	GA
az dt identity show	Muestra las propiedades de identidad de una instancia de Digital Twins.	Extensión	GA
az dt job	Administrar y configurar trabajos para una instancia de gemelo digital.	Extensión	GA
az dt job deletion	Administre y configure trabajos para eliminar datos de modelo, gemelos y relaciones en una instancia de gemelo digital.	Extensión	GA
az dt job deletion create	Cree y ejecute un trabajo de eliminación en una instancia de gemelo digital.	Extensión	GA
az dt job deletion list	Enumere todos los trabajos de eliminación ejecutados en una instancia de gemelos digitales.	Extensión	GA
az dt job deletion show	Mostrar detalles de un trabajo de eliminación ejecutado en una instancia de gemelos digitales.	Extensión	GA
az dt job import	Administre y configure trabajos para importar datos de modelo, gemelos y relaciones a una instancia de gemelo digital.	Extensión	GA
az dt job import cancel	Cancele un trabajo de importación de datos ejecutado en una instancia de gemelos digitales.	Extensión	GA
az dt job import create	Cree y ejecute un trabajo de importación de datos en una instancia de gemelo digital.	Extensión	GA
az dt job import delete	Elimine un trabajo de importación de datos ejecutado en una instancia de gemelos digitales.	Extensión	GA
az dt job import list	Enumere todos los trabajos de importación de datos ejecutados en una instancia de gemelos digitales.	Extensión	GA
az dt job import show	Mostrar detalles de un trabajo de importación de datos ejecutado en una instancia de gemelos digitales.	Extensión	GA
az dt list	Enumere la colección de instancias de Digital Twins por suscripción o grupo de recursos.	Extensión	GA
az dt model	Administre modelos y definiciones de DTDL en una instancia de Digital Twins.	Extensión	GA
az dt model create	Carga uno o varios modelos.	Extensión	GA
az dt model delete	Eliminar un modelo. Un modelo solo se puede eliminar si ningún otro modelo hace referencia a él.	Extensión	GA
az dt model delete-all	Elimine todos los modelos de una instancia de Digital Twins.	Extensión	GA
az dt model list	Enumerar metadatos, definiciones y dependencias del modelo.	Extensión	GA
az dt model show	Recupere un modelo de destino o una definición de modelo.	Extensión	GA
az dt model update	Novedades los metadatos de un modelo. Actualmente solo se puede descommisionar un modelo.	Extensión	GA
az dt network	Administre la configuración de red de Digital Twins, incluidos los vínculos privados y las conexiones de punto de conexión.	Extensión	GA
az dt network private-endpoint	Administrar puntos de conexión privados de la instancia de Digital Twins.	Extensión	GA
az dt network private-endpoint connection	Administrar conexiones de punto de conexión privado de instancia de Digital Twins.	Extensión	GA
az dt network private-endpoint connection delete	Elimine una conexión de punto de conexión privado asociada a la instancia de Digital Twins.	Extensión	GA
az dt network private-endpoint connection list	Enumera las conexiones de punto de conexión privado asociadas a la instancia de Digital Twins.	Extensión	GA
az dt network private-endpoint connection set	Establezca el estado de una conexión de punto de conexión privado asociada a la instancia de Digital Twins.	Extensión	GA
az dt network private-endpoint connection show	Mostrar una conexión de punto de conexión privado asociada a la instancia de Digital Twins.	Extensión	GA
az dt network private-endpoint connection wait	Espere hasta que se complete una operación en una conexión de punto de conexión privado.	Extensión	GA
az dt network private-link	Administre las operaciones de vínculo privado de la instancia de Digital Twins.	Extensión	GA
az dt network private-link list	Enumera los vínculos privados asociados a la instancia de Digital Twins.	Extensión	GA
az dt network private-link show	Mostrar un vínculo privado asociado a la instancia de .	Extensión	GA
az dt reset	Restablezca una instancia de Digital Twins existente mediante la eliminación de recursos asociados. Actualmente solo admite la eliminación de modelos y gemelos.	Extensión	En desuso
az dt role-assignment	Administrar asignaciones de roles de RBAC para una instancia de Digital Twins.	Extensión	GA
az dt role-assignment create	Asigne un usuario, un grupo o una entidad de servicio a un rol en una instancia de Digital Twins.	Extensión	GA
az dt role-assignment delete	Quite una asignación de roles de usuario, grupo o entidad de servicio de una instancia de Digital Twins.	Extensión	GA
az dt role-assignment list	Enumere las asignaciones de roles existentes de una instancia de Digital Twins.	Extensión	GA
az dt route	Administrar y configurar rutas de eventos.	Extensión	GA
az dt route create	Agregue una ruta de eventos a una instancia de Digital Twins.	Extensión	GA
az dt route delete	Quite una ruta de eventos de una instancia de Digital Twins.	Extensión	GA
az dt route list	Enumere las rutas de eventos configuradas de una instancia de Digital Twins.	Extensión	GA
az dt route show	Mostrar detalles de una ruta de eventos configurada en una instancia de Digital Twins.	Extensión	GA
az dt show	Mostrar una instancia de Digital Twins existente.	Extensión	GA
az dt twin	Administre y configure los gemelos digitales de una instancia de Digital Twins.	Extensión	GA
az dt twin component	Mostrar y actualizar los componentes del gemelo digital de una instancia de Digital Twins.	Extensión	GA
az dt twin component show	Mostrar detalles de un componente de gemelo digital.	Extensión	GA
az dt twin component update	Actualice un componente de gemelo digital mediante la especificación de revisión JSON.	Extensión	GA
az dt twin create	Cree un gemelo digital en una instancia de .	Extensión	GA
az dt twin delete	Quite un gemelo digital. Todas las relaciones que hacen referencia a este gemelo ya deben eliminarse.	Extensión	GA
az dt twin delete-all	Elimina todos los gemelos digitales dentro de una instancia de Digital Twins, incluidas todas las relaciones de esos gemelos.	Extensión	GA
az dt twin query	Consulte los gemelos digitales de una instancia. Permite atravesar relaciones y filtrar por valores de propiedad.	Extensión	GA
az dt twin relationship	Administre y configure las relaciones de gemelos digitales de una instancia de Digital Twins.	Extensión	GA
az dt twin relationship create	Cree una relación entre gemelos digitales de origen y destino.	Extensión	GA
az dt twin relationship delete	Elimine una relación de gemelo digital en una instancia de Digital Twins.	Extensión	GA
az dt twin relationship delete-all	Elimina todas las relaciones de gemelos digitales dentro de una instancia de Digital Twins, incluidas las relaciones entrantes.	Extensión	GA
az dt twin relationship list	Enumerar las relaciones de un gemelo digital.	Extensión	GA
az dt twin relationship show	Mostrar detalles de una relación de gemelo digital.	Extensión	GA
az dt twin relationship update	Novedades las propiedades de una relación entre dos gemelos digitales mediante la especificación de revisión JSON.	Extensión	GA
az dt twin show	Muestra los detalles de un gemelo digital.	Extensión	GA
az dt twin telemetry	Pruebe y valide las rutas de eventos y los puntos de conexión de una instancia de Digital Twins.	Extensión	GA
az dt twin telemetry send	Envía telemetría en nombre de un gemelo digital. Si se proporciona la ruta de acceso del componente, la telemetría emitida está en nombre del componente.	Extensión	GA
az dt twin update	Actualice un gemelo digital de instancia mediante la especificación de revisión JSON.	Extensión	GA
az dt wait	Espere hasta que se complete una operación en una instancia de Digital Twins.	Extensión	GA

az dt create

Cree o actualice una instancia de 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]

Ejemplos

Cree una instancia en el grupo de recursos de destino mediante la ubicación del grupo de recursos.

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

Cree una instancia en el grupo de recursos de destino con la ubicación y las etiquetas especificadas.

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

Cree una instancia en el grupo de recursos de destino con una identidad administrada del sistema.

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

Cree una instancia en el grupo de recursos de destino con una identidad administrada por el usuario.

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

Cree una instancia en el grupo de recursos de destino con una identidad administrada del sistema y varias identidades administradas por el usuario.

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

Cree una instancia en el grupo de recursos de destino con una identidad administrada del sistema y asigne la identidad a uno o varios ámbitos (separados por espacios) con el rol Colaborador.

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"

Cree una instancia en el grupo de recursos de destino con una identidad administrada del sistema y, a continuación, asigne la identidad a uno o varios ámbitos con un rol especificado personalizado.

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

Actualice una instancia del grupo de recursos de destino con nuevos valores de etiqueta y deshabilite el acceso a la red pública.

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

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia de Digital Twins.

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--assign-identity

Obsoleto

El argumento "assign_identity" está en desuso y se quitará en una versión futura. Use "--mi-system-assigned" en su lugar.

Asigne una identidad generada por el sistema a la instancia de Digital Twins.

valores aceptados: false, true

--location -l

Ubicación de la instancia de Digital Twins. Si no se proporciona ninguna ubicación, se usa la ubicación del grupo de recursos. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<name>.

--mi-system-assigned

Asigne una identidad generada por el sistema a esta instancia de Digital Twins.

valores aceptados: false, true

--mi-user-assigned

Identificadores de recursos de identidad de usuario separados por espacios para agregar a la instancia de Digital Twins.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False

--pna --public-network-access

Determina si se puede acceder a la instancia de Digital Twins desde una red pública.

valores aceptados: Disabled, Enabled

valor predeterminado: Enabled

--role

Nombre de rol o Identificador que tendrá la identidad asignada por el sistema.

valor predeterminado: Contributor

--scopes

Ámbitos separados por espacios a los que puede acceder la identidad asignada por el sistema. No se puede usar con --no-wait.

--tags

Etiquetas de instancia de Digital Twins. Contenedor de propiedades en pares clave-valor con el formato siguiente: a=b c=d.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az dt delete

Elimine una instancia de Digital Twins existente.

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

Ejemplos

Elimine una instancia arbitraria de forma de bloqueo con un mensaje de confirmación.

az dt delete -n {instance_name}

Elimine una instancia arbitraria sin bloqueos ni avisos.

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

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia de Digital Twins.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--yes -y

No solicita confirmación.

valor predeterminado: False

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az dt list

Enumere la colección de instancias de Digital Twins por suscripción o grupo de recursos.

az dt list [--resource-group]

Ejemplos

Enumere todas las instancias de la suscripción actual.

az dt list

Enumere todas las instancias del grupo de recursos de destino y la salida en formato de tabla.

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

Enumere todas las instancias de la suscripción que cumplan una condición.

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

Recuento de instancias que cumplen la condición.

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

Parámetros opcionales

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az dt reset

Obsoleto

Este comando ha quedado en desuso y se quitará en una versión futura. Use "az dt job delete-all create" en su lugar.

Restablezca una instancia de Digital Twins existente mediante la eliminación de recursos asociados. Actualmente solo admite la eliminación de modelos y gemelos.

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

Ejemplos

Restablezca todos los recursos de una instancia de Digital Twins.

az dt reset -n {instance_name}

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia de Digital Twins.

Parámetros opcionales

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--yes -y

No solicita confirmación.

valor predeterminado: False

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az dt show

Mostrar una instancia de Digital Twins existente.

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

Ejemplos

Mostrar una instancia.

az dt show -n {instance_name}

Mostrar una instancia y proyectar determinadas propiedades.

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

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia de Digital Twins.

Parámetros opcionales

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az dt wait

Espere hasta que se complete una operación en una instancia de Digital Twins.

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

Ejemplos

Espere hasta que se cree una instancia arbitraria.

az dt wait -n {instance_name} --created

Espere hasta que se elimine una instancia existente.

az dt wait -n {instance_name} --deleted

Espere hasta que la propiedad publicNetworkAccess de una instancia existente esté establecida en Habilitado.

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

Parámetros requeridos

--dt-name --dtn -n

Nombre de instancia de Digital Twins.

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

valor predeterminado: False

--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

valor predeterminado: False

--exists

Espere hasta que exista el recurso.

valor predeterminado: False

--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30

--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--timeout

Espera máxima en segundos.

valor predeterminado: 3600

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.