Compartilhar via

az dt twin component

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 de componente do az dt twin. Saiba mais sobre extensões.

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

Comandos

Nome Description Tipo Status
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 component show

Mostrar detalhes de um componente de gêmeo digital.

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

Exemplos

Mostrar detalhes de um componente de gêmeo digital

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

Parâmetros Exigidos

--component

O caminho para o componente DTDL.

--dt-name --dtn -n

Nome da instância ou nome do host dos Gêmeos Digitais. Se um nome de instância for fornecido, a assinatura do usuário será consultada pela primeira vez 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

A ID do gêmeo digital.

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 twin component update

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

Atualizações para 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 component update --component
                            --dt-name --dtn
                            --json-patch --patch
                            --twin-id
                            [--etag]
                            [--resource-group]

Exemplos

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

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

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

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

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

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

Parâmetros Exigidos

--component

O caminho para o componente DTDL.

--dt-name --dtn -n

Nome da instância ou nome do host dos Gêmeos Digitais. Se um nome de instância for fornecido, a assinatura do usuário será consultada pela primeira vez 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 patch JSON. Atualizações para 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

A ID do gêmeo digital.

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.

--etag -e

Valor da marca de entidade. O comando terá êxito se a etag corresponder à etag atual do recurso.

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