Compartilhar via

Localizar e corrigir dispositivos ausentes da Atualização de Dispositivo para Hub IoT usando a verificação do agente

  • Artigo

Saiba como usar o recurso de verificação do agente para localizar, diagnosticar e corrigir dispositivos ausentes da instância da Atualização de Dispositivo para Hub IoT.

Pré-requisitos

Observação

O recurso de verificação do agente só pode executar verificações de validação nos dispositivos que têm o agente da Atualização de Dispositivo instalado e que relatam uma ID de modelo PnP que corresponde àqueles compatíveis com a Atualização de Dispositivo para Hub IoT.

Navegadores compatíveis:

Verificações de validação compatíveis com a verificação do agente

Atualmente, o recurso de verificação do agente executa as verificações de validação a seguir em todos os dispositivos que atendem aos pré-requisitos acima.

Verificação de validação Critérios
ID do modelo PnP A ID do modelo PnP é uma cadeia de caracteres relatada pelo agente de Atualização de Dispositivo para o dispositivo gêmeo que descreve o modelo PnP que deve ser usado para a comunicação entre dispositivo/nuvem. Essa cadeia de caracteres precisa ser um DTMI (identificador de modelo de gêmeo digital) válido que dê suporte à interface de Atualização de Dispositivo.
ID da interface A ID da interface é uma cadeia de caracteres relatada pelo agente da Atualização de Dispositivo para o dispositivo gêmeo que descreve a versão da interface da Atualização de Dispositivo que deve ser usada para a comunicação entre dispositivo/nuvem. Essa cadeia de caracteres precisa ser uma DTMI válida que dê suporte à interface de Atualização de Dispositivo.
Nomes da propriedade de compatibilidade CompatPropertyNames é um campo relatado pelo agente da Atualização de Dispositivo para o dispositivo gêmeo que descreve os campos deviceProperties que devem ser usados para determinar a compatibilidade do dispositivo com determinada implantação. O valor desse campo precisa ser uma cadeia de caracteres de nomes delimitados por vírgula. A cadeia de caracteres precisa conter, pelo menos, um e, no máximo, cinco nomes. Cada nome precisa ter <32 caracteres.
Valores da propriedade de compatibilidade Os valores da propriedade de compatibilidade são os pares campo:valor especificados pelo campo compatPropertyNames e relatados pelo agente da Atualização de Dispositivo para o dispositivo gêmeo como deviceProperties. Cada nome definido nos nomes da propriedade de compatibilidade precisa ter um par campo:valor correspondente relatado. O valor de cada par é limitado a 64 caracteres.
Grupo de ADU A marca Grupo da ADU é uma marca opcional definida no dispositivo gêmeo do dispositivo e determina a qual grupo de dispositivos o dispositivo pertence. Se especificada, a cadeia de caracteres da marca será limitada a 255 caracteres e só poderá conter caracteres alfanuméricos e os seguintes caracteres especiais: ".", "-", "_" e "~"

Em caso de falha de um dispositivo em um desses critérios, talvez ele não seja exibido corretamente na Atualização de Dispositivo. A correção do valor inválido para atender aos critérios especificados fará com que o dispositivo seja exibido corretamente na Atualização de Dispositivo. Se o dispositivo não é exibido na Atualização de Dispositivo nem na verificação do agente, talvez seja necessário executar a sincronização do dispositivo para resolver o problema.

Exibir os resultados da verificação do agente

Os resultados da verificação do agente podem ser encontrados na guia Diagnóstico da Atualização de Dispositivo.

  1. No portal do Azure, navegue para o hub IoT.
  2. Selecione Atualizações no menu de navegação e escolha a guia Diagnóstico.
  3. Expanda a seção Localizar dispositivos ausentes.

Iniciar uma operação de sincronização de dispositivo

A sincronização do dispositivo deverá ser disparada se um dispositivo tiver sido registrado no Hub IoT, mas não estiver sendo exibido na Atualização de Dispositivo nem nos resultados da verificação do agente.

Somente uma operação de sincronização de dispositivo pode estar ativa por vez para cada instância da Atualização de Dispositivo.

  1. No portal do Azure, navegue para o hub IoT.
  2. Selecione Atualizações no menu de navegação e escolha a guia Diagnóstico.
  3. Expanda a seção Exibir integridade do dispositivo.
  4. Selecione Iniciar uma sincronização de dispositivo.

Próximas etapas

Para saber mais sobre os recursos de diagnóstico da Atualização de Dispositivo, confira a visão geral do recurso de diagnóstico de atualização do dispositivo