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

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

Pré-requisitos

• Acesso a um Hub IoT com a funcionalidade Atualização de Dispositivo ativada. É recomendável que você use uma camada S1 (Padrão) ou superior para seu Hub IoT.
• Um dispositivo IoT (ou simulador) provisionado para Atualização de Dispositivo num Hub IoT.
• Pelo menos uma atualização foi importada com êxito para o dispositivo provisionado.
• Instale e inicie 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 o Hub IoT permite implantar uma atualização em um grupo de dispositivos IoT. Para criar um grupo, a primeira etapa é adicionar uma tag ao conjunto de dispositivos de destino no Hub IoT. As etiquetas só podem ser adicionadas com êxito ao seu dispositivo depois de este ter sido ligado à Atualização de Dispositivo.

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

Atualizar gêmeos digitais de dispositivos programaticamente

Você pode atualizar um dispositivo gêmeo com a tag apropriada usando o RegistryManager depois de registrar o dispositivo com a Atualização de dispositivo.

• Saiba como adicionar tags usando um aplicativo .NET de exemplo.
• Saiba mais sobre as propriedades das tags.

Formato da etiqueta de Atualização de Dispositivo

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

Utilização de tarefas

Pode-se agendar um trabalho em vários dispositivos para adicionar ou atualizar uma etiqueta 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, consulte Agendar e executar tarefas.

Atualizações diretas de gêmeos

As tags também podem ser adicionadas ou atualizadas diretamente em um dispositivo gêmeo ou módulo gêmeo.

1. Entre no portal do Azure e navegue até seu 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 do gêmeo.

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

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

5. Adicione um novo valor de tag de Atualização de Dispositivo, conforme mostrado abaixo. Exemplo de documento JSON gêmeo de dispositivo com tags.

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

Limitações

• Você pode adicionar qualquer valor à sua tag, exceto 'Sem categoria', que é um valor reservado.
• O valor da tag não pode exceder 255 caracteres.
• O valor da tag pode conter caracteres alfanuméricos e os seguintes caracteres especiais ".","-","_","~".
• Os nomes de tags e grupos distinguem maiúsculas de minúsculas.
• Um dispositivo só pode ter uma tag com o nome ADUGroup, quaisquer adições subsequentes de uma tag com esse nome substituirão o valor existente para o nome da tag ADUGroup.
• Um dispositivo só pode pertencer a um Grupo.

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

1. Vai para o portal Azure.

2. Selecione o Hub IoT que você conectou anteriormente à sua 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, em seguida, selecione Criar grupo.

   

7. Depois que o grupo for criado, verás que o gráfico de conformidade de atualização e a lista de grupos serão atualizados. O gráfico de conformidade de atualizações mostra a contagem de dispositivos em vários estados de conformidade: Com a atualização mais recente, Novas atualizações disponíveis e Atualizações em progresso. Saiba mais sobre a conformidade de atualizações.

   

8. Você deve ver seu grupo recém-criado e todas 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 a partir dessa exibição clicando no botão "Implantar" ao lado do grupo. Consulte Próxima etapa: Implantar atualização para obter mais detalhes.

Ver os detalhes do dispositivo do grupo que 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 juntamente com suas propriedades de atualização de dispositivo. Nesta visualização, pode também ver as informações de conformidade de atualização 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: Atualizados para a última versão, Novas atualizações disponíveis e Atualizações em andamento.

   

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

   

Próximos passos

Implantar atualização

Saiba mais sobre grupos de dispositivos

Saiba mais sobre a conformidade de atualizações.