az dt twin

Nota

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 twin . Saiba mais sobre extensões.

Gerencie e configure os gêmeos digitais de uma instância do Digital Twins.

Comandos

Name	Description	Tipo	Estado
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 via 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 este gémeo já devem ser eliminadas.	Extensão	GA
az dt twin delete-all	Exclui todos os gêmeos digitais dentro de uma instância de gêmeos digitais, incluindo todos os relacionamentos para esses gêmeos.	Extensão	GA
az dt twin query	Consulte os gêmeos digitais de uma instância. Permite atravessar relações e filtrar por valores de propriedade.	Extensão	GA
az dt twin relationship	Gerencie e configure 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 de destino.	Extensão	GA
az dt twin relationship delete	Exclua um relacionamento de gêmeos digitais 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 as relações de um gêmeo digital.	Extensão	GA
az dt twin relationship show	Mostrar detalhes de uma relação 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 do Digital Twins.	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 será 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 twin create

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

--properties pode ser JSON embutido ou caminho de arquivo. Nota: --propriedades são necessárias para gêmeos que contêm componentes.

az dt twin create --dt-name
                  --dtmi
                  --twin-id
                  [--if-none-match]
                  [--properties]
                  [--resource-group]

Exemplos

Crie um gêmeo digital a partir de um modelo existente (criado anteriormente).

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id}

Crie um gêmeo digital a partir de um modelo existente (criado anteriormente) com a tag if-none-match.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id} --if-none-match

Crie um gêmeo digital a partir de um modelo existente (criado anteriormente). Instanciar com valores de propriedade.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:DeviceInformation;1" --twin-id {twin_id} --properties '{"manufacturer": "Microsoft"}'

Crie um gêmeo digital com componentes de modelos existentes (criados anteriormente). Instanciar componente com propriedades mínimas.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
    "Thermostat": {
        "$metadata": {},
    }
}'

Crie um gêmeo digital com componentes de modelos existentes (criados anteriormente). Instanciar com valores de propriedade.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
    "Temperature": 10.2,
    "Thermostat": {
        "$metadata": {},
        "setPointTemp": 23.12
    }
}'

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--dtmi --model-id -m

Digital Twins model Id. Exemplo: dtmi:com:example:Room;2.

--twin-id -t

O gêmeo digital Id.

Parâmetros Opcionais

--if-none-match

Indica que a operação create deve falhar se existir um gêmeo existente com a mesma id.

valor predefinido: False

--properties -p

Valores de propriedade inicial para instanciar um gêmeo digital ou componentes relacionados. Forneça o caminho do arquivo ou JSON embutido. As propriedades são necessárias para gêmeos que contêm componentes, no mínimo, você deve fornecer um objeto $metadata vazio para cada componente.

--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 de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dt twin delete

Remova um gêmeo digital. Todas as relações que fazem referência a este gémeo já devem ser eliminadas.

az dt twin delete --dt-name
                  --twin-id
                  [--etag]
                  [--resource-group]

Exemplos

Remova um gêmeo digital por Id.

az dt twin delete -n {instance_or_hostname} --twin-id {twin_id}

Remova um gêmeo digital por Id usando o etag.

az dt twin delete -n {instance_or_hostname} --twin-id {twin_id} --etag {etag}

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--twin-id -t

O gêmeo digital Id.

Parâmetros Opcionais

--etag -e

Valor da tag de entidade. O comando terá êxito se o etag corresponder ao etag atual do recurso.

--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 de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dt twin delete-all

Exclui todos os gêmeos digitais dentro de uma instância de gêmeos digitais, incluindo todos os relacionamentos para esses gêmeos.

az dt twin delete-all --dt-name
                      [--resource-group]
                      [--yes]

Exemplos

Exclua todos os gêmeos digitais. Quaisquer relações que façam referência aos gêmeos também serão excluídas.

az dt twin delete-all -n {instance_or_hostname}

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

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 predefinido: False

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dt twin query

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

Em muitas consultas de gêmeos, o $ caractere é usado para fazer referência à propriedade de um gêmeo $dtId . Em shells bash-like ou powershell, o $ caractere tem significado funcional e deve ser escapado como parte da entrada de consulta. Consulte o documento https://docs.microsoft.com/en-us/azure/digital-twins/concepts-cli de conceitos da CLI da Digital Twins para obter mais informações.

az dt twin query --dt-name
                 --query-command
                 [--cost {false, true}]
                 [--resource-group]

Exemplos

Consulte todos os gêmeos digitais na instância de destino e projete todos os atributos. Mostrar também o custo em unidades de consulta.

az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins" --show-cost

Consulta por modelo e projeto todos os atributos.

az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins T where IS_OF_MODEL(T, 'dtmi:com:example:Room;2')"

Consulta aproveitando '$dtId' com sintaxe compatível com bash

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.\$dtId = 'room0'"

Consulta aproveitando '$dtId' com sintaxe compatível com powershell

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.`$dtId = 'room0'"

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--query-command -q

Consulta de usuário a ser executada.

Parâmetros Opcionais

--cost --show-cost

Calcula e mostra a taxa de consulta.

valores aceites: false, true

valor predefinido: 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>.

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dt twin show

Mostre os detalhes de um gêmeo digital.

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

Exemplos

Mostre os detalhes de um gêmeo digital.

az dt twin show -n {instance_or_hostname} --twin-id {twin_id}

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--twin-id -t

O gêmeo digital Id.

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 de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dt twin update

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

Atualizações de valores de propriedade e elementos $model podem ocorrer na mesma solicitação. As operações são limitadas para adicionar, substituir e remover.

az dt twin update --dt-name
                  --json-patch
                  --twin-id
                  [--etag]
                  [--resource-group]

Exemplos

Atualize um gêmeo digital via especificação de patch JSON.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'

Atualize um gêmeo digital via especificação de patch JSON e usando etag.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --etag {etag} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'

Atualize um gêmeo digital via especificação de patch JSON.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch '[
  {"op":"replace", "path":"/Temperature", "value": 20.5},
  {"op":"add", "path":"/Areas", "value": ["ControlSystem"]}
]'

Atualize um gêmeo digital via especificação de patch JSON definida em um arquivo.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch ./my/patch/document.json

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--json-patch --patch

Uma especificação de atualização descrita pelo JSON-patch. Atualizações de valores de propriedade e elementos $model podem ocorrer na mesma solicitação. As operações são limitadas para adicionar, substituir e remover. Forneça o caminho do arquivo ou JSON embutido.

--twin-id -t

O gêmeo digital Id.

Parâmetros Opcionais

--etag -e

Valor da tag de entidade. O comando terá êxito se o etag corresponder ao etag atual do recurso.

--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 de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.