Encontrar e corrigir dispositivos em falta no Device Update for Hub IoT usando a verificação do agente

Aprenda a usar a funcionalidade de verificação de agentes para encontrar, diagnosticar e corrigir dispositivos em falta na sua instância de Atualização de Dispositivo para Hub IoT.

Pré-requisitos

Note

A funcionalidade de verificação do agente só pode realizar verificações de validação em dispositivos que tenham instalado o agente Device Update e que reportem um ID de modelo PnP que corresponde aos compatíveis com o Device Update for Hub IoT.

Browsers suportados:

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

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

Verificação de validação Criteria
ID do modelo PnP O ID do modelo PnP é uma cadeia que é reportada pelo agente de Atualização de Dispositivo ao dispositivo gémeo e que descreve qual modelo PnP deve ser usado para comunicação dispositivo/cloud. Esta cadeia de caracteres deve ser um identificador de modelo de gémeo digital (DTMI) válido que seja compatível com a interface de Atualização de Dispositivos.
Interface ID O ID da interface é uma cadeia de carateres que é comunicada pelo agente de Atualização de Dispositivo ao dispositivo gémeo e que descreve que versão da interface de Atualização de Dispositivo deve ser usada na comunicação entre o dispositivo e a cloud. Esta cadeia deve ser um DTMI válido que suporte a interface Device Update.
Nomes de propriedades de compatibilidade CompatPropertyNames é um campo que o agente de Atualização de Dispositivo reporta ao dispositivo gémeo. Descreve quais os campos deviceProperties a utilizar para determinar a compatibilidade do dispositivo com uma determinada implantação. O valor deste campo deve ser uma cadeia de nomes delimitados por vírgulas. A cadeia deve conter pelo menos um e não mais do que cinco nomes. Cada nome deve ter menos de 32 caracteres.
Valores das propriedades de compatibilidade Os valores das propriedades de compatibilidade são os pares campo:valor especificados pelo campo compatPropertyNames e comunicados pelo agente do Device Update ao gémeo do dispositivo sob a forma de deviceProperties. Cada nome definido nos nomes das propriedades de compatibilidade deve ter um par campo:valor correspondente reportado. O valor de cada par está limitado a 64 caracteres.
Grupo ADU A tag ADU Group é uma tag opcional que defines no dispositivo gémeo do dispositivo. Determina a que grupo de dispositivos pertence. Se especificado, a cadeia de etiquetas está limitada a 255 caracteres e só pode conter caracteres alfanuméricos e os seguintes caracteres especiais: "." "-" "_" "~"

Se um dispositivo não cumprir algum destes critérios, pode não aparecer corretamente na Atualização do Dispositivo. Corrigir o valor inválido para cumprir os critérios especificados deve fazer com que o dispositivo apareça corretamente em Atualização do Dispositivo. Se o dispositivo não aparecer na Atualização do Dispositivo nem na verificação do agente, pode ser necessário executar a sincronização do dispositivo para resolver o problema.

Ver resultados da verificação do agente

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

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

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

A sincronização do dispositivo deve ser acionada se um dispositivo estiver 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 dispositivo pode estar ativa de cada vez para cada instância de Atualização de Dispositivo.

  1. No portal Azure, navegue até ao seu hub IoT.
  2. Selecione Atualizações no menu de navegação, depois selecione o separador Diagnósticos.
  3. Expanda a secção Ver estado do dispositivo.
  4. Selecionar Iniciar sincronização de dispositivo.

Passos seguintes

Para saber mais sobre as capacidades de diagnóstico do Device Update, consulte a visão geral das funcionalidades de diagnóstico de atualização de dispositivos

  • Última atualização a