Share via


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.