Compartir a través de


az dt

Note

Esta referencia forma parte de la extensión azure-iot para la CLI de Azure (versión 2.67.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.

Extension GA
az dt data-history

Administrar y configurar el historial de datos.

Extension GA
az dt data-history connection

Administrar y configurar conexiones del historial de datos.

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

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

Extension GA
az dt data-history connection delete

Elimine una conexión del historial de datos configurada en una instancia de Digital Twins.

Extension GA
az dt data-history connection list

Enumere todas las conexiones del historial de datos configuradas en una instancia de Digital Twins.

Extension GA
az dt data-history connection show

Mostrar detalles de una conexión de historial de datos configurada en una instancia de Digital Twins.

Extension GA
az dt data-history connection wait

Espere hasta que se complete una operación en una conexión del historial de datos.

Extension GA
az dt delete

Elimine una instancia de Digital Twins existente.

Extension GA
az dt endpoint

Administrar y configurar puntos de conexión de instancia de Digital Twins.

Extension GA
az dt endpoint create

Agregue puntos de conexión de salida a una instancia de Digital Twins.

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

Extension GA
az dt endpoint create eventhub

Agrega un punto de conexión de EventHub a una instancia de Digital Twins.

Extension GA
az dt endpoint create servicebus

Agrega un punto de conexión de tema de ServiceBus a una instancia de Digital Twins.

Extension GA
az dt endpoint delete

Quite un punto de conexión de una instancia de Digital Twins.

Extension GA
az dt endpoint list

Enumere todos los puntos de conexión de salida configurados en una instancia de Digital Twins.

Extension GA
az dt endpoint show

Mostrar detalles de un punto de conexión configurado en una instancia de Digital Twins.

Extension GA
az dt endpoint wait

Espere hasta que se realice una operación de punto de conexión.

Extension GA
az dt identity

Administrar identidades de una instancia de Digital Twins.

Extension GA
az dt identity assign

Asigne identidades administradas a una instancia de Digital Twins.

Extension GA
az dt identity remove

Quite las identidades administradas de una instancia de Digital Twins.

Extension GA
az dt identity show

Muestra las propiedades de identidad de una instancia de Digital Twins.

Extension GA
az dt job

Administrar y configurar trabajos para una instancia de gemelo digital.

Extension GA
az dt job deletion

Administre y configure trabajos para eliminar datos de modelo, gemelos y relaciones en una instancia de gemelo digital.

Extension GA
az dt job deletion create

Cree y ejecute un trabajo de eliminación en una instancia de gemelo digital.

Extension GA
az dt job deletion list

Enumere todos los trabajos de eliminación ejecutados en una instancia de gemelos digitales.

Extension GA
az dt job deletion show

Mostrar detalles de un trabajo de eliminación ejecutado en una instancia de gemelos digitales.

Extension GA
az dt job import

Administre y configure trabajos para importar datos de modelo, gemelos y relaciones a una instancia de gemelo digital.

Extension GA
az dt job import cancel

Cancele un trabajo de importación de datos ejecutado en una instancia de gemelos digitales.

Extension GA
az dt job import create

Cree y ejecute un trabajo de importación de datos en una instancia de gemelo digital.

Extension GA
az dt job import delete

Elimine un trabajo de importación de datos ejecutado en una instancia de gemelos digitales.

Extension GA
az dt job import list

Enumere todos los trabajos de importación de datos ejecutados en una instancia de gemelos digitales.

Extension GA
az dt job import show

Mostrar detalles de un trabajo de importación de datos ejecutado en una instancia de gemelos digitales.

Extension GA
az dt list

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

Extension GA
az dt model

Administre modelos y definiciones de DTDL en una instancia de Digital Twins.

Extension GA
az dt model create

Carga uno o varios modelos.

Extension GA
az dt model delete

Eliminar un modelo. Un modelo solo se puede eliminar si ningún otro modelo hace referencia a él.

Extension GA
az dt model delete-all

Elimine todos los modelos de una instancia de Digital Twins.

Extension GA
az dt model list

Enumerar metadatos, definiciones y dependencias del modelo.

Extension GA
az dt model show

Recupere un modelo de destino o una definición de modelo.

Extension GA
az dt model update

Actualiza los metadatos de un modelo. Actualmente solo se puede descommisionar un modelo.

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

Extension GA
az dt network private-endpoint

Administrar puntos de conexión privados de la instancia de Digital Twins.

Extension GA
az dt network private-endpoint connection

Administrar conexiones de punto de conexión privado de instancia de Digital Twins.

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

Extension GA
az dt network private-endpoint connection list

Enumera las conexiones de punto de conexión privado asociadas a la instancia de Digital Twins.

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

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

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

Extension GA
az dt network private-link

Administre las operaciones de vínculo privado de la instancia de Digital Twins.

Extension GA
az dt network private-link list

Enumera los vínculos privados asociados a la instancia de Digital Twins.

Extension GA
az dt network private-link show

Mostrar un vínculo privado asociado a la instancia de .

Extension GA
az dt role-assignment

Administrar asignaciones de roles de RBAC para una instancia de Digital Twins.

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

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

Extension GA
az dt role-assignment list

Enumere las asignaciones de roles existentes de una instancia de Digital Twins.

Extension GA
az dt route

Administrar y configurar rutas de eventos.

Extension GA
az dt route create

Agregue una ruta de eventos a una instancia de Digital Twins.

Extension GA
az dt route delete

Quite una ruta de eventos de una instancia de Digital Twins.

Extension GA
az dt route list

Enumere las rutas de eventos configuradas de una instancia de Digital Twins.

Extension GA
az dt route show

Mostrar detalles de una ruta de eventos configurada en una instancia de Digital Twins.

Extension GA
az dt show

Mostrar una instancia de Digital Twins existente.

Extension GA
az dt twin

Administre y configure los gemelos digitales de una instancia de Digital Twins.

Extension GA
az dt twin component

Mostrar y actualizar los componentes del gemelo digital de una instancia de Digital Twins.

Extension GA
az dt twin component show

Mostrar detalles de un componente de gemelo digital.

Extension GA
az dt twin component update

Actualice un componente de gemelo digital mediante la especificación de revisión JSON.

Extension GA
az dt twin create

Cree un gemelo digital en una instancia de .

Extension GA
az dt twin delete

Quite un gemelo digital. Todas las relaciones que hacen referencia a este gemelo ya deben eliminarse.

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

Extension GA
az dt twin query

Consulte los gemelos digitales de una instancia. Permite atravesar relaciones y filtrar por valores de propiedad.

Extension GA
az dt twin relationship

Administre y configure las relaciones de gemelos digitales de una instancia de Digital Twins.

Extension GA
az dt twin relationship create

Cree una relación entre gemelos digitales de origen y destino.

Extension GA
az dt twin relationship delete

Elimine una relación de gemelo digital en una instancia de Digital Twins.

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

Extension GA
az dt twin relationship list

Enumerar las relaciones de un gemelo digital.

Extension GA
az dt twin relationship show

Mostrar detalles de una relación de gemelo digital.

Extension GA
az dt twin relationship update

Actualiza las propiedades de una relación entre dos gemelos digitales mediante la especificación de revisión JSON.

Extension GA
az dt twin show

Muestra los detalles de un gemelo digital.

Extension GA
az dt twin telemetry

Pruebe y valide las rutas de eventos y los puntos de conexión de una instancia de Digital Twins.

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

Extension GA
az dt twin update

Actualice un gemelo digital de instancia mediante la especificación de revisión JSON.

Extension GA
az dt wait

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

Extension GA

az dt create

Cree o actualice una instancia de Digital Twins.

az dt create --dt-name --dtn
             --resource-group
             [--assign-identity {false, true}]
             [--location]
             [--mi-system-assigned {false, true}]
             [--mi-user-assigned]
             [--no-wait]
             [--pna --public-network-access {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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Propiedad Valor
Grupo de parámetros: Managed Service Identity Arguments
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.

Propiedad Valor
Grupo de parámetros: Managed Service Identity Arguments
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.

Propiedad Valor
Grupo de parámetros: Managed Service Identity Arguments
--no-wait

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

Propiedad Valor
Valor predeterminado: False
--pna --public-network-access

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

Propiedad Valor
Grupo de parámetros: Network Arguments
Valor predeterminado: Enabled
Valores aceptados: Disabled, Enabled
--role

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

Propiedad Valor
Grupo de parámetros: Managed Service Identity Arguments
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.

Propiedad Valor
Grupo de parámetros: Managed Service Identity Arguments
--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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az dt delete

Elimine una instancia de Digital Twins existente.

az dt delete --dt-name --dtn
             [--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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--no-wait

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

Propiedad Valor
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.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az dt show

Mostrar una instancia de Digital Twins existente.

az dt show --dt-name --dtn
           [--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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az dt wait

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

az dt wait --dt-name --dtn
           [--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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--created

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--custom

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
--deleted

Espere hasta que se elimine.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--interval

Intervalo de sondeo en segundos.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
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.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: 3600
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False