Compartilhar via


az dt

Observação

Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.46.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az dt . Saiba mais sobre extensões.

Gerenciar soluções e a infraestrutura dos Gêmeos Digitais do Azure.

Comandos

Nome Description Tipo Status
az dt create

Crie ou atualize uma instância de Gêmeos Digitais.

Extensão GA
az dt data-history

Gerenciar e configurar o histórico de dados.

Extensão GA
az dt data-history connection

Gerenciar e configurar conexões de histórico de dados.

Extensão GA
az dt data-history connection create

Cria uma conexão de histórico de dados entre uma instância de Gêmeos Digitais e recursos com suporte.

Extensão GA
az dt data-history connection create adx

Cria uma conexão de histórico de dados entre uma instância de Gêmeos Digitais e um banco de dados do Azure Data Explorer. Requer recursos pré-criados do Azure Data Explorer e do Hub de Eventos.

Extensão GA
az dt data-history connection delete

Exclua uma conexão de histórico de dados configurada em uma instância de Gêmeos Digitais.

Extensão GA
az dt data-history connection list

Liste todas as conexões do histórico de dados configuradas em uma instância de Gêmeos Digitais.

Extensão GA
az dt data-history connection show

Mostrar detalhes de uma conexão de histórico de dados configurada em uma instância de Gêmeos Digitais.

Extensão GA
az dt data-history connection wait

Aguarde até que uma operação em uma conexão de histórico de dados seja concluída.

Extensão GA
az dt delete

Exclua uma instância existente de Gêmeos Digitais.

Extensão GA
az dt endpoint

Gerencie e configure pontos de extremidade de instância do Digital Twins.

Extensão GA
az dt endpoint create

Adicione pontos de extremidade de saída a uma instância de Gêmeos Digitais.

Extensão GA
az dt endpoint create eventgrid

Adiciona um ponto de extremidade EventGrid Topic a uma instância de Gêmeos Digitais. Requer recurso pré-criado.

Extensão GA
az dt endpoint create eventhub

Adiciona um ponto de extremidade do EventHub a uma instância do Digital Twins.

Extensão GA
az dt endpoint create servicebus

Adiciona um ponto de extremidade ServiceBus Topic a uma instância de Gêmeos Digitais.

Extensão GA
az dt endpoint delete

Remova um ponto de extremidade de uma instância de Gêmeos Digitais.

Extensão GA
az dt endpoint list

Liste todos os pontos de extremidade de saída configurados em uma instância de Gêmeos Digitais.

Extensão GA
az dt endpoint show

Mostrar detalhes de um ponto de extremidade configurado em uma instância de Gêmeos Digitais.

Extensão GA
az dt endpoint wait

Aguarde até que uma operação de ponto de extremidade seja concluída.

Extensão GA
az dt identity

Gerenciar identificações de uma instância de Gêmeos Digitais.

Extensão GA
az dt identity assign

Atribua identidades gerenciadas a uma instância de Gêmeos Digitais.

Extensão GA
az dt identity remove

Remova identidades gerenciadas de uma instância de Gêmeos Digitais.

Extensão GA
az dt identity show

Mostrar as propriedades de identidade de uma instância de Gêmeos Digitais.

Extensão GA
az dt job

Gerencie e configure trabalhos para uma instância de gêmeo digital.

Extensão GA
az dt job deletion

Gerencie e configure trabalhos para excluir dados de modelo, gêmeo e relacionamentos em uma instância de gêmeo digital.

Extensão GA
az dt job deletion create

Crie e execute um trabalho de exclusão em uma instância de gêmeo digital.

Extensão GA
az dt job deletion list

Liste todos os trabalhos de exclusão executados em uma instância de gêmeos digitais.

Extensão GA
az dt job deletion show

Mostrar detalhes de um trabalho de exclusão executado em uma instância de gêmeos digitais.

Extensão GA
az dt job import

Gerencie e configure trabalhos para importar dados de modelo, gêmeo e relacionamentos para uma instância de gêmeo digital.

Extensão GA
az dt job import cancel

Cancelar um trabalho de importação de dados executado em uma instância de gêmeos digitais.

Extensão GA
az dt job import create

Crie e execute um trabalho de importação de dados em uma instância de gêmeo digital.

Extensão GA
az dt job import delete

Exclua um trabalho de importação de dados executado em uma instância de gêmeos digitais.

Extensão GA
az dt job import list

Liste todos os trabalhos de importação de dados executados em uma instância de gêmeos digitais.

Extensão GA
az dt job import show

Mostrar detalhes de um trabalho de importação de dados executado em uma instância de gêmeos digitais.

Extensão GA
az dt list

Liste a coleção de instâncias do Digital Twins por assinatura ou grupo de recursos.

Extensão GA
az dt model

Gerenciar modelos e definições DTDL em uma instância de Gêmeos Digitais.

Extensão GA
az dt model create

Carrega um ou mais modelos.

Extensão GA
az dt model delete

Excluir um modelo. Um modelo só pode ser excluído se nenhum outro modelo fizer referência a ele.

Extensão GA
az dt model delete-all

Exclua todos os modelos em uma instância de Gêmeos Digitais.

Extensão GA
az dt model list

Listar metadados, definições e dependências do modelo.

Extensão GA
az dt model show

Recuperar um modelo de destino ou uma definição de modelo.

Extensão GA
az dt model update

Atualiza os metadados de um modelo. Atualmente, um modelo só pode ser descomissionado.

Extensão GA
az dt network

Gerencie a configuração de rede Digital Twins, incluindo links privados e conexões de endpoint.

Extensão GA
az dt network private-endpoint

Gerenciar pontos de extremidade privados da instância do Digital Twins.

Extensão GA
az dt network private-endpoint connection

Gerenciar conexões de ponto de extremidade privado de instância de Gêmeos Digitais.

Extensão GA
az dt network private-endpoint connection delete

Exclua uma conexão de ponto de extremidade privado associada à instância de Gêmeos Digitais.

Extensão GA
az dt network private-endpoint connection list

Listar conexões de ponto de extremidade privado associadas à instância de Gêmeos Digitais.

Extensão GA
az dt network private-endpoint connection set

Defina o estado de uma conexão de ponto de extremidade privado associada à instância de Gêmeos Digitais.

Extensão GA
az dt network private-endpoint connection show

Mostrar uma conexão de ponto de extremidade privado associada à instância de Gêmeos Digitais.

Extensão GA
az dt network private-endpoint connection wait

Aguarde até que uma operação em uma conexão de ponto de extremidade privado seja concluída.

Extensão GA
az dt network private-link

Gerencie operações de link privado de instância de Gêmeos Digitais.

Extensão GA
az dt network private-link list

Listar links privados associados à instância de Gêmeos Digitais.

Extensão GA
az dt network private-link show

Mostrar um link privado associado à instância.

Extensão GA
az dt reset

Redefina uma instância existente do Digital Twins excluindo ativos associados. Atualmente só suporta a exclusão de modelos e gêmeos.

Extensão Preterido
az dt role-assignment

Gerenciar atribuições de função RBAC para uma instância de Gêmeos Digitais.

Extensão GA
az dt role-assignment create

Atribua um usuário, grupo ou entidade de serviço a uma função em uma instância de Gêmeos Digitais.

Extensão GA
az dt role-assignment delete

Remova uma atribuição de função principal de usuário, grupo ou serviço de uma instância de Gêmeos Digitais.

Extensão GA
az dt role-assignment list

Listar as atribuições de função existentes de uma instância de Gêmeos Digitais.

Extensão GA
az dt route

Gerenciar e configurar rotas de eventos.

Extensão GA
az dt route create

Adicione uma rota de evento a uma instância de Gêmeos Digitais.

Extensão GA
az dt route delete

Remova uma rota de evento de uma instância de Gêmeos Digitais.

Extensão GA
az dt route list

Liste as rotas de eventos configuradas de uma instância de Gêmeos Digitais.

Extensão GA
az dt route show

Mostrar detalhes de uma rota de evento configurada em uma instância de Gêmeos Digitais.

Extensão GA
az dt show

Mostrar uma instância existente de Gêmeos Digitais.

Extensão GA
az dt twin

Gerencie e configure os gêmeos digitais de uma instância de Gêmeos Digitais.

Extensão GA
az dt twin component

Mostrar e atualizar os componentes de gêmeos digitais de uma instância de Gêmeos Digitais.

Extensão GA
az dt twin component show

Mostrar detalhes de um componente de gêmeo digital.

Extensão GA
az dt twin component update

Atualize um componente de gêmeo digital por meio da especificação de patch JSON.

Extensão GA
az dt twin create

Crie um gêmeo digital em uma instância.

Extensão GA
az dt twin delete

Remova um gêmeo digital. Todas as relações que fazem referência a esse gêmeo já devem ser excluídas.

Extensão GA
az dt twin delete-all

Exclui todos os gêmeos digitais em uma instância de Gêmeos Digitais, incluindo todos os relacionamentos desses gêmeos.

Extensão GA
az dt twin query

Consulte os gêmeos digitais de uma instância. Permite atravessar relacionamentos e filtrar por valores de propriedade.

Extensão GA
az dt twin relationship

Gerenciar e configurar as relações de gêmeos digitais de uma instância de Gêmeos Digitais.

Extensão GA
az dt twin relationship create

Crie uma relação entre gêmeos digitais de origem e destino.

Extensão GA
az dt twin relationship delete

Exclua uma relação de gêmeo digital em uma instância de Gêmeos Digitais.

Extensão GA
az dt twin relationship delete-all

Exclui todos os relacionamentos de gêmeos digitais em uma instância de Gêmeos Digitais, incluindo relacionamentos de entrada.

Extensão GA
az dt twin relationship list

Liste os relacionamentos de um gêmeo digital.

Extensão GA
az dt twin relationship show

Mostrar detalhes de um relacionamento de gêmeos digitais.

Extensão GA
az dt twin relationship update

Atualiza as propriedades de um relacionamento entre dois gêmeos digitais por meio da especificação de patch JSON.

Extensão GA
az dt twin show

Mostre os detalhes de um gêmeo digital.

Extensão GA
az dt twin telemetry

Teste e valide as rotas de evento e os pontos de extremidade de uma instância de Gêmeos Digitais.

Extensão GA
az dt twin telemetry send

Envia telemetria em nome de um gêmeo digital. Se o caminho do componente for fornecido, a telemetria emitida estará em nome do componente.

Extensão GA
az dt twin update

Atualize um gêmeo digital de instância por meio da especificação de patch JSON.

Extensão GA
az dt wait

Aguarde até que uma operação em uma instância de Gêmeos Digitais seja concluída.

Extensão GA

az dt create

Crie ou atualize uma instância de Gêmeos Digitais.

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]

Exemplos

Crie uma instância no grupo de recursos de destino usando o local do grupo de recursos.

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

Crie uma instância no grupo de recursos de destino com o local e as marcas especificados.

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

Crie uma instância no grupo de recursos de destino com uma identidade gerenciada pelo sistema.

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

Crie uma instância no grupo de recursos de destino com uma identidade gerenciada pelo usuário.

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

Crie uma instância no grupo de recursos de destino com uma identidade gerenciada pelo sistema e várias identidades gerenciadas pelo usuário.

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

Crie uma instância no grupo de recursos de destino com uma identidade gerenciada pelo sistema e, em seguida, atribua a identidade a um ou mais escopos (separados por espaço) com a função de 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"

Crie uma instância no grupo de recursos de destino com uma identidade gerenciada pelo sistema e atribua a identidade a um ou mais escopos com uma função especificada personalizada.

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

Atualize uma instância no grupo de recursos de destino com novos valores de marca e desabilite o acesso à rede pública.

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

Parâmetros Exigidos

--dt-name --dtn -n

Nome da instância do Digital Twins.

--resource-group -g

Grupo de recursos de instância de Gêmeos Digitais. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--assign-identity
Preterido

O argumento 'assign_identity' foi preterido e será removido em uma versão futura. Em vez disso, use '--mi-system-assigned'.

Atribua uma identidade gerada pelo sistema à instância do Digital Twins.

valores aceitos: false, true
--location -l

Local da instância de Gêmeos Digitais. Se nenhum local for fornecido, o local do grupo de recursos será usado. Você pode configurar o local padrão usando az configure --defaults location=<name>o .

--mi-system-assigned

Atribua uma identidade gerada pelo sistema a essa instância de Gêmeos Digitais.

valores aceitos: false, true
--mi-user-assigned

IDs de recurso de identidade de usuário separados por espaço para adicionar à instância de Gêmeos Digitais.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--pna --public-network-access

Determina se a instância de Gêmeos Digitais pode ser acessada de uma rede pública.

valores aceitos: Disabled, Enabled
valor padrão: Enabled
--role

Nome da função ou ID que a identidade atribuída ao sistema terá.

valor padrão: Contributor
--scopes

Escopos separados por espaço que a identidade atribuída ao sistema pode acessar. Não pode ser usado com --no-wait.

--tags

Tags de instância de Gêmeos Digitais. Conjunto de propriedades em pares chave-valor com o seguinte formato: a=b c=d.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az dt delete

Exclua uma instância existente de Gêmeos Digitais.

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

Exemplos

Exclua uma instância arbitrária de forma de bloqueio com um prompt de confirmação.

az dt delete -n {instance_name}

Exclua uma instância arbitrária sem bloqueio ou prompt.

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

Parâmetros Exigidos

--dt-name --dtn -n

Nome da instância do Digital Twins.

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--resource-group -g

Grupo de recursos de instância de Gêmeos Digitais. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--yes -y

Não solicite confirmação.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az dt list

Liste a coleção de instâncias do Digital Twins por assinatura ou grupo de recursos.

az dt list [--resource-group]

Exemplos

Liste todas as instâncias na assinatura atual.

az dt list

Liste todas as instâncias no grupo de recursos de destino e a saída em formato de tabela.

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

Liste todas as instâncias na assinatura que atendem a uma condição.

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

Contar instâncias que atendem à condição.

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

Parâmetros Opcionais

--resource-group -g

Grupo de recursos de instância de Gêmeos Digitais. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az dt reset

Preterido

Esse comando foi preterido e será removido em uma versão futura. Use 'az dt job delete-all create' em vez disso.

Redefina uma instância existente do Digital Twins excluindo ativos associados. Atualmente só suporta a exclusão de modelos e gêmeos.

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

Exemplos

Redefina todos os ativos de uma instância do Digital Twins.

az dt reset -n {instance_name}

Parâmetros Exigidos

--dt-name --dtn -n

Nome da instância do Digital Twins.

Parâmetros Opcionais

--resource-group -g

Grupo de recursos de instância de Gêmeos Digitais. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--yes -y

Não solicite confirmação.

valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az dt show

Mostrar uma instância existente de Gêmeos Digitais.

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

Exemplos

Mostrar uma instância.

az dt show -n {instance_name}

Mostrar uma instância e projetar determinadas propriedades.

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

Parâmetros Exigidos

--dt-name --dtn -n

Nome da instância do Digital Twins.

Parâmetros Opcionais

--resource-group -g

Grupo de recursos de instância de Gêmeos Digitais. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az dt wait

Aguarde até que uma operação em uma instância de Gêmeos Digitais seja concluída.

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

Exemplos

Aguarde até que uma instância arbitrária seja criada.

az dt wait -n {instance_name} --created

Aguarde até que uma instância existente seja excluída.

az dt wait -n {instance_name} --deleted

Aguarde até que a propriedade publicNetworkAccess de uma instância existente seja definida como Enabled

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

Parâmetros Exigidos

--dt-name --dtn -n

Nome da instância do Digital Twins.

Parâmetros Opcionais

--created

Aguarde até criar com 'provisioningState' em 'Succeeded'.

valor padrão: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

valor padrão: False
--exists

Aguarde até que o recurso exista.

valor padrão: False
--interval

Intervalo de sondagem em segundos.

valor padrão: 30
--resource-group -g

Grupo de recursos de instância de Gêmeos Digitais. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--timeout

Espera máxima em segundos.

valor padrão: 3600
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.