Criar e provisionar um dispositivo do IoT Edge para Linux no Windows usando chaves simétricas

Aplica-se a: IoT Edge 1.1

Importante

IoT Edge 1.1 a data de término do suporte foi 13 de dezembro de 2022. Confira o Ciclo de Vida do Produto da Microsoft para obter informações sobre o suporte deste 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 de ponta a ponta para registrar e provisionar um dispositivo do IoT Edge para Linux no Windows dispositivo.

Cada dispositivo que se conecta a um hub IoT tem uma identidade do dispositivo que é usada para controlar as comunicações da nuvem para dispositivo ou do dispositivo para nuvem. Você configura um dispositivo com suas informações de conexão, o que inclui o nome do host do hub IoT, a identidade do dispositivo e as informações que o dispositivo usa para autenticar no Hub IoT.

As etapas neste artigo percorrem um processo chamado provisionamento manual, no qual você conecta um único dispositivo ao seu hub IoT. No provisionamento manual, você tem duas opções para autenticar dispositivos do IoT Edge:

• Chaves simétricas: quando você cria uma identidade do dispositivo no Hub IoT, o serviço cria duas chaves. Você coloca uma das chaves no dispositivo e apresenta a chave para o Hub IoT durante a autenticação.

  Esse método de autenticação é mais rápido para começar a usar, mas não tão seguro.

• X.509 autoassinado: você cria dois certificados de identidade X.509 e os coloca no dispositivo. Ao criar uma nova identidade do dispositivo no Hub IoT, você fornece impressões digitais de ambos os certificados. Quando o dispositivo é autenticado no Hub IoT, ele apresenta um certificado e o Hub IoT verifica se o certificado corresponde à sua impressão digital.

  Esse método de autenticação é mais seguro e recomendado para cenários de produção.

Este artigo aborda o uso de chaves simétricas como seu método de autenticação. Se você quiser usar certificados X.509, consulte Criar e provisionar um IoT Edge para Linux em um dispositivo Windows usando certificados X.509.

Observação

Se você tiver muitos dispositivos a serem configurados e não quiser provisionar manualmente cada um deles, use um dos artigos a seguir para saber como IoT Edge funciona com o Serviço de Provisionamento de Dispositivos no Hub IoT:

• Criar e provisionar dispositivos de Azure IoT Edge em escala usando certificados X.509
• Criar e provisionar dispositivos do IoT Edge em escala com um TPM
• Criar e provisionar dispositivos de Azure IoT Edge em escala usando chaves simétricas

Pré-requisitos

Este artigo aborda o registro do dispositivo do IoT Edge e a instalação do IoT Edge para Linux no Windows. Essas tarefas têm diferentes pré-requisitos e utilitários usados para realizá-las. Certifique-se de que você tenha todos os pré-requisitos listados antes de continuar.

Ferramentas de gerenciamento de dispositivo

Você pode usar o portal do Azure, o Visual Studio Code ou a CLI do Azure nas etapas para registrar o dispositivo. Cada utilitário tem pré-requisitos próprios:

Portal

Um hub IoT gratuito ou padrão na assinatura do Azure.

Visual Studio Code

• Um hub IoT gratuito ou padrão na assinatura do Azure
• Visual Studio Code
• Extensão do Hub IoT do Azure
• Azure IoT Edge para Visual Studio Code

CLI do Azure

• Um hub IoT gratuito ou padrão na assinatura do Azure

• CLI do Azure em seu ambiente

  No mínimo, a versão da CLI do Azure deve ser 2.0.70 ou mais recente. Use az --version para validar. Esta versão dá suporte aos comandos da extensão az e introduz a estrutura de comandos Knack.

Requisitos do dispositivo

Um dispositivo Windows com os seguintes requisitos mínimos:

• Requisitos do Sistema

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

• Requisitos de hardware

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

• Suporte à virtualização

  • No Windows 10, habilite o Hyper-V. Para obter mais informações, confira 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 mais informações, confira 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, confira: virtualização aninhada.

• Suporte à rede

  • O não Windows Server vem com um comutador padrão. Para implantar o EFLOW em um dispositivo Windows Server, crie um comutador virtual. Para obter mais informações, confira Criar um comutador virtual para Linux no Windows.
  • As versões do Windows Desktop vêm com um comutador padrão que pode ser usado para a instalação do EFLOW. Se necessário, você pode criar o seu comutador virtual personalizado.

Dica

Se você quer usar os módulos do Linux acelerados por GPU na 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 precisará de acesso a um build do Programa Windows Insider. Para determinar suas necessidades de configuração e atender a esses pré-requisitos, confira Aceleração de GPU do Azure IoT Edge para Linux no Windows.

Reserve tempo para atender aos pré-requisitos de aceleração de GPU agora. Será necessário reiniciar o processo de instalação se você decidir que deseja a aceleração de GPU durante a instalação.

Ferramentas para desenvolvedores

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

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 do 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 local machine não for AllSigned, você poderá definir a política de execução usando:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

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

Windows Admin Center

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 do Windows Admin Center do Azure IoT Edge:

1. Baixe e execute o instalador do Windows Admin Center. Siga os prompts do assistente de instalação para instalar o Windows Admin Center.

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

3. No primeiro uso do Windows Admin Center, você será solicitado a selecionar um certificado a ser usado. Selecione o 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 dashboard 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 e selecione o prompt Instalar acima da lista de extensões.

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

Registre seu dispositivo

Você pode usar o portal do Azure, o Visual Studio Code ou a CLI do Azure para registrar seu dispositivo, dependendo da preferência.

Portal

No hub IoT do portal do Azure, os dispositivos do IoT Edge são criados e gerenciados separadamente dos dispositivos de IoT que não são habilitados para a borda.

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

2. No painel esquerdo, selecione Dispositivos no menu e, em seguida, Adicionar dispositivo.

3. Na página Criar um dispositivo, forneça as seguintes informações:

   • Crie uma ID do dispositivo descritivo. Anote a identidade desse dispositivo, pois você a usará depois.
   • Marque a caixa de seleção Dispositivo do IoT Edge.
   • Selecione Chave simétrica como o tipo de autenticação.
   • Use as configurações padrão para gerar automaticamente as chaves de autenticação e conectar o novo dispositivo ao hub.

4. Clique em Salvar.

Visual Studio Code

Entre para acessar o Hub IoT

É possível usar as extensões do Azure IoT para Visual Studio Code para executar operações com o Hub IoT. Para que essas operações funcionem, é necessário entrar na conta do Azure e selecionar o hub.

1. No Visual Studio Code, abra a exibição do Explorer.

2. Na parte inferior do Explorer, expanda a seção Hub IoT.

   

3. Clique em ... no cabeçalho da seção Hub IoT. Se você não visualizar as reticências, clique ou passe o mouse sobre o cabeçalho.

4. Escolha Selecionar Hub IoT.

5. Se não estiver conectado à conta do Azure, siga as instruções para fazer isso.

6. Selecione sua assinatura do Azure.

7. Selecione seu Hub IoT.

Registrar um novo dispositivo com o Visual Studio Code

1. No Explorer do Visual Studio Code, expanda a seção Hub IoT do Azure.
2. Clique em ... no cabeçalho da seção Hub IoT. Se você não visualizar as reticências, clique ou passe o mouse sobre o cabeçalho.
3. Selecione Criar dispositivo IoT Edge.
4. Na caixa de texto que abrir, dê a seu dispositivo um ID.

Na tela de saída, você verá o resultado do comando. A informação do dispositivo é impressa, o que inclui o deviceId que você forneceu e o connectionString que você consegue usar para conectar seu dispositivo físico ao Hub IoT.

CLI do Azure

Use o comando az iot hub device-identity create para criar uma nova identidade de dispositivo no hub IoT. Por exemplo:

az iot hub device-identity create --device-id device_id_here --hub-name hub_name_here --edge-enabled

Este comando inclui três parâmetros:

• --device-id ou -d: fornece um nome descritivo exclusivo no hub IoT.

• --hub-name ou -n: fornece o nome do hub IoT.

• --edge-enabled ou --ee: declara que o dispositivo é um dispositivo do IoT Edge.

  

Agora que você tem um dispositivo registrado no Hub IoT, recupere as informações que você usa para concluir a instalação e o provisionamento do runtime do IoT Edge.

Exibir dispositivos registrados e recuperar informações de provisionamento

Os dispositivos que usam a autenticação de chave simétrica precisam de suas cadeias de conexão para concluir a instalação e o provisionamento do runtime do IoT Edge.

Portal

Todos os dispositivos habilitados para borda que se conectam ao hub IoT são listados na página Dispositivos. Você pode filtrar a lista por tipo de Dispositivo do Iot Edge.

Quando estiver pronto para configurar o dispositivo, você precisará da cadeia de conexão que vincula o dispositivo físico à identidade no hub IoT.

As cadeias de conexão dos dispositivos que se autenticam com chaves simétricas estão disponíveis para cópia no portal.

1. Na página Dispositivos no portal, selecione a identificação do dispositivo IoT Edge na lista.
2. Copie o valor da Cadeia de conexão primária ou Cadeia de conexão secundária.

Visual Studio Code

Todos os dispositivos que conectam ao seu Hub IoT estão listados na seção Azure IoT Hub do Visual Studio Code Explorer. Os dispositivos do IoT Edge são distinguidos dos dispositivos que não são de borda por um ícone diferente e pelo fato de que os módulos $edgeAgent e $edgeHub são implantados em cada dispositivo do IoT Edge.

Quando estiver pronto para configurar o dispositivo, você precisará da cadeia de conexão que vincula o dispositivo físico à identidade no hub IoT.

1. Clique com o botão direito na ID do seu dispositivo na seção Hub IoT.

2. Selecione Copiar cadeia de conexão de dispositivo.

   A cadeia de conexão é copiada à sua área de transferência.

Você também pode selecionar Pegar Informação do Dispositivo do menu de botão direito para ver todas as informações do dispositivo, incluindo a cadeia de conexão, na janela de saída.

CLI do Azure

Use o comando az iot hub device-identity list para exibir todos os dispositivos no hub IoT. Por exemplo:

az iot hub device-identity list --hub-name hub_name_here

Qualquer dispositivo registrado como um dispositivo do IoT Edge terá a propriedade capabilities.iotEdge definida para true.

Quando estiver pronto para configurar o dispositivo, você precisará da cadeia de conexão que vincula o dispositivo físico à identidade no hub IoT. Use o comando az iot hub device-identity connection-string show para retornar a cadeia de conexão para um único dispositivo:

az iot hub device-identity connection-string show --device-id [device_id] --hub-name [hub_name]

Dica

O comando connection-string show foi introduzido na versão 0.9.8 da extensão do Azure IoT, substituindo o comando show-connection-string preterido. Se você receber uma mensagem de erro ao executar esse comando, verifique se a versão da extensão está atualizada para 0.9.8 ou posterior. Para obter mais informações e as últimas atualizações, consulte Extensão do Microsoft Azure IoT para a CLI do Azure.

O valor para o parâmetro device-id diferencia maiúsculas de minúsculas.

Ao copiar a cadeia de conexão a ser usada em um dispositivo, não inclua aspas na cadeia de conexão.

Instalar o Edge IoT

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

PowerShell

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

Observação

O processo do PowerShell a seguir descreve como implantar o IoT Edge para Linux no Windows no dispositivo local. Para fazer a implantação em um dispositivo de destino remoto usando o PowerShell, use o PowerShell Remoto para estabelecer uma conexão com um dispositivo remoto e executar esses comandos remotamente no 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 em 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 no Linux e no Windows e do VHDX adicionando os parâmetros INSTALLDIR="<FULLY_QUALIFIED_PATH>" e VHDXDIR="<FULLY_QUALIFIED_PATH>" ao comando de instalação. Por exemplo, se você quiser usar a pasta D:\EFLOW para instalação e a pasta 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 definida. Confira 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 do Linux e instala o runtime do IoT Edge para você.

   Deploy-Eflow
   

   Dica

   Por padrão, o comando Deploy-Eflow cria a 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 necessários para a VM são dependem muito das cargas de trabalho implantadas. Se a VM não tiver memória suficiente para dar suporte às cargas de trabalho, ela não será iniciada.

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

   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, confira Funções do PowerShell para o IoT Edge para Linux no Windows.

   Aviso

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

   Você pode atribuir uma GPU à implantação para habilitar os módulos do Linux acelerados por GPU. Para obter acesso a esses recursos, você precisará instalar os pré-requisitos detalhados em Aceleração de GPU do 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, confira Funções do PowerShell para o 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, confira Implantar dispositivos gráficos usando a atribuição discreta de dispositivo.

5. Insira "Y" para aceitar os termos de licença.

6. Insira "O" ou "R" para ativar ou desativar Dados de diagnóstico opcionais, dependendo de sua preferência.

7. Depois que a implantação for concluída, a janela do PowerShell relatará Implantação bem-sucedida.

   

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

Windows Admin Center

Observação

A extensão Azure IoT Edge do Windows Admin Center está em versão prévia pública no momento. O processo de gerenciamento pode ser diferente dos recursos normalmente 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 que representa o computador que está executando o Windows Admin Center. Quaisquer servidores, computadores ou clusters adicionais que você gerenciar também aparecerão aqui.

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

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

   

   Se você quiser implantar em um dispositivo de destino remoto em vez de no dispositivo local e não vir o dispositivo de destino desejado na lista, siga as instruções para adicionar o dispositivo.

3. Clique em + Adicionar para começar a criar a sua implantação. A implantação cria sua máquina virtual do Linux e instala o runtime 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 gerenciar com o Windows Admin Center.

   

5. O painel Criar uma implantação do Azure IoT Edge para Linux no Windows será aberto. Na guia 1. Introdução, examine os requisitos mínimos e selecione Avançar.

6. Examine os termos de licença, marque Eu aceito e selecione Avançar.

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

8. Selecione Avançar: Implantar.

   

9. Na guia 2. Implantar, em Selecionar um dispositivo de destino, clique no dispositivo listado para validar que ele atende aos requisitos mínimos. Quando seu status for confirmado como com suporte, selecione Avançar.

   

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

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

    Observação

    O IoT Edge para Linux no Windows usa um comutador padrão, que atribui à máquina virtual do Linux um endereço IP interno. O endereço IP interno não pode ser acessado de fora do computador Windows. Você pode se conectar com a máquina virtual localmente enquanto está conectado com o computador Windows.

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

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

    Há duas opções para passagem de GPU disponíveis: DDA (Atribuição Direta de Dispositivo) e GPU-PV (Paravirtualização de GPU) , dependendo do adaptador de GPU atribuído à implantação.

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

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

    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, confira Implantar dispositivos gráficos usando a atribuição discreta de dispositivo.

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

11. Na guia 2.3 Implantação, 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 de host e configurar a máquina virtual Linux. A conclusão desse processo pode demorar vários minutos. Uma implantação bem-sucedida está exibida abaixo.

    

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

Provisionar o dispositivo com a identidade de nuvem dele

Você está pronto para configurar seu dispositivo com suas informações de autenticação e identidade de nuvem.

Para provisionar seu dispositivo usando chaves simétricas, você precisará da cadeia de conexão do dispositivo.

Você pode usar o Windows Admin Center ou uma sessão do PowerShell com privilégios elevados para provisionar seus dispositivos.

PowerShell

Execute o comando a seguir em uma sessão do PowerShell com privilégios elevados no dispositivo de destino. Substitua o texto do espaço reservado pelos seus valores.

Provision-EflowVm -provisioningType ManualConnectionString -devConnString "PASTE_DEVICE_CONNECTION_STRING_HERE"

Para obter mais informações sobre o comando Provision-EflowVM, confira Funções do PowerShell para o IoT Edge para Linux no Windows.

Windows Admin Center

1. No painel Provisionamento de dispositivos Azure IoT Edge, selecione Cadeia de conexão (manual) no menu suspenso do método de provisionamento.

2. Forneça a Cadeia de conexão do dispositivo que você recuperou do Hub IoT depois de registrar o dispositivo.

3. Selecione Provisionamento com o método selecionado.

   

4. Quando o provisionamento for concluído, selecione Concluir. Você será levado de volta ao dashboard principal. Agora, deverá aparecer um novo dispositivo listado com o tipo IoT Edge Devices. Você pode selecionar o dispositivo IoT Edge para se conectar a ele. Uma vez em sua página de Visão geral, você pode exibir a Lista de Módulos de IoT Edge e Status do IoT Edge do seu dispositivo.

Verificar configuração bem-sucedida

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

PowerShell

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

   Connect-EflowVm
   

   Observação

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

2. Depois de fazer logon, você poderá 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 de serviço do IoT Edge, use os comandos do Linux a seguir.

   1. Recupere os logs do serviço.

      sudo journalctl -u iotedge
      

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

      sudo iotedge check
      

   Observação

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

   × preparação para produção: o diretório de armazenamento do Hub do Edge é persistente no sistema de arquivos do host – erro

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

   Esse erro é esperado em um dispositivo recém-provisionado, pois o módulo do Hub do IoT Edge 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 Hub do IoT Edge.

Windows Admin Center

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

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

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

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

Quando você criar um novo dispositivo do IoT Edge, ele exibirá o código de status 417 -- The device's deployment configuration is not set no portal do Azure. Esse status é normal e significa que o dispositivo está pronto para receber uma implantação do 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 dispositivo, use os comandos a seguir.

1. Abra as Configurações no Windows
2. Selecione Adicionar ou remover programas
3. Selecione o aplicativo Azure IoT Edge LTS
4. Selecionar Desinstalar

Próximas etapas

• Prossiga para implantar módulos do IoT Edge para saber como implantar módulos em seu dispositivo.
• Saiba como gerenciar certificados em sua máquina virtual do 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 comunicar por meio de um servidor proxy.