Crie e provisione o IoT Edge para Linux em dispositivos Windows em escala usando chaves simétricas

Aplica-se a: IoT Edge 1.1

Importante

A data de fim do suporte do IoT Edge 1.1 foi 13 de dezembro de 2022. Consulte o Ciclo de Vida de Produtos da Microsoft para obter informações sobre como é suportado este produto, serviço, tecnologia ou API. Para obter mais informações sobre como atualizar para a versão mais recente do IoT Edge, consulte Atualizar o IoT Edge.

Este artigo fornece instruções completas para o provisionamento automático de um ou mais IoT Edge para Linux em dispositivos Windows usando chaves simétricas. Você pode provisionar automaticamente dispositivos do Azure IoT Edge com o serviço de provisionamento de dispositivo (DPS) do Hub IoT do Azure. Se você não estiver familiarizado com o processo de provisionamento automático, revise a visão geral do provisionamento antes de continuar.

As tarefas são as seguintes:

1. Crie um registro individual para um único dispositivo ou um registro de grupo para um conjunto de dispositivos.
2. Implante uma máquina virtual Linux com o tempo de execução do IoT Edge instalado e conecte-a ao Hub IoT.

O atestado de chave simétrica é uma abordagem simples para autenticar um dispositivo com uma instância de serviço de provisionamento de dispositivo. Esse método de atestado representa uma experiência de "Olá mundo" para desenvolvedores que são novos no provisionamento de dispositivos ou não têm requisitos de segurança rigorosos. O atestado de dispositivo usando um certificado TPM ou X.509 é mais seguro e deve ser usado para requisitos de segurança mais rigorosos.

Pré-requisitos

Recursos na nuvem

• Um hub IoT ativo
• Uma instância do serviço de provisionamento de dispositivo do Hub IoT no Azure, vinculada ao seu hub IoT
  • Se você não tiver uma instância de serviço de provisionamento de dispositivo, poderá seguir as instruções nas seções Criar um novo serviço de provisionamento de dispositivo do Hub IoT e Vincular o hub IoT e o serviço de provisionamento de dispositivo do início rápido do serviço de provisionamento de dispositivos do Hub IoT.
  • Depois de executar o serviço de provisionamento de dispositivo, copie o valor de ID Scope da página de visão geral. Você usa esse valor ao configurar o tempo de execução do IoT Edge.

Requisitos do dispositivo

Um dispositivo Windows com os seguintes requisitos mínimos:

• Requisitos de Sistema

  • Windows 10¹/11 (Pro, Enterprise, IoT Enterprise)
  • Windows Server 2019¹/2022
    _{1 Windows 10 e Windows Server 2019 compilação mínima 17763 com todas as atualizações cumulativas atuais instaladas.}

• Requisitos de Hardware

  • Memória livre mínima: 1 GB
  • Espaço livre mínimo em disco: 10 GB

• Suporte à virtualização

  • No Windows 10, habilite o Hyper-V. Para obter mais informações, consulte Instalar o Hyper-V no Windows 10.
  • No Windows Server, instale a função Hyper-V e crie um comutador de rede padrão. Para obter mais informações, consulte Virtualização aninhada para Azure IoT Edge para Linux no Windows.
  • Em uma máquina virtual, configure a virtualização aninhada. Para obter mais informações, consulte Virtualização aninhada.

• Suporte em rede

  • O Windows Server não vem com uma opção padrão. Antes de implantar o EFLOW em um dispositivo Windows Server, você precisa criar um comutador virtual. Para obter mais informações, consulte Criar comutador virtual para Linux no Windows.
  • As versões da área de trabalho do Windows vêm com uma opção padrão que pode ser usada para a instalação do EFLOW. Se necessário, você pode criar seu próprio comutador virtual personalizado.

Gorjeta

Se você quiser usar módulos Linux acelerados por GPU em sua implantação do Azure IoT Edge para Linux no Windows, há várias opções de configuração a serem consideradas.

Você precisará instalar os drivers corretos, dependendo da arquitetura da GPU, e talvez precise acessar uma compilação do Programa Windows Insider. Para determinar suas necessidades de configuração e satisfazer esses pré-requisitos, consulte Aceleração de GPU para Azure IoT Edge para Linux no Windows.

Certifique-se de dedicar um tempo para satisfazer os pré-requisitos para a aceleração da GPU agora. Você precisará reiniciar o processo de instalação se decidir que deseja a aceleração da GPU durante a instalação.

Ferramentas de programação

Você pode usar o PowerShell ou o Windows Admin Center para gerenciar seus dispositivos IoT Edge. Cada utilitário tem seus próprios pré-requisitos:

PowerShell

Se você quiser usar o PowerShell, use as seguintes etapas para preparar seu dispositivo de destino para a instalação do Azure IoT Edge para Linux no Windows e a implantação da máquina virtual Linux:

1. Defina a política de execução no dispositivo de destino como AllSigned. Você pode verificar a política de execução atual em um prompt do PowerShell com privilégios elevados usando o seguinte comando:

   Get-ExecutionPolicy -List
   

   Se a política de execução do não AllSignedfor , você poderá definir a política de local machine execução usando:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

Para obter mais informações sobre o módulo Azure IoT Edge para Linux no Windows PowerShell, consulte a referência de funções do PowerShell.

Centro de Administração do Windows

Se você quiser usar o Windows Admin Center, use as seguintes etapas para baixar e instalar o Windows Admin Center e instalar a extensão Windows Admin Center Azure IoT Edge:

1. Transfira e execute o instalador do Windows Admin Center. Siga as instruções do assistente de instalação para instalar o Windows Admin Center.

2. Uma vez instalado, use um navegador compatível para abrir o Windows Admin Center. Os navegadores suportados incluem o Microsoft Edge (Windows 10, versão 1709 ou posterior), o Google Chrome e o Microsoft Edge Insider.

3. Na primeira utilização do Windows Admin Center, ser-lhe-á pedido para selecionar um certificado a utilizar. Selecione Cliente do Windows Admin Center como seu certificado.

4. Instale a extensão Azure IoT Edge. Selecione o ícone de engrenagem no canto superior direito do painel do Windows Admin Center.

   

5. No menu Configurações, em Gateway, selecione Extensões.

6. Na guia Extensões disponíveis, localize Azure IoT Edge na lista de extensões. Escolha-o e selecione o prompt de instalação acima da lista de extensões.

7. Após a conclusão da instalação, você verá o Azure IoT Edge na lista de extensões instaladas na guia Extensões instaladas .

Criar um registro DPS

Crie um registro para provisionar um ou mais dispositivos por meio do DPS.

Se você deseja provisionar um único dispositivo IoT Edge, crie um registro individual. Se você precisar de vários dispositivos provisionados, siga as etapas para criar um registro de grupo DPS.

Ao criar um registro no DPS, você tem a oportunidade de declarar um estado gêmeo inicial do dispositivo. No gêmeo de dispositivo, você pode definir tags para agrupar dispositivos por qualquer métrica necessária em sua solução, como região, ambiente, local ou tipo de dispositivo. Essas tags são usadas para criar implantações automáticas.

Para obter mais informações sobre inscrições no serviço de provisionamento de dispositivos, consulte Como gerenciar registros de dispositivos.

Inscrição individual

Criar uma inscrição individual do DPS

Gorjeta

As etapas neste artigo são para o portal do Azure, mas você também pode criar inscrições individuais usando a CLI do Azure. Para obter mais informações, consulte az iot dps enrollment. Como parte do comando CLI, use o sinalizador habilitado para borda para especificar que o registro é para um dispositivo IoT Edge.

1. No portal do Azure, navegue até sua instância do serviço de provisionamento de dispositivo do Hub IoT.

2. Em Configurações, selecione Gerenciar inscrições.

3. Selecione Adicionar inscrição individual e conclua as seguintes etapas para configurar o registro:

   1. Em Mecanismo, selecione Chave simétrica.

   2. Forneça um ID de registo exclusivo para o seu dispositivo.

   3. Opcionalmente, forneça um ID de dispositivo do Hub IoT para o seu dispositivo. Você pode usar IDs de dispositivo para direcionar um dispositivo individual para implantação de módulo. Se você não fornecer um ID de dispositivo, o ID de registro será usado.

   4. Selecione True para declarar que o registro é para um dispositivo IoT Edge.

   5. Opcionalmente, adicione um valor de tag ao estado gêmeo inicial do dispositivo. Você pode usar tags para segmentar grupos de dispositivos para implantação de módulos. Por exemplo:

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   6. Selecione Guardar.

4. Copie o valor da Chave Primária do registro individual para usar ao instalar o tempo de execução do IoT Edge.

Agora que existe um registro para esse dispositivo, o tempo de execução do IoT Edge pode provisionar automaticamente o dispositivo durante a instalação.

Inscrição em grupo

Criar um registro de grupo DPS

Gorjeta

As etapas neste artigo são para o portal do Azure, mas você também pode criar inscrições de grupo usando a CLI do Azure. Para obter mais informações, consulte az iot dps enrollment-group. Como parte do comando CLI, use o sinalizador habilitado para borda para especificar que o registro é para dispositivos IoT Edge. Para um registro de grupo, todos os dispositivos devem ser dispositivos IoT Edge ou nenhum deles pode ser.

1. No portal do Azure, navegue até sua instância do serviço de provisionamento de dispositivo do Hub IoT.

2. Em Configurações, selecione Gerenciar inscrições.

3. Selecione Adicionar inscrição individual e conclua as seguintes etapas para configurar o registro:

   1. Forneça um nome de grupo.

   2. Selecione Chave simétrica como o tipo de atestado.

   3. Selecione True para declarar que o registro é para um dispositivo IoT Edge. Para um registro de grupo, todos os dispositivos devem ser dispositivos IoT Edge ou nenhum deles pode ser.

   4. Opcionalmente, adicione um valor de tag ao estado gêmeo inicial do dispositivo. Você pode usar tags para segmentar grupos de dispositivos para implantação de módulos. Por exemplo:

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   5. Selecione Guardar.

4. Copie o valor da Chave Primária do seu grupo de inscrição para usar ao criar chaves de dispositivo para uso com um registro de grupo.

Agora que existe um grupo de registro, o tempo de execução do IoT Edge pode provisionar dispositivos automaticamente durante a instalação.

Derivar uma chave de dispositivo

Cada dispositivo provisionado como parte de um registro de grupo precisa de uma chave de dispositivo derivada para executar o atestado de chave simétrica com o registro durante o provisionamento.

Para gerar uma chave de dispositivo, use a chave que você copiou do seu grupo de registro DPS para calcular um HMAC-SHA256 do ID de registro exclusivo para o dispositivo e converter o resultado no formato Base64.

Importante

Não inclua a chave primária ou secundária do seu registro no código do dispositivo.

No Windows, você pode usar o PowerShell para gerar sua chave de dispositivo derivada, conforme mostrado no exemplo a seguir.

Substitua o valor de KEY pela Chave Primária que você anotou anteriormente.

Substitua o valor de REG_ID pelo ID de registo do dispositivo.

$KEY='PASTE_YOUR_ENROLLMENT_KEY_HERE'
$REG_ID='PASTE_YOUR_REGISTRATION_ID_HERE'

$hmacsha256 = New-Object System.Security.Cryptography.HMACSHA256
$hmacsha256.key = [Convert]::FromBase64String($KEY)
$sig = $hmacsha256.ComputeHash([Text.Encoding]::ASCII.GetBytes($REG_ID))
$derivedkey = [Convert]::ToBase64String($sig)
echo "`n$derivedkey`n"

Abaixo está uma saída de exemplo de uma chave de dispositivo derivada:

Jsm0lyGpjaVYVP2g3FnmnmG9dI/9qU24wNoykUmermc=

Instalar o IoT Edge

Implante o Azure IoT Edge para Linux no Windows em seu dispositivo de destino.

PowerShell

Instale o IoT Edge para Linux no Windows no seu dispositivo de destino.

Nota

O processo PowerShell a seguir descreve como implantar o IoT Edge para Linux no Windows no dispositivo local. Para implantar em um dispositivo de destino remoto usando o PowerShell, você pode usar o PowerShell Remoto para estabelecer uma conexão com um dispositivo remoto e executar esses comandos remotamente nesse dispositivo.

1. Em uma sessão do PowerShell com privilégios elevados, execute cada um dos comandos a seguir para baixar o IoT Edge para Linux no Windows.

   $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
   $ProgressPreference = 'SilentlyContinue'
   Invoke-WebRequest "https://aka.ms/AzEflowMSI" -OutFile $msiPath
   

2. Instale o IoT Edge para Linux no Windows no seu dispositivo.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"
   

   Você pode especificar diretórios personalizados de instalação do IoT Edge para Linux no Windows e VHDX adicionando INSTALLDIR="<FULLY_QUALIFIED_PATH>" parâmetros e VHDXDIR="<FULLY_QUALIFIED_PATH>" ao comando install. Por exemplo, se você quiser usar a pasta D:\EFLOW para instalação e D :\EFLOW-VHDX para o VHDX, poderá usar o seguinte cmdlet do PowerShell.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn","INSTALLDIR=D:\EFLOW", "VHDXDIR=D:\EFLOW-VHDX"
   

3. Defina a política de execução no dispositivo de destino como AllSigned se ainda não estiver. Consulte os pré-requisitos do PowerShell para comandos para verificar a política de execução atual e definir a política de execução como AllSigned.

4. Crie a implantação do IoT Edge para Linux no Windows. A implantação cria sua máquina virtual Linux e instala o tempo de execução do IoT Edge para você.

   Deploy-Eflow
   

   Gorjeta

   Por padrão, o Deploy-Eflow comando cria sua máquina virtual Linux com 1 GB de RAM, 1 núcleo vCPU e 16 GB de espaço em disco. No entanto, os recursos de que sua VM precisa dependem muito das cargas de trabalho implantadas. Se sua VM não tiver memória suficiente para suportar suas cargas de trabalho, ela não será iniciada.

   Você pode personalizar os recursos disponíveis da máquina virtual usando os Deploy-Eflow parâmetros opcionais do comando.

   Por exemplo, o comando abaixo cria uma máquina virtual com 4 núcleos vCPU, 4 GB de RAM (representados em MB) e 20 GB de espaço em disco:

   Deploy-Eflow -cpuCount 4 -memoryInMB 4096 -vmDiskSize 20
   

   Para obter informações sobre todos os parâmetros opcionais disponíveis, consulte Funções do PowerShell para IoT Edge para Linux no Windows.

   Aviso

   Por padrão, a máquina virtual EFLOW Linux não tem configuração de DNS. As implantações usando DHCP tentarão obter a configuração DNS propagada pelo servidor DHCP. Verifique a configuração do DNS para garantir a conectividade com a Internet. Para obter mais informações, consulte AzEFLOW-DNS.

   Você pode atribuir uma GPU à sua implantação para habilitar módulos Linux acelerados por GPU. Para obter acesso a esses recursos, você precisará instalar os pré-requisitos detalhados em Aceleração de GPU para o Azure IoT Edge para Linux no Windows.

   Para usar uma passagem de GPU, adicione os parâmetros gpuName, gpuPassthroughType e gpuCount ao comando Deploy-Eflow . Para obter informações sobre todos os parâmetros opcionais disponíveis, consulte Funções do PowerShell para IoT Edge para Linux no Windows.

   Aviso

   Habilitar a passagem de dispositivo de hardware pode aumentar os riscos de segurança. A Microsoft recomenda um driver de mitigação de dispositivo do fornecedor da GPU, quando aplicável. Para obter mais informações, consulte Implantar dispositivos gráficos usando atribuição de dispositivo discreto.

5. Digite 'Y' para aceitar os termos da licença.

6. Digite 'O' ou 'R' para ativar ou desativar os dados de diagnóstico opcionais, dependendo da sua preferência.

7. Quando a implantação estiver concluída, a janela do PowerShell relatará a implantação bem-sucedida.

   

   Após uma implantação bem-sucedida, você estará pronto para provisionar seu dispositivo.

Centro de Administração do Windows

Nota

A extensão do Azure IoT Edge para Windows Admin Center está atualmente em visualização pública. O processo de gerenciamento pode ser diferente do que para recursos geralmente disponíveis.

1. Instale e abra o Windows Admin Center.

   Na página inicial do Windows Admin Center, na lista de conexões, você verá uma conexão de host local representando o computador onde você está executando o Windows Admin Center. Quaisquer servidores, PCs ou clusters adicionais que você gerencia também aparecerão aqui.

   Você pode usar o Windows Admin Center para gerenciar o Azure IoT Edge para Linux no Windows em seu dispositivo local ou em dispositivos gerenciados remotamente. Neste guia, a conexão de host local servirá como o dispositivo de destino para a implantação do Azure IoT Edge para Linux no Windows.

2. Confirme se o seu dispositivo local está listado em Todas as ligações, como mostrado abaixo.

   

   Se pretender implementar num dispositivo de destino remoto em vez do dispositivo local e não vir o dispositivo de destino pretendido na lista, siga as instruções para adicionar o dispositivo.

3. Selecione + Adicionar para começar a criar sua implantação. A implantação cria sua máquina virtual Linux e instala o tempo de execução do IoT Edge para você.

4. No painel Adicionar ou criar recursos, localize o bloco Azure IoT Edge. Selecione Criar novo para instalar uma nova instância do Azure IoT Edge para Linux no Windows em um dispositivo.

   Se você já tiver o IoT Edge para Linux no Windows em execução em um dispositivo, poderá selecionar Adicionar para se conectar a esse dispositivo IoT Edge existente e gerenciá-lo com o Windows Admin Center.

   

5. O painel de implantação Criar um Azure IoT Edge para Linux no Windows será aberto. No 1. Guia Introdução, revise os requisitos mínimos e selecione Avançar.

6. Reveja os termos da licença, marque Aceito e selecione Seguinte.

7. Você pode ativar ou desativar os dados de diagnóstico opcionais, dependendo da sua preferência.

8. Selecione Next: Deploy.

   

9. No dia 2. Guia Implantar, em Selecione um dispositivo de destino, clique no dispositivo listado para validar que ele atende aos requisitos mínimos. Quando o seu estado for confirmado como suportado, selecione Seguinte.

   

10. Na guia Configurações 2.2, revise as definições de configuração de sua implantação. A tabela abaixo mostra as configurações e seus valores padrão.

    Definição	Default value
    Tamanho do disco virtual em GB	16
    Memória em MB (número par)	1024
    Número de núcleos	2
    Versão do Azure IoT Edge	1.1 (LTS)

    Nota

    O IoT Edge para Linux no Windows usa um switch padrão, que atribui à máquina virtual Linux um endereço IP interno. Este endereço IP interno não pode ser alcançado de fora da máquina Windows. Você pode se conectar à máquina virtual localmente enquanto estiver conectado à máquina Windows.

    Se você estiver usando o Windows Server, configure um switch padrão antes de implantar o IoT Edge para Linux no Windows.

    Você pode atribuir uma GPU à sua implantação para habilitar módulos Linux acelerados por GPU. Para obter acesso a esses recursos, você precisará instalar os pré-requisitos detalhados em Aceleração de GPU para o Azure IoT Edge para Linux no Windows. Se você estiver instalando apenas esses pré-requisitos neste ponto do processo de implantação, precisará começar novamente desde o início.

    Há duas opções de passagem de GPU disponíveis: Direct Device Assignment (DDA) e GPU Paravirtualization (GPU-PV), dependendo do adaptador de GPU atribuído à sua implantação.

    Para o método de atribuição direta de dispositivos, selecione o número de processadores GPU a serem alocados para sua máquina virtual Linux.

    Para o método de paravirtualização, nenhuma configuração adicional é necessária.

    Aviso

    Habilitar a passagem de dispositivo de hardware pode aumentar os riscos de segurança. A Microsoft recomenda um driver de mitigação de dispositivo do fornecedor da GPU, quando aplicável. Para obter mais informações, consulte Implantar dispositivos gráficos usando atribuição de dispositivo discreto.

    Quando estiver satisfeito com as configurações, selecione Avançar.

11. Na guia Implantação 2.3, você pode observar o progresso da implantação. O processo completo inclui baixar o pacote do Azure IoT Edge para Linux no Windows, instalar o pacote, configurar o dispositivo host e configurar a máquina virtual Linux. Este processo pode levar vários minutos para ser concluído. Uma implantação bem-sucedida é mostrada abaixo.

    

12. Quando a implantação estiver concluída, você estará pronto para provisionar seu dispositivo. Selecione Next: Connect para prosseguir para o 3. Guia Conectar , que lida com o provisionamento de dispositivos do Azure IoT Edge.

Provisionar o dispositivo com sua identidade na nuvem

Depois que o tempo de execução estiver instalado em seu dispositivo, configure o dispositivo com as informações que ele usa para se conectar ao serviço de provisionamento do dispositivo e ao Hub IoT.

Tenha as seguintes informações prontas:

• O valor DPS ID Scope
• O ID de registo do dispositivo que criou
• A Chave Primária de um registro individual ou uma chave derivada para dispositivos que usam um registro de grupo.

Você pode usar o PowerShell ou o Windows Admin Center para provisionar seu dispositivo IoT Edge.

PowerShell

Para o PowerShell, execute o seguinte comando com os valores de espaço reservado atualizados com seus próprios valores:

Provision-EflowVm -provisioningType DpsSymmetricKey -​scopeId PASTE_YOUR_ID_SCOPE_HERE -registrationId PASTE_YOUR_REGISTRATION_ID_HERE -symmKey PASTE_YOUR_PRIMARY_KEY_OR_DERIVED_KEY_HERE

Centro de Administração do Windows

Para o Windows Admin Center, use as seguintes etapas:

1. No painel de provisionamento de dispositivo do Azure IoT Edge, selecione Chave Simétrica (DPS) na lista suspensa do método de provisionamento.

2. No portal do Azure, navegue até sua instância do DPS.

3. Forneça sua ID de escopo do DPS, ID de registro do dispositivo e chave primária de registro ou chave derivada nos campos do Windows Admin Center.

4. Escolha Provisionamento com o método selecionado.

   

5. Quando o provisionamento estiver concluído, selecione Concluir. Você será levado de volta ao painel principal. Agora, você deve ver um novo dispositivo listado, cujo tipo é IoT Edge Devices. Você pode selecionar o dispositivo IoT Edge para se conectar a ele. Uma vez na página Visão geral, você pode visualizar a Lista de módulos do IoT Edge e o Status do IoT Edge do seu dispositivo.

Verificar se a instalação foi bem-sucedida

Verifique se o IoT Edge para Linux no Windows foi instalado e configurado com êxito no seu dispositivo IoT Edge.

Inscrição individual

Você pode verificar se o registro individual criado no serviço de provisionamento de dispositivo foi usado. Navegue até a instância do serviço de provisionamento de dispositivo no portal do Azure. Abra os detalhes de inscrição para o registro individual que você criou. Observe que o status do registro é atribuído e o ID do dispositivo está listado.

Inscrição em grupo

Você pode verificar se o registro de grupo criado no serviço de provisionamento de dispositivo foi usado. Navegue até a instância do serviço de provisionamento de dispositivo no portal do Azure. Abra os detalhes de inscrição para o registro de grupo que você criou. Aceda ao separador Registos de Registo para ver todos os dispositivos registados nesse grupo.

PowerShell

1. Faça login na máquina virtual do IoT Edge para Linux no Windows usando o seguinte comando na sessão do PowerShell:

   Connect-EflowVm
   

   Nota

   A única conta permitida para SSH para a máquina virtual é o usuário que a criou.

2. Depois de fazer login, você pode verificar a lista de módulos do IoT Edge em execução usando o seguinte comando do Linux:

   sudo iotedge list
   

3. Se você precisar solucionar problemas do serviço IoT Edge, use os seguintes comandos do Linux.

   1. Recupere os logs de serviço.

      sudo journalctl -u iotedge
      

   2. Use a ferramenta para verificar a configuração e o check status da conexão do dispositivo.

      sudo iotedge check
      

   Nota

   Em um dispositivo recém-provisionado, você pode ver um erro relacionado ao IoT Edge Hub:

   × prontidão para produção: o diretório de armazenamento do Edge Hub é mantido no sistema de arquivos host - Erro

   Não foi possível verificar o estado atual do contêiner edgeHub

   Esse erro é esperado em um dispositivo recém-provisionado porque o módulo IoT Edge Hub não está em execução. Para resolver o erro, no Hub IoT, defina os módulos para o dispositivo e crie uma implantação. A criação de uma implantação para o dispositivo inicia os módulos no dispositivo, incluindo o módulo IoT Edge Hub.

Centro de Administração do Windows

1. Selecione seu dispositivo IoT Edge na lista de dispositivos conectados no Windows Admin Center para se conectar a ele.

2. A página de visão geral do dispositivo exibe algumas informações sobre o dispositivo:

   • A seção Lista de Módulos do IoT Edge mostra os módulos em execução no dispositivo. Quando o serviço IoT Edge for iniciado pela primeira vez, você verá apenas o módulo edgeAgent em execução. O módulo edgeAgent é executado por padrão e ajuda a instalar e iniciar quaisquer módulos adicionais que você implantar em seu dispositivo.

   • A seção Status da Borda IoT mostra o status do serviço e deve estar relatando ativo (em execução).

Quando você cria um novo dispositivo IoT Edge, ele exibirá o código 417 -- The device's deployment configuration is not set de status no portal do Azure. Esse status é normal e significa que o dispositivo está pronto para receber uma implantação de módulo.

Desinstalar o IoT Edge para Linux no Windows

Se você quiser remover a instalação do Azure IoT Edge para Linux no Windows do seu dispositivo, use os comandos a seguir.

1. Abrir Definições no Windows
2. Selecione Adicionar ou remover programas
3. Selecione o aplicativo Azure IoT Edge LTS
4. Selecione Desinstalar

Próximos passos

O processo de registro do serviço de provisionamento de dispositivos permite definir a ID do dispositivo e as tags gêmeas do dispositivo ao mesmo tempo em que provisiona o novo dispositivo. Você pode usar esses valores para segmentar dispositivos individuais ou grupos de dispositivos usando o gerenciamento automático de dispositivos. Saiba como Implantar e monitorar módulos do IoT Edge em escala usando o portal do Azure ou usando a CLI do Azure.

Também pode:

• Continue a implantar módulos do IoT Edge para saber como implantar módulos em seu dispositivo.
• Saiba como gerenciar certificados em sua máquina virtual IoT Edge para Linux no Windows e transferir arquivos do sistema operacional host para sua máquina virtual Linux.
• Saiba como configurar seus dispositivos IoT Edge para se comunicarem por meio de um servidor proxy.