Creare e effettuare il provisioning di IoT Edge per Linux nei dispositivi Windows su larga scala usando chiavi simmetriche

Si applica IoT Edge 1.1

Importante

IoT Edge 1,1 data di fine del supporto è stata il 13 dicembre 2022. Controlla il ciclo di vita dei prodotti Microsoft per ottenere informazioni sul modo in cui viene supportato questo prodotto, servizio, tecnologia o API. Per altre informazioni sull'aggiornamento alla versione più recente di IoT Edge, vedere Aggiornare IoT Edge.

Questo articolo fornisce istruzioni end-to-end per la creazione automatica di uno o più IoT Edge per Linux nei dispositivi Windows usando chiavi simmetriche. È possibile effettuare automaticamente il provisioning dei dispositivi di Azure IoT Edge con il servizio di provisioning dei dispositivi hub IoT di Azure. Se non si ha familiarità con il processo di autoprovisioning, esaminare la panoramica del provisioning prima di continuare.

Le attività sono le seguenti:

1. Creare una singola registrazione per un singolo dispositivo o una registrazione di gruppo per un set di dispositivi.
2. Distribuire una macchina virtuale Linux con il runtime di IoT Edge installato e connetterlo all'hub IoT.

L'attestazione della chiave simmetrica è un approccio semplice per autenticare un dispositivo con un'istanza del servizio di provisioning del dispositivo. Questo metodo di attestazione rappresenta un'esperienza di "Hello World" per gli sviluppatori che non hanno familiarità con il provisioning dei dispositivi o che non possiedono requisiti di sicurezza restrittivi. L'attestazione del dispositivo usando un TPM o un certificato X.509 è più sicura e deve essere usata per requisiti di sicurezza più rigorosi.

Prerequisiti

Risorse cloud

• Un hub IoT attivo
• Istanza del servizio di provisioning dei dispositivi di hub IoT in Azure, collegata all'hub IoT
  • Se non si dispone di un'istanza del servizio di provisioning dei dispositivi, è possibile seguire le istruzioni riportate nella guida introduttiva Creare un nuovo servizio di provisioning dei dispositivi hub IoT e collegare l'hub IoT e le sezioni del servizio di provisioning dei dispositivi dell'hub IoT servizio di provisioning dei dispositivi.
  • Dopo aver eseguito il servizio di provisioning del dispositivo, copiare il valore dell'ambito ID dalla pagina di panoramica. Questo valore viene usato quando si configura il runtime IoT Edge.

Requisiti dei dispositivi

Un dispositivo Windows con i requisiti minimi seguenti:

• Requisiti di sistema

  • Windows 10 ^1/11 (Pro, Enterprise, IoT Enterprise)
  • Windows Server 2019¹/2022
    _{¹ Windows 10 e Windows Server 2019 build minima 17763 con tutti gli aggiornamenti cumulativi correnti installati.}

• Requisiti hardware

  • Memoria minima gratuita: 1 GB
  • Spazio su disco minimo: 10 GB

• Supporto per la virtualizzazione

  • In Windows 10 abilitare Hyper-V. Per altre informazioni, vedere Installare Hyper-V in Windows 10.
  • In Windows Server installare il ruolo Hyper-V e creare un commutatore di rete predefinito. Per altre informazioni, vedere Virtualizzazione annidata per Azure IoT Edge per Linux in Windows.
  • In una macchina virtuale configurare la virtualizzazione annidata. Per altre informazioni, vedere virtualizzazione annidata.

• Supporto per la rete

  • Windows Server non è disponibile con un commutatore predefinito. Prima di poter distribuire EFLOW in un dispositivo Windows Server, è necessario creare un commutatore virtuale. Per altre informazioni, vedere Creare un commutatore virtuale per Linux in Windows.
  • Le versioni di Windows Desktop sono disponibili con un commutatore predefinito che può essere usato per l'installazione di EFLOW. Se necessario, è possibile creare un commutatore virtuale personalizzato.

Suggerimento

Se si desidera usare moduli Linux con accelerazione GPU nella distribuzione di Azure IoT Edge per Linux in Windows, sono disponibili diverse opzioni di configurazione da considerare.

È necessario installare i driver corretti a seconda dell'architettura della GPU e potrebbe essere necessario accedere a una compilazione di Windows Insider Program. Per determinare le esigenze di configurazione e soddisfare questi prerequisiti, vedere Accelerazione GPU per Azure IoT Edge per Linux in Windows.

Assicurarsi di richiedere il tempo necessario per soddisfare i prerequisiti per l'accelerazione GPU. È necessario riavviare il processo di installazione se si decide di voler accelerare la GPU durante l'installazione.

Strumenti per sviluppatori

È possibile usare PowerShell o Windows Admin Center per gestire i dispositivi IoT Edge. Ogni utilità ha i propri prerequisiti:

PowerShell

Se si vuole usare PowerShell, seguire questa procedura per preparare il dispositivo di destinazione per l'installazione di Azure IoT Edge per Linux in Windows e la distribuzione della macchina virtuale Linux:

1. Impostare i criteri di esecuzione nel dispositivo di destinazione su AllSigned. È possibile controllare i criteri di esecuzione correnti in un prompt di PowerShell con privilegi elevati usando il comando seguente:

   Get-ExecutionPolicy -List
   

   Se il criterio di esecuzione di non AllSignedè , è possibile impostare i criteri di local machine esecuzione usando:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

Per altre informazioni sul modulo azure IoT Edge per Linux in Windows PowerShell, vedere il riferimento alle funzioni di PowerShell.

Windows Admin Center

Per usare Windows Admin Center, seguire questa procedura per scaricare e installare Windows Admin Center e installare l'estensione IoT Edge di Azure Windows Admin Center:

1. Scaricare ed eseguire il programma di installazione di Windows Admin Center. Seguire le istruzioni per l'installazione guidata per installare Windows Admin Center.

2. Dopo l'installazione, usare un browser supportato per aprire Windows Admin Center. I browser supportati includono Microsoft Edge (Windows 10, versione 1709 o successiva), Google Chrome e Microsoft Edge Insider.

3. Al primo utilizzo di Windows Admin Center verrà richiesto di selezionare un certificato da usare. Selezionare Windows Admin Center Client come certificato.

4. Installare l'estensione di Azure IoT Edge. Selezionare l'icona a forma di ingranaggio nella parte superiore destra del dashboard Windows Admin Center.

   

5. Nel menu Impostazioni , in Gateway selezionare Estensioni.

6. Nella scheda Estensioni disponibili trovare Azure IoT Edge nell'elenco delle estensioni. Sceglilo e seleziona il prompt Installa sopra l'elenco di estensioni.

7. Al termine dell'installazione, è necessario visualizzare Azure IoT Edge nell'elenco delle estensioni installate nella scheda Estensioni installate.

Creare una registrazione nel servizio Device Provisioning

Creare una registrazione per effettuare il provisioning di uno o più dispositivi tramite DPS.

Se si vuole effettuare il provisioning di un singolo dispositivo IoT Edge, creare una singola registrazione. Se sono necessari più dispositivi di cui è stato effettuato il provisioning, seguire la procedura per la creazione di una registrazione del gruppo DPS.

Quando si crea una registrazione in DPS, è possibile dichiarare uno stato iniziale del dispositivo gemello. Nel dispositivo gemello è possibile impostare tag per raggruppare i dispositivi in base a una qualsiasi metrica necessaria nella propria soluzione, come l'area, l'ambiente, la località o il tipo di dispositivo. Questi tag vengono usati per creare distribuzioni automatiche.

Per altre informazioni sulle registrazioni nel servizio di provisioning dei dispositivi, vedere Come gestire le registrazioni dei dispositivi.

Registrazione individuale

Creare una registrazione singola di DPS

Suggerimento

I passaggi descritti in questo articolo sono relativi alla portale di Azure, ma è anche possibile creare singole registrazioni usando l'interfaccia della riga di comando di Azure. Per altre informazioni, vedere az iot dps enrollment.For more information, see az iot dps enrollment. Come parte del comando dell'interfaccia della riga di comando, usare il flag abilitato per edge per specificare che la registrazione è per un dispositivo IoT Edge.

1. Nella portale di Azure passare all'istanza di hub IoT servizio di provisioning dei dispositivi.

2. In le impostazioni selezionare Gestisci registrazioni.

3. Selezionare Aggiungi registrazione singola, quindi completare la procedura seguente per configurare la registrazione:

   1. Per Meccanismo selezionare Chiave simmetrica.

   2. Specificare un ID di registrazione univoco per il dispositivo.

   3. Facoltativamente, specificare un ID dispositivo hub IoT per il dispositivo. È possibile usare gli ID dispositivo per identificare come destinazione un singolo dispositivo per la distribuzione di moduli. Se non si specifica un ID dispositivo, viene usato l'ID di registrazione.

   4. Selezionare True per dichiarare che la registrazione è per un dispositivo IoT Edge.

   5. Facoltativamente, aggiungere un valore di tag allo stato iniziale del dispositivo gemello. È possibile usare tag per identificare come destinazione gruppi di dispositivi per la distribuzione di moduli. Ad esempio:

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

   6. Selezionare Salva.

4. Copiare il valore della chiave primaria della registrazione per l'uso durante l'installazione del runtime di IoT Edge.

Ora che esiste una registrazione per questo dispositivo, il runtime di IoT Edge può effettuare automaticamente il provisioning del dispositivo durante l'installazione.

Registrazione del gruppo

Creare una registrazione del gruppo DPS

Suggerimento

I passaggi descritti in questo articolo sono relativi alla portale di Azure, ma è anche possibile creare registrazioni di gruppo usando l'interfaccia della riga di comando di Azure. Per altre informazioni, vedere az iot dps enrollment-group. Come parte del comando dell'interfaccia della riga di comando, usare il flag abilitato per i bordi per specificare che la registrazione è per i dispositivi IoT Edge. Per una registrazione del gruppo, tutti i dispositivi devono essere IoT Edge dispositivi o nessuno di essi può essere.

1. Nella portale di Azure passare all'istanza di hub IoT servizio di provisioning dei dispositivi.

2. In le impostazioni selezionare Gestisci registrazioni.

3. Selezionare Aggiungi registrazione singola, quindi completare la procedura seguente per configurare la registrazione:

   1. Specificare un nome gruppo.

   2. Selezionare Chiave simmetrica come tipo di attestazione.

   3. Selezionare True per dichiarare che la registrazione è per un dispositivo IoT Edge. Per una registrazione del gruppo, tutti i dispositivi devono essere IoT Edge dispositivi o nessuno di essi può essere.

   4. Facoltativamente, aggiungere un valore di tag allo stato iniziale del dispositivo gemello. È possibile usare tag per identificare come destinazione gruppi di dispositivi per la distribuzione di moduli. Ad esempio:

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

   5. Selezionare Salva.

4. Copiare il valore della chiave primaria del gruppo di registrazione da usare durante la creazione di chiavi del dispositivo da usare con una registrazione del gruppo.

Ora che esiste un gruppo di registrazione, il runtime di IoT Edge può effettuare automaticamente il provisioning dei dispositivi durante l'installazione.

Derivare una chiave di dispositivo

Ogni dispositivo sottoposto a provisioning come parte di una registrazione del gruppo richiede una chiave del dispositivo derivata per eseguire l'attestazione della chiave simmetrica con la registrazione durante il provisioning.

Per generare una chiave del dispositivo, usare la chiave copiata dal gruppo di registrazione DPS per calcolare un id di registrazione HMAC-SHA256 dell'ID di registrazione univoco per il dispositivo e convertire il risultato in formato Base64.

Importante

Non includere la chiave primaria o secondaria della registrazione nel codice del dispositivo.

In Windows è possibile usare PowerShell per generare la chiave del dispositivo derivata, come illustrato nell'esempio seguente.

Sostituire il valore della CHIAVE con la chiave primaria annotata in precedenza.

Sostituire il valore di REG_ID con l'ID di registrazione del 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"

Di seguito è riportato un output di esempio di una chiave del dispositivo derivata:

Jsm0lyGpjaVYVP2g3FnmnmG9dI/9qU24wNoykUmermc=

Installare IoT Edge

Distribuire Azure IoT Edge per Linux in Windows nel dispositivo di destinazione.

PowerShell

Installare IoT Edge per Linux in Windows nel dispositivo di destinazione.

Nota

Il processo di PowerShell seguente illustra come distribuire IoT Edge per Linux in Windows nel dispositivo locale. Per distribuire in un dispositivo di destinazione remota con PowerShell, è possibile usare Remote PowerShell per stabilire una connessione a un dispositivo remoto ed eseguire questi comandi in remoto nel dispositivo.

1. In una sessione di PowerShell con privilegi elevati eseguire ognuno dei comandi seguenti per scaricare IoT Edge per Linux in Windows.

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

2. Installare IoT Edge per Linux in Windows nel dispositivo.

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

   È possibile specificare IoT Edge personalizzati per Linux per l'installazione di Windows e le directory VHDX aggiungendo INSTALLDIR="<FULLY_QUALIFIED_PATH>" e VHDXDIR="<FULLY_QUALIFIED_PATH>" parametri al comando di installazione. Ad esempio, se si vuole usare la cartella D:\EFLOW per l'installazione e la D:\EFLOW-VHDX per VHDX , è possibile usare il cmdlet di PowerShell seguente.

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

3. Impostare i criteri di esecuzione nel dispositivo di destinazione su AllSigned se non è già presente. Vedere i prerequisiti di PowerShell per i comandi per controllare i criteri di esecuzione correnti e impostare i criteri di esecuzione su AllSigned.

4. Creare la IoT Edge per Linux nella distribuzione di Windows. La distribuzione crea la macchina virtuale Linux e installa il runtime di IoT Edge per l'utente.

   Deploy-Eflow
   

   Suggerimento

   Per impostazione predefinita, il Deploy-Eflow comando crea la macchina virtuale Linux con 1 GB di RAM, 1 core vCPU e 16 GB di spazio su disco. Tuttavia, le risorse necessarie per la macchina virtuale dipendono in modo elevato dai carichi di lavoro distribuiti. Se la macchina virtuale non dispone di memoria sufficiente per supportare i carichi di lavoro, non verrà avviata.

   È possibile personalizzare le risorse disponibili della macchina virtuale usando Deploy-Eflow i parametri facoltativi del comando.

   Ad esempio, il comando seguente crea una macchina virtuale con 4 core vCPU, 4 GB di RAM (rappresentati in MB) e 20 GB di spazio su disco:

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

   Per informazioni su tutti i parametri facoltativi disponibili, vedere Funzioni di PowerShell per IoT Edge per Linux in Windows.

   Avviso

   Per impostazione predefinita, la macchina virtuale EFLOW Linux non ha alcuna configurazione DNS. Le distribuzioni che usano DHCP tenteranno di ottenere la configurazione DNS propagata dal server DHCP. Controllare la configurazione DNS per garantire la connettività Internet. Per altre informazioni, vedere AzEFLOW-DNS.

   È possibile assegnare una GPU alla distribuzione per abilitare moduli Linux accelerati dalla GPU. Per ottenere l'accesso a queste funzionalità, è necessario installare i prerequisiti dettagliati nell'accelerazione GPU per Azure IoT Edge per Linux in Windows.

   Per usare un pass-through GPU, aggiungere i parametri gpuName, gpuPass throughType e gpuCount al Deploy-Eflow comando. Per informazioni su tutti i parametri facoltativi disponibili, vedere Funzioni di PowerShell per IoT Edge per Linux in Windows.

   Avviso

   L'abilitazione del pass-through del dispositivo hardware può aumentare i rischi di sicurezza. Microsoft consiglia un driver di mitigazione dei dispositivi dal fornitore della GPU, se applicabile. Per altre informazioni, vedere Distribuire dispositivi grafici usando l'assegnazione di dispositivi discreti.

5. Immettere 'Y' per accettare le condizioni di licenza.

6. Immettere 'O' o 'R' per attivare o disattivare i dati di diagnostica facoltativi , a seconda delle preferenze.

7. Al termine della distribuzione, la finestra di PowerShell segnala l'esito positivo della distribuzione.

   

   Dopo una distribuzione riuscita, è possibile effettuare il provisioning del dispositivo.

Windows Admin Center

Nota

L'estensione di Azure IoT Edge per Windows Admin Center è attualmente in anteprima pubblica. Il processo di gestione può essere diverso da quello delle funzionalità disponibili a livello generale.

1. Installare e aprire Windows Admin Center.

   Nella pagina iniziale Windows Admin Center, nell'elenco delle connessioni, verrà visualizzata una connessione host locale che rappresenta il PC in cui si esegue Windows Admin Center. Tutti i server, i PC o i cluster aggiuntivi gestiti verranno visualizzati qui.

   È possibile usare Windows Admin Center per gestire IoT Edge di Azure per Linux in Windows nel dispositivo locale o nei dispositivi gestiti remoti. In questa guida la connessione host locale fungerà da dispositivo di destinazione per la distribuzione di Azure IoT Edge per Linux in Windows.

2. Verificare che il dispositivo locale sia elencato in Tutte le connessioni, come illustrato di seguito.

   

   Se si vuole distribuire in un dispositivo di destinazione remota anziché nel dispositivo locale e non viene visualizzato il dispositivo di destinazione desiderato nell'elenco, seguire le istruzioni per aggiungere il dispositivo.

3. Selezionare + Aggiungi per iniziare a creare la distribuzione. La distribuzione crea la macchina virtuale Linux e installa il runtime di IoT Edge per l'utente.

4. Nel riquadro Aggiungi o crea risorse individuare il riquadro di Azure IoT Edge. Selezionare Crea nuovo per installare una nuova istanza di Azure IoT Edge per Linux in Windows in un dispositivo.

   Se si dispone già di IoT Edge per Linux in esecuzione in Un dispositivo, è possibile selezionare Aggiungi per connettersi a tale dispositivo IoT Edge esistente e gestirlo con Windows Admin Center.

   

5. Verrà aperto il riquadro Crea un IoT Edge di Azure per Linux in Windows. Sul 1. Introduzione scheda, esaminare i requisiti minimi e selezionare Avanti.

6. Esaminare le condizioni di licenza, selezionare Accetta e selezionare Avanti.

7. È possibile attivare o disattivare i dati di diagnostica facoltativi , a seconda delle preferenze.

8. Selezionare Avanti: Distribuire.

   

9. Sul 2. Distribuire scheda, in Selezionare un dispositivo di destinazione, fare clic sul dispositivo elencato per convalidarlo per soddisfare i requisiti minimi. Dopo aver confermato lo stato come supportato, selezionare Avanti.

   

10. Nella scheda Impostazioni 2.2 esaminare le impostazioni di configurazione della distribuzione. La tabella seguente mostra le impostazioni e i relativi valori predefiniti.

    Impostazione	Valore predefinito
    Dimensioni del disco virtuale in GB	16
    Memoria in MB (numero pari)	1024
    Numero di core	2
    Versione di Azure IoT Edge	1.1 (LTS)

    Nota

    IoT Edge per Linux in Windows usa un commutatore predefinito, che assegna alla macchina virtuale Linux un indirizzo IP interno. Questo indirizzo IP interno non può essere raggiunto dall'esterno del computer Windows. È possibile connettersi alla macchina virtuale in locale durante l'accesso al computer Windows.

    Se si usa Windows Server, configurare un'opzione predefinita prima di distribuire IoT Edge per Linux in Windows.

    È possibile assegnare una GPU alla distribuzione per abilitare i moduli Linux con accelerazione GPU. Per ottenere l'accesso a queste funzionalità, è necessario installare i prerequisiti descritti in dettaglio in Accelerazione GPU per Azure IoT Edge per Linux in Windows. Se si installano solo questi prerequisiti a questo punto nel processo di distribuzione, sarà necessario ricominciare dall'inizio.

    Sono disponibili due opzioni per il pass-through GPU: Assegnazione diretta dei dispositivi (DDA) e Paravirtualizzazione GPU (GPU-PV), a seconda dell'adattatore GPU assegnato alla distribuzione.

    Per il metodo di assegnazione diretta del dispositivo, selezionare il numero di processori GPU da allocare alla macchina virtuale Linux.

    Per il metodo di paravirtualizzazione non sono necessarie impostazioni aggiuntive.

    Avviso

    L'abilitazione del pass-through del dispositivo hardware può aumentare i rischi per la sicurezza. Microsoft consiglia un driver di mitigazione dei dispositivi dal fornitore della GPU, se applicabile. Per altre informazioni, vedere Distribuire dispositivi grafici usando l'assegnazione di dispositivi discreti.

    Dopo aver soddisfatto le impostazioni, selezionare Avanti.

11. Nella scheda Distribuzione 2.3 è possibile controllare lo stato di avanzamento della distribuzione. Il processo completo include il download del pacchetto azure IoT Edge per Linux in Windows, l'installazione del pacchetto, la configurazione del dispositivo host e la configurazione della macchina virtuale Linux. Il completamento di questo processo può richiedere alcuni minuti. Di seguito è riportata una distribuzione corretta.

    

12. Al termine della distribuzione, è possibile effettuare il provisioning del dispositivo. Selezionare Avanti: Connetti per procedere alla versione 3. Scheda Connetti, che gestisce il provisioning di dispositivi di Azure IoT Edge.

Effettuare il provisioning del dispositivo con la relativa identità cloud

Dopo aver installato il runtime nel dispositivo, configurare il dispositivo con le informazioni usate per connettersi al servizio device provisioning e hub IoT.

Preparare le informazioni seguenti:

• Valore ambito ID DPS
• ID registrazione del dispositivo creato
• Chiave primaria da una registrazione singola o una chiave derivata per i dispositivi che usano una registrazione di gruppo.

È possibile usare PowerShell o Windows Admin Center per effettuare il provisioning del dispositivo IoT Edge.

PowerShell

Per PowerShell, eseguire il comando seguente con i valori segnaposto aggiornati con i propri valori:

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

Windows Admin Center

Per Windows Admin Center, seguire questa procedura:

1. Nel riquadro Azure IoT Edge device provisioning selezionare Chiave simmetrica (DPS) nell'elenco a discesa del metodo di provisioning.

2. Nella portale di Azure passare all'istanza del servizio Device Provisioning.

3. Specificare l'ID ambito del servizio Device Provisioning, l'ID registrazione e la chiave primaria di registrazione o la chiave derivata nei campi Windows Admin Center.

4. Scegliere Provisioning con il metodo selezionato.

   

5. Al termine del provisioning, selezionare Fine. Si tornerà al dashboard principale. Verrà ora visualizzato un nuovo dispositivo elencato, il cui tipo è IoT Edge Devices. È possibile selezionare il dispositivo IoT Edge a cui connettersi. Una volta visualizzata la pagina Panoramica, è possibile visualizzare l'elenco dei moduli IoT Edge e IoT Edge stato del dispositivo.

Verificare l'esito positivo dell'installazione

Verificare che IoT Edge per Linux in Windows sia stato installato e configurato correttamente nel dispositivo IoT Edge.

Registrazione individuale

È possibile verificare che sia stata usata la registrazione singola creata nel servizio device provisioning. Passare all'istanza del servizio device provisioning nel portale di Azure. Aprire i dettagli della registrazione per la registrazione singola creata. Si noti che lo stato della registrazione viene assegnato e che l'ID dispositivo è elencato.

Registrazione del gruppo

È possibile verificare che sia stata usata la registrazione del gruppo creata nel servizio device provisioning. Passare all'istanza del servizio device provisioning nel portale di Azure. Aprire i dettagli della registrazione per la registrazione del gruppo creata. Passare alla scheda Record di registrazione per visualizzare tutti i dispositivi registrati in tale gruppo.

PowerShell

1. Accedere al IoT Edge per Linux nella macchina virtuale Windows usando il comando seguente nella sessione di PowerShell:

   Connect-EflowVm
   

   Nota

   L'unico account autorizzato a connettersi tramite SSH alla macchina virtuale è l'utente che lo ha creato.

2. Dopo aver eseguito l'accesso, è possibile controllare l'elenco dei moduli IoT Edge in esecuzione usando il comando Linux seguente:

   sudo iotedge list
   

3. Se è necessario risolvere i problemi del servizio IoT Edge, usare i comandi Linux seguenti.

   1. Recuperare i log del servizio.

      sudo journalctl -u iotedge
      

   2. Usare lo check strumento per verificare lo stato di configurazione e connessione del dispositivo.

      sudo iotedge check
      

   Nota

   In un dispositivo di cui è stato appena effettuato il provisioning, è possibile che venga visualizzato un errore correlato a IoT Edge Hub:

   × conformità alla produzione: la directory di archiviazione dell'hub Edge è persistente nel file system host - Errore

   Impossibile controllare lo stato corrente del contenitore edgeHub

   Questo errore è previsto in un dispositivo di cui è stato appena effettuato il provisioning perché il modulo IoT Edge Hub non è in esecuzione. Per risolvere l'errore, in hub IoT impostare i moduli per il dispositivo e creare una distribuzione. La creazione di una distribuzione per il dispositivo avvia i moduli nel dispositivo, incluso il modulo IoT Edge Hub.

Windows Admin Center

1. Selezionare il dispositivo IoT Edge nell'elenco dei dispositivi connessi in Windows Admin Center per connettersi.

2. La pagina di panoramica del dispositivo visualizza alcune informazioni sul dispositivo:

   • La sezione IoT Edge Module List (Elenco moduli) mostra i moduli in esecuzione nel dispositivo. Quando il servizio IoT Edge viene avviato per la prima volta, dovrebbe essere visualizzato solo il modulo edgeAgent in esecuzione. Il modulo edgeAgent viene eseguito per impostazione predefinita e permette di installare e avviare tutti i moduli aggiuntivi distribuiti nel dispositivo.

   • La sezione IoT Edge Status mostra lo stato del servizio e deve essere attiva (in esecuzione).The IoT Edge Status section shows the service status, and should be reporting active (running).

Quando si crea un nuovo dispositivo IoT Edge, il codice 417 -- The device's deployment configuration is not set di stato verrà visualizzato nel portale di Azure. Questo stato è normale e significa che il dispositivo è pronto per ricevere una distribuzione del modulo.

Disinstallare IoT Edge per Linux in Windows

Se si vuole rimuovere l'installazione di Azure IoT Edge per Linux in Windows dal dispositivo, usare i comandi seguenti.

1. Apri impostazioni in Windows
2. Selezionare Installazione applicazioni
3. Selezionare l'app Azure IoT Edge LTS
4. Selezionare Disinstalla

Passaggi successivi

Il processo di registrazione del servizio device provisioning consente di impostare l'ID dispositivo e i tag del dispositivo gemello contemporaneamente durante il provisioning del nuovo dispositivo. È possibile usare questi valori per identificare come destinazione singoli dispositivi o gruppi di dispositivi usando la gestione automatica dei dispositivi. Informazioni su come distribuire e monitorare i moduli IoT Edge su larga scala usando il portale di Azure o l'interfaccia dellariga di comando di Azure.

È anche possibile:

• Continuare a distribuire moduli IoT Edge per informazioni su come distribuire moduli nel dispositivo.
• Informazioni su come gestire i certificati nel IoT Edge per Linux in una macchina virtuale Windows e trasferire file dal sistema operativo host alla macchina virtuale Linux.
• Informazioni su come configurare i dispositivi IoT Edge per comunicare tramite un server proxy.