Criar grupos de dispositivos no Device Update para o Hub IoT

A Atualização de Dispositivo para Hub IoT permite implantar uma atualização em um grupo de dispositivos IoT.

Pré-requisitos

• Acesso a um IoT Hub com Atualização de Dispositivo para IoT Hub habilitada. É recomendável que você use uma camada S1 (Standard) ou superior para o Hub IoT.
• Um dispositivo IoT (ou simulador) provisionado para Atualização de Dispositivos dentro do Hub IoT.
• Pelo menos uma atualização foi importada com êxito para o dispositivo provisionado.
• Instalar e iniciar o agente de Atualização de Dispositivo em seu dispositivo IoT como um módulo ou identidade no nível do dispositivo

Adicionar uma etiqueta aos seus dispositivos

A Atualização de Dispositivo para Hub IoT permite implantar uma atualização em um grupo de dispositivos IoT. Para criar um grupo, a primeira etapa é adicionar uma marca ao conjunto alvo de dispositivos no Hub IoT. As tags só podem ser adicionadas com êxito ao seu dispositivo depois que ele tiver sido conectado ao Device Update.

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

Atualizar dispositivos gêmeos programaticamente

Você pode atualizar um gêmeo de dispositivo com a tag apropriada usando o "RegistryManager" após registrar o dispositivo com o "Device Update".

• Saiba como adicionar marcas usando um aplicativo .NET de exemplo.
• Saiba sobre as propriedades da tag.

Formato de etiqueta de atualização do dispositivo

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

Usando tarefas

É possível agendar uma tarefa em vários dispositivos para adicionar ou atualizar um tag de Atualização de Dispositivo. Para obter exemplos, consulte Agendar trabalhos em vários dispositivos. Você pode atualizar um dispositivo gêmeo ou módulo gêmeo (se o agente de Atualização de Dispositivo estiver configurado como uma identidade de módulo) usando tarefas. Para obter mais informações, confira Agendar e difundir trabalhos.

Atualizações de gêmeo direto

As tags também podem ser adicionadas ou atualizadas diretamente em um device twin ou module twin.

1. Entre no portal do Azure e navegue até o Hub IoT.

2. Selecione Dispositivos no menu de navegação e selecione seu dispositivo IoT para abrir os detalhes do dispositivo.

3. Abra os detalhes dos gêmeos.

   • Se o agente de Atualização de Dispositivo estiver configurado como uma identidade de dispositivo, selecione Dispositivo gêmeo.
   • Se o agente de Atualização de Dispositivo estiver configurado como uma identidade de módulo, selecione o módulo Atualização do Dispositivo e, em seguida, a identidade do módulo gêmeo.

4. No dispositivo gêmeo ou módulo gêmeo, exclua qualquer valor de marca de Atualização de Dispositivo existente definindo-o como nulo.

5. Adicione um novo valor de tag de Device Update, conforme mostrado abaixo. Exemplo de documento JSON do dispositivo gêmeo com tags.

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

Limitações

• Você pode adicionar qualquer valor à etiqueta, exceto ‘Não categorizado’, que é um valor reservado.
• O valor da tag não pode exceder 255 caracteres.
• O valor da etiqueta pode conter caracteres alfanuméricos e os seguintes caracteres especiais: ".", "-", "_", "~".
• Nomes de etiquetas e grupos são sensíveis a maiúsculas e minúsculas.
• Um dispositivo só pode ter uma etiqueta com o nome ADUGroup, qualquer adição subsequente de uma etiqueta com esse nome substituirá o valor existente da etiqueta ADUGroup.
• Um dispositivo só pode pertencer a um Grupo.

Criar um grupo de dispositivos selecionando uma marca existente do Hub IoT

1. Acesse o portal do Azure.

2. Selecione o Hub IoT que você conectou anteriormente à instância de Atualização de Dispositivo.

3. Selecione a opção Atualizações em Gerenciamento de Dispositivos na barra de navegação à esquerda.

4. Selecione a guia Grupos e Implantações na parte superior da página.

   

5. Selecione Adicionar grupo para criar um novo grupo.

   

6. Selecione uma marca do Hub IoT e uma Classe de Dispositivo na lista e selecione Criar grupo.

   

7. Depois que o grupo for criado, você verá que o gráfico de conformidade de atualização e a lista de grupos foram atualizados. O gráfico de conformidade mostra a quantidade de dispositivos em diferentes estados de conformidade: na atualização mais recente, novas atualizações disponíveis e atualizações em progresso. Saiba mais sobre a conformidade de atualização.

   

8. Você deverá ver o grupo recém-criado e as atualizações disponíveis para os dispositivos no novo grupo. Se houver dispositivos que não atendam aos requisitos de classe de dispositivo do grupo, eles aparecerão em um grupo inválido correspondente. Você pode implantar a melhor atualização disponível para o novo grupo definido pelo usuário nessa exibição clicando no botão "Implantar" ao lado do grupo. Confira a próxima etapa: implantar a atualização para obter mais detalhes.

Exibir detalhes do dispositivo para o grupo que você criou

1. Navegue até o grupo recém-criado e clique no nome do grupo.

2. Uma lista de dispositivos que fazem parte do grupo será mostrada junto com suas propriedades de atualização de dispositivo. Nessa visualização, você também pode ver as informações de conformidade de atualizações para todos os dispositivos que são membros do grupo. O gráfico de conformidade de atualização mostra a contagem de dispositivos em vários estados de conformidade: na atualização mais recente, novas atualizações disponíveis e atualizações em andamento.

   

3. Você também pode clicar em cada dispositivo individual em um grupo para ser redirecionado para a página de detalhes do dispositivo no Hub IoT.

   

Próximas etapas

Implantar Atualização

Saiba mais sobre grupos de dispositivos

Saiba mais sobre a conformidade de atualização.