Localizar e corrigir dispositivos em falta na Atualização do Dispositivo para Hub IoT usando a verificação do agente

Saiba como utilizar a função de verificação do agente para encontrar, diagnosticar e corrigir dispositivos em falta na atualização do dispositivo para Hub IoT exemplo.

Pré-requisitos

Nota

A função de verificação do agente só pode efetuar verificações de validação em dispositivos que tenham o agente de Atualização do Dispositivo instalado e estão a reportar um ID do modelo PnP que corresponda aos compatíveis com a Atualização do Dispositivo para Hub IoT.

Navegadores suportados:

Verificações de validação suportadas pela verificação do agente

A função de verificação do agente realiza atualmente as seguintes verificações de validação em todos os dispositivos que satisfaçam os pré-requisitos acima referidos.

Verificação de validação Critérios
ID do modelo PnP O ID do modelo PnP é uma cadeia que é reportada pelo agente de Atualização do Dispositivo ao twin do dispositivo que descreve o modelo PnP que deve ser usado para a comunicação dispositivo/nuvem. Este string deve ser um identificador de modelos duplos digitais válido (DTMI) que suporta a interface de Atualização do Dispositivo.
Interface ID O ID da interface é uma cadeia que é reportada pelo agente de Atualização do Dispositivo ao dispositivo gémeo que descreve qual a versão de interface de Atualização de Dispositivos deve ser usada para comunicação dispositivo/nuvem. Este fio deve ser um DTMI válido que suporte a interface de Atualização do Dispositivo.
Nomes de propriedade de compatibilidade CompatPropertyNames é um campo relatado pelo agente de Atualização de Dispositivos ao twin do dispositivo que descreve quais os campos devem deviceProperties ser utilizados para determinar a compatibilidade do dispositivo com uma determinada implantação. O valor deste campo deve ser uma série de nomes delimitados por vírgula. A corda deve conter pelo menos um e não mais de cinco nomes. Cada nome deve ter <32 caracteres.
Valores de propriedade de compatibilidade Os valores de propriedade de compatibilidade são os pares de valor do campo especificados pelo compatPropertyNames campo e reportados pelo agente de Atualização do Dispositivo ao dispositivo twin como deviceProperties. Todos os nomes definidos em nomes de propriedade de compatibilidade devem ter um campo correspondente:par de valor relatado. O valor para cada par é limitado a 64 caracteres.
Grupo ADU A etiqueta do Grupo ADU é uma etiqueta opcional que é definida no dispositivo twin do dispositivo e determina a que dispositivo pertence o dispositivo. Se especificado, a corda da etiqueta é limitada a 255 caracteres e só pode conter caracteres alfanuméricos e os seguintes caracteres especiais: "." "-" "_" "~"

Se um dispositivo falhar qualquer um destes critérios, pode não aparecer corretamente na Atualização do Dispositivo. A correção do valor inválido para satisfazer os critérios especificados deve fazer com que o dispositivo apareça corretamente na Atualização do Dispositivo. Se o dispositivo não aparecer na Atualização do Dispositivo nem na verificação do agente, poderá ter de executar sincronização do dispositivo para resolver o problema.

Ver resultados de verificação de agente

Os resultados da verificação do agente podem ser encontrados no separador de diagnóstico da Atualização do Dispositivo.

  1. No portal do Azure, navegue até ao seu hub IoT.
  2. Selecione Atualizações no menu de navegação e, em seguida, selecione o separador Diagnósticos.
  3. Expandir a secção de dispositivos em falta .

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

A sincronização do dispositivo deve ser ativada se um dispositivo tiver sido registado no hub IoT, mas não aparecer na Atualização do Dispositivo nem nos resultados da verificação do agente.

Apenas uma operação de sincronização de dispositivos pode estar ativa de cada vez para cada instância de Atualização do Dispositivo.

  1. No portal do Azure, navegue até ao seu hub IoT.
  2. Selecione Atualizações no menu de navegação e, em seguida, selecione o separador Diagnósticos.
  3. Expandir a secção de saúde do dispositivo Ver.
  4. Selecione Iniciar uma sincronização do dispositivo.

Passos seguintes

Para saber mais sobre as capacidades de diagnóstico da Atualização do Dispositivo, consulte a visão geral da funcionalidade de diagnóstico da atualização do dispositivo