Criar grupos de dispositivos na Atualização do Dispositivo para IoT Hub

A atualização do dispositivo para o IoT Hub permite implementar uma atualização para um grupo de dispositivos IoT.

Pré-requisitos

Adicione uma etiqueta aos seus dispositivos

A atualização do dispositivo para o IoT Hub permite implementar uma atualização para um grupo de dispositivos IoT. Para criar um grupo, o primeiro passo é adicionar uma etiqueta ao conjunto de dispositivos alvo no IoT Hub. As etiquetas só podem ser adicionadas com sucesso ao seu dispositivo depois de ter sido ligada à Atualização do Dispositivo.

A documentação abaixo descreve como adicionar e atualizar uma etiqueta.

Atualização programática Do Dispositivo Twin

Pode atualizar o Dispositivo Twin com a etiqueta apropriada utilizando o RegistryManager depois de ter matriculado o dispositivo com a Atualização do Dispositivo. Saiba como adicionar tags utilizando uma aplicação de amostra .NET.
Saiba mais sobre as propriedades da etiqueta.

Formato de etiqueta de atualização de dispositivo

     "tags": {
              "ADUGroup": "<CustomTagValue>"
             }

Utilização de Empregos

É possível agendar um Job em vários dispositivos para adicionar ou atualizar uma etiqueta de Atualização de Dispositivos seguindo estes exemplos. Pode atualizar o Dispositivo Twin ou o Módulo Twin (se o agente de atualização do dispositivo for configurado como identidade de módulo) utilizando Jobs. Saiba mais.

Nota

Esta ação vai contra a sua quota de mensagens IOT Hub atual e é aconselhável alterar apenas até 50.000 etiquetas de dispositivo ou módulo de cada vez, caso contrário poderá ter de comprar mais unidades IoT Hub se exceder a sua quota diária de mensagem IoT Hub. Os detalhes podem ser encontrados em Quotas e estrangulamento.

Atualizações diretas de twin

As etiquetas também podem ser adicionadas ou atualizadas diretamente no Device twin ou no Module Twin.

  1. Entre no portal Azure e navegue para o seu Hub IoT.

  2. A partir de 'Dispositivos IoT' ou 'IoT Edge' no painel de navegação esquerdo encontre o seu dispositivo IoT e navegue para o Dispositivo Twin, ou o Módulo de Atualização do Dispositivo e, em seguida, o seu Módulo Twin (este estará disponível se o agente de Atualização do Dispositivo estiver configurado como identidade de módulo).

  3. No Dispositivo Twin ou Módulo Twin, elimine qualquer valor de marcação de atualização do dispositivo existente, definindo-os para nulos.

  4. Adicione um novo valor de etiqueta de atualização do dispositivo, como mostrado abaixo. Exemplo dispositivo documento JSON duplo com etiquetas.

    "tags": {
            "ADUGroup": "<CustomTagValue>"
            }

Limitações

  • Pode adicionar qualquer valor à sua etiqueta, exceto "Não categorizado" que é um valor reservado.
  • O valor da etiqueta não pode exceder 255 caracteres.
  • O valor da etiqueta pode conter caracteres alfanuméricos e os seguintes caracteres especiais ".""-"_""."~".
  • Os nomes da etiqueta e do grupo são sensíveis a casos.
  • Um dispositivo só pode ter uma etiqueta com o nome ADUGroup, quaisquer adições subsequentes de uma etiqueta com esse nome irá sobrepor-se ao valor existente para o nome de etiqueta ADUGroup.
  • Um dispositivo só pode pertencer a um grupo.

Crie um grupo de dispositivos selecionando uma tag IoT Hub existente

  1. Aceda ao Portal do Azure.

  2. Selecione o Hub IoT que já ligou à sua instância de Atualização do Dispositivo.

  3. Selecione a opção Atualizações de Dispositivos sob Gestão Automática de Dispositivos a partir da barra de navegação à esquerda.

  4. Selecione o separador Grupos no topo da página. Poderá ver o número de dispositivos ligados à Atualização do Dispositivo que ainda não estão agrupados. Screenshot de dispositivos não agrupados.

  5. Selecione o botão Adicionar para criar um novo grupo. Screenshot da adição do grupo do dispositivo.

  6. Selecione uma etiqueta IoT Hub da lista e, em seguida, selecione Criar grupo de atualização. Screenshot da seleção de tags.

  7. Assim que o grupo for criado, verá que o gráfico de conformidade da atualização e a lista de grupos são atualizados. O gráfico de conformidade da atualização mostra a contagem de dispositivos em vários estados de conformidade: Na última atualização, novas atualizações disponíveis, Atualizações em Progresso e Dispositivos ainda não agrupados. Saiba mais sobre a conformidade com a atualização. Screenshot da vista de conformidade da atualização.

  8. Deverá ver o seu grupo recém-criado e quaisquer atualizações disponíveis para os dispositivos do novo grupo. Pode implementar a atualização para o novo grupo a partir desta vista clicando no nome da atualização. Ver Próximo Passo: Implementar atualização para mais detalhes.

Ver detalhes do Dispositivo para o grupo que criou

  1. Navegue para o seu grupo recém-criado e clique no nome de grupo.

  2. Será mostrada uma lista de dispositivos que fazem parte do grupo juntamente com as propriedades de atualização do dispositivo. Nesta visão, também é possível ver as informações de conformidade da atualização para todos os dispositivos que são membros do grupo. O gráfico de conformidade da atualização mostra a contagem de dispositivos em vários estados de conformidade: Na última atualização, novas atualizações disponíveis e Atualizações em Progresso. Screenshot da visualização de detalhes do grupo do dispositivo.

  3. Também pode clicar em cada dispositivo individual dentro de um grupo para ser redirecionado para a página de detalhes do dispositivo no IoT Hub. Screenshot da visualização dos detalhes do dispositivo.

Passos Seguintes

Implementar atualização

Saiba mais sobre grupos de dispositivos

Saiba mais sobre a conformidade com a atualização.