Compartilhar via


az dt

Note

Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.67.0 ou superior). A extensão instalará 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 dos Gêmeos Digitais.

Extension GA
az dt data-history

Gerenciar e configurar o histórico de dados.

Extension GA
az dt data-history connection

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

Extension GA
az dt data-history connection create

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

Extension GA
az dt data-history connection create adx

Cria uma conexão de histórico de dados entre uma instância dos 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.

Extension GA
az dt data-history connection delete

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

Extension GA
az dt data-history connection list

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

Extension GA
az dt data-history connection show

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

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

Extension GA
az dt delete

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

Extension GA
az dt endpoint

Gerenciar e configurar pontos de extremidade de instância dos Gêmeos Digitais.

Extension GA
az dt endpoint create

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

Extension GA
az dt endpoint create eventgrid

Adiciona um ponto de extremidade do Tópico eventGrid a uma instância dos Gêmeos Digitais. Requer recurso pré-criado.

Extension GA
az dt endpoint create eventhub

Adiciona um ponto de extremidade eventHub a uma instância dos Gêmeos Digitais.

Extension GA
az dt endpoint create servicebus

Adiciona um ponto de extremidade do Tópico do ServiceBus a uma instância dos Gêmeos Digitais.

Extension GA
az dt endpoint delete

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

Extension GA
az dt endpoint list

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

Extension GA
az dt endpoint show

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

Extension GA
az dt endpoint wait

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

Extension GA
az dt identity

Gerenciar identidades de uma instância dos Gêmeos Digitais.

Extension GA
az dt identity assign

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

Extension GA
az dt identity remove

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

Extension GA
az dt identity show

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

Extension GA
az dt job

Gerenciar e configurar trabalhos para uma instância de gêmeo digital.

Extension GA
az dt job deletion

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

Extension GA
az dt job deletion create

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

Extension GA
az dt job deletion list

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

Extension GA
az dt job deletion show

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

Extension GA
az dt job import

Gerencie e configure trabalhos para importar dados de modelo, gêmeo e relações para uma instância de gêmeo digital.

Extension GA
az dt job import cancel

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

Extension GA
az dt job import create

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

Extension GA
az dt job import delete

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

Extension GA
az dt job import list

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

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

Extension GA
az dt list

Liste a coleção de instâncias dos Gêmeos Digitais por assinatura ou grupo de recursos.

Extension GA
az dt model

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

Extension GA
az dt model create

Carrega um ou mais modelos.

Extension GA
az dt model delete

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

Extension GA
az dt model delete-all

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

Extension GA
az dt model list

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

Extension GA
az dt model show

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

Extension GA
az dt model update

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

Extension GA
az dt network

Gerenciar a configuração de rede dos Gêmeos Digitais, incluindo links privados e conexões de ponto de extremidade.

Extension GA
az dt network private-endpoint

Gerenciar pontos de extremidade privados da instância dos Gêmeos Digitais.

Extension GA
az dt network private-endpoint connection

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

Extension GA
az dt network private-endpoint connection delete

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

Extension GA
az dt network private-endpoint connection list

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

Extension GA
az dt network private-endpoint connection set

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

Extension GA
az dt network private-endpoint connection show

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

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

Extension GA
az dt network private-link

Gerenciar operações de link privado da instância dos Gêmeos Digitais.

Extension GA
az dt network private-link list

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

Extension GA
az dt network private-link show

Mostrar um link privado associado à instância.

Extension GA
az dt role-assignment

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

Extension GA
az dt role-assignment create

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

Extension GA
az dt role-assignment delete

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

Extension GA
az dt role-assignment list

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

Extension GA
az dt route

Gerenciar e configurar rotas de evento.

Extension GA
az dt route create

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

Extension GA
az dt route delete

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

Extension GA
az dt route list

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

Extension GA
az dt route show

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

Extension GA
az dt show

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

Extension GA
az dt twin

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

Extension GA
az dt twin component

Mostrar e atualizar os componentes do gêmeo digital de uma instância dos Gêmeos Digitais.

Extension GA
az dt twin component show

Mostrar detalhes de um componente de gêmeo digital.

Extension GA
az dt twin component update

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

Extension GA
az dt twin create

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

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

Extension GA
az dt twin delete-all

Exclui todos os gêmeos digitais em uma instância dos Gêmeos Digitais, incluindo todas as relações desses gêmeos.

Extension GA
az dt twin query

Consulte os gêmeos digitais de uma instância. Permite a passagem de relações e a filtragem por valores de propriedade.

Extension GA
az dt twin relationship

Gerencie e configure as relações de gêmeo digital de uma instância dos Gêmeos Digitais.

Extension GA
az dt twin relationship create

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

Extension GA
az dt twin relationship delete

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

Extension GA
az dt twin relationship delete-all

Exclui todas as relações de gêmeo digital em uma instância dos Gêmeos Digitais, incluindo relações de entrada.

Extension GA
az dt twin relationship list

Listar as relações de um gêmeo digital.

Extension GA
az dt twin relationship show

Mostrar detalhes de uma relação de gêmeo digital.

Extension GA
az dt twin relationship update

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

Extension GA
az dt twin show

Mostrar os detalhes de um gêmeo digital.

Extension GA
az dt twin telemetry

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

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

Extension GA
az dt twin update

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

Extension GA
az dt wait

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

Extension GA

az dt create

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

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]

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 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 dos Gêmeos Digitais.

--resource-group -g

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--assign-identity
Preterido

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

Atribua uma identidade gerada pelo sistema à instância dos Gêmeos Digitais.

Propriedade Valor
Grupo de parâmetros: Managed Service Identity Arguments
Valores aceitos: false, true
--location -l

Local da instância dos 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}.

--mi-system-assigned

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

Propriedade Valor
Grupo de parâmetros: Managed Service Identity Arguments
Valores aceitos: false, true
--mi-user-assigned

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

Propriedade Valor
Grupo de parâmetros: Managed Service Identity Arguments
--no-wait

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

Propriedade Valor
Valor padrão: False
--pna --public-network-access

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

Propriedade Valor
Grupo de parâmetros: Network Arguments
Valor padrão: Enabled
Valores aceitos: Disabled, Enabled
--role

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

Propriedade Valor
Grupo de parâmetros: Managed Service Identity Arguments
Valor padrão: Contributor
--scopes

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

Propriedade Valor
Grupo de parâmetros: Managed Service Identity Arguments
--tags

Marcas de instância dos Gêmeos Digitais. Recipiente de propriedades em pares de valores-chave com o seguinte formato: a=b c=d.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az dt delete

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

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

Exemplos

Exclua uma instância arbitrária em modo 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 dos Gêmeos Digitais.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

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

Propriedade Valor
Valor padrão: False
--resource-group -g

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

--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az dt list

Liste a coleção de instâncias dos Gêmeos Digitais 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 na saída no formato de tabela.

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

Lista 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--resource-group -g

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

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az dt show

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

az dt show --dt-name --dtn
           [--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 dos Gêmeos Digitais.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--resource-group -g

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

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az dt wait

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

az dt wait --dt-name --dtn
           [--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 esteja definida como Habilitada

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

Parâmetros Exigidos

--dt-name --dtn -n

Nome da instância dos Gêmeos Digitais.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--custom

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

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
--deleted

Aguarde até ser excluído.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 30
--resource-group -g

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

--timeout

Espera máxima em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 3600
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False