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

Si applica a: IoT Edge 1.1

Importante

La data di fine del supporto di IoT Edge 1.1 è 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 il provisioning automatico di uno o più IoT Edge per Linux nei dispositivi Windows usando chiavi simmetriche. È possibile effettuare automaticamente il provisioning di dispositivi Azure IoT Edge con servizio Device Provisioning in hub IoT di Azure (DPS). Se non si ha familiarità con il processo di provisioning automatico, vedere la panoramica sul provisioning prima di continuare.

Le attività sono le seguenti:

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

L'attestazione con chiave simmetrica costituisce un approccio semplice per autenticare un dispositivo con un'istanza del servizio Device Provisioning. 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 mediante un TPM o certificati X.509 è più sicura e deve essere usata per requisiti di sicurezza più rigorosi.

Prerequisiti

Risorse cloud

• Un hub IoT attivo
• Un'istanza del servizio Device Provisioning in Hub IoT in Azure, collegata all'hub IoT
  • Se non si dispone di un'istanza del servizio Device Provisioning, è possibile seguire le istruzioni riportate nelle sezioni Creare una nuova istanza del servizio Device Provisioning in hub IoT e Collegare l'hub IoT e il servizio Device Provisioning dell'argomento di avvio rapido sul servizio Device Provisioning in hub IoT.
  • Con il servizio Device Provisioning in esecuzione, copiare il valore di 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¹/11 (Pro, Enterprise, IoT Enterprise)
  • Windows Server 2019¹/2022
    _{¹ Gli utenti di Windows 10 e Windows Server 2019 devono usare la build minima 17763 con tutti gli aggiornamenti cumulativi correnti installati.}

• Requisiti hardware

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

• Supporto virtualizzazione

  • In Windows 10, abilitare Hyper-V. Per ulteriori informazioni, vedere Installare Hyper-V Server 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 è dotato di 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 desktop di Windows sono dotate di un commutatore predefinito che può essere utilizzato per l'installazione di EFLOW. Se necessario, è possibile creare un commutatore virtuale personalizzato.

Suggerimento

Se si vogliono usare moduli Linux con accelerazione GPU nella distribuzione di Azure IoT Edge per Linux in Windows, sono disponibili varie opzioni di configurazione.

Sarà necessario installare i driver corretti in base all'architettura della GPU e può essere necessario accedere a una build del Programma Windows Insider. Per determinare le esigenze di configurazione e soddisfare questi prerequisiti, vedere Accelerazione della GPU per Azure IoT Edge per Linux in Windows.

Assicurarsi di soddisfare subito i prerequisiti per l'accelerazione GPU. Se si decide per l'accelerazione GPU durante l'installazione, sarà necessario riavviare tale processo.

Strumenti di sviluppo

È 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 il criterio di esecuzione nel dispositivo di destinazione su AllSigned. È possibile controllare il criterio di esecuzione corrente in un prompt di PowerShell con privilegi elevati, usando il comando seguente:

   Get-ExecutionPolicy -List
   

   Se il criterio di esecuzione di local machine non è AllSigned, è possibile impostarlo come segue:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

Per altre informazioni sul modulo PowerShell di Azure IoT Edge per Linux in Windows, vedere le informazioni di riferimento sulle 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 Azure IoT Edge di Windows Admin Center:

1. Scaricare ed eseguire il programma di installazione di Windows Admin Center. Seguire le istruzioni dell'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 uso di Windows Admin Center, verrà richiesto di selezionare un certificato da usare. Selezionare Client di Windows Admin Center come certificato.

4. Installare l'estensione Azure IoT Edge. Selezionare l'icona a forma di ingranaggio in alto a destra nel dashboard di Windows Admin Center.

   

5. Nel menu Impostazioni, in Gateway selezionare Estensioni.

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

7. Al termine dell'installazione, azure IoT Edge verrà visualizzato 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 il servizio Device Provisioning.

Se si vuole effettuare il provisioning di un singolo dispositivo IoT Edge, creare una registrazione singola. Se è necessario effettuare il provisioning di più dispositivi, seguire la procedura per creare una registrazione di gruppo nel servizio Device Provisioning.

Quando si crea una registrazione nel servizio Device Provisioning, si ha la possibilità di dichiarare un valore di Stato iniziale 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 Device Provisioning, vedere Come gestire le registrazioni dei dispositivi.

Registrazione singola

Creare una registrazione singola nel servizio Device Provisioning

Suggerimento

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

1. Nel portale di Azure passare all'istanza del servizio Device Provisioning in hub IoT.

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. Creare un ID 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 Vero per dichiarare che la registrazione è per un dispositivo IoT Edge.

   5. Facoltativamente, aggiungere un valore di tag allo Stato iniziale 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. Seleziona Salva.

4. Copiare il valore della Chiave primaria della registrazione singola per usarlo durante l'installazione del runtime IoT Edge.

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

Registrazione di gruppo

Creare una registrazione di gruppo nel servizio Device Provisioning

Suggerimento

I passaggi descritti in questo articolo sono relativi al 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 edge-enabled per specificare che la registrazione è per dispositivi IoT Edge. Per una registrazione di gruppo, tutti i dispositivi devono essere dispositivi IoT Edge o nessuno di essi può esserlo.

1. Nel portale di Azure passare all'istanza del servizio Device Provisioning in hub IoT.

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 del gruppo.

   2. Selezionare Chiave simmetrica come tipo di attestazione.

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

   4. Facoltativamente, aggiungere un valore di tag allo Stato iniziale 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. Seleziona Salva.

4. Copiare il valore della Chiave primaria del gruppo di registrazione, necessario al momento di creare le chiavi del dispositivo da usare con una registrazione di gruppo.

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

Derivare una chiave di dispositivo

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

Per generare una chiave del dispositivo, usare la chiave copiata dal gruppo di registrazione del servizio Device Provisioning per calcolare un valore 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 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 di 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 seguente processo di PowerShell illustra come distribuire IoT Edge per Linux in Windows nel dispositivo locale. Per eseguire la distribuzione in un dispositivo di destinazione remoto tramite PowerShell, è possibile usare PowerShell remoto per stabilire una connessione a un dispositivo remoto ed eseguire questi comandi in remoto su tale 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 directory personalizzate per l'installazione di IoT Edge per Linux in Windows e per il file VHDX, semplicemente aggiungendo i parametri INSTALLDIR="<FULLY_QUALIFIED_PATH>" e VHDXDIR="<FULLY_QUALIFIED_PATH>" al comando di installazione. Ad esempio, se si vuole usare la cartella D:\EFLOW per l'installazione e la cartella D:\EFLOW-VHDX per il file VHDX, si può 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 su AllSigned il criterio di esecuzione nel dispositivo di destinazione, se l'operazione non è già stata eseguita. Vedere i prerequisiti di PowerShell per i comandi per il controllo del criterio di esecuzione corrente e impostare il criterio di esecuzione su AllSigned.

4. Creare la distribuzione di IoT Edge per Linux in Windows. La distribuzione crea la macchina virtuale Linux e installa automaticamente il runtime IoT Edge.

   Deploy-Eflow
   

   Suggerimento

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

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

   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 dispone di alcuna configurazione DNS. Le distribuzioni basate su DHCP tenteranno di ottenere la configurazione DNS propagata dal server DHCP. Per garantire l'accesso a Internet, controllare la configurazione DNS. Per altre informazioni, vedere AzEFLOW-DNS.

   È 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.

   Per usare un pass-through GPU, aggiungere i parametri gpuName, gpuPassthroughType e gpuCount al comando Deploy-Eflow. 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 per la sicurezza. Microsoft consiglia l'uso di un driver di mitigazione dei dispositivi prodotto 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 in base alle proprie preferenze.

7. Al termine della distribuzione, nella finestra di PowerShell compare l'indicazione La distribuzione è riuscita.

   

   Dopo aver completato la distribuzione, è possibile eseguire il provisioning del dispositivo.

Windows Admin Center

Nota

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

1. Installare e aprire Windows Admin Center.

   Nella pagina iniziale di Windows Admin Center, sotto l'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 Azure IoT Edge per Linux in Windows nel dispositivo locale o nei dispositivi gestiti da remoto. 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 eseguire la distribuzione 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 automaticamente il runtime IoT Edge.

4. Nel riquadro Aggiungi o crea risorse individuare il riquadro 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 al dispositivo IoT Edge esistente e gestirlo con Windows Admin Center.

   

5. Verrà aperto il riquadro Crea un'istanza di Azure IoT Edge per Linux in Windows . Sulla 1. Scheda Attività iniziali, esaminare i requisiti minimi e selezionare Avanti.

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

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

8. Selezionare Avanti: Distribuisci.

   

9. Il 2. Scheda Distribuisci, in Selezionare un dispositivo di destinazione fare clic sul dispositivo elencato per convalidarlo in base ai 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 del processo di distribuzione, sarà necessario ricominciare dall'inizio.

    Sono disponibili due opzioni per il pass-through GPU: Assegnazione diretta del dispositivo (DDA) e Paravirtualization 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 l'uso di un driver di mitigazione dei dispositivi prodotto 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 processo può richiedere alcuni minuti. Di seguito è riportata una distribuzione corretta.

    

12. Al termine della distribuzione, è possibile eseguire il provisioning del dispositivo. Selezionare Avanti: Connetti per procedere con 3. Scheda Connetti , che gestisce il provisioning dei dispositivi Azure IoT Edge.

Effettuare il provisioning del dispositivo con la relativa identità cloud

Dopo aver installato il runtime nel dispositivo, configurarlo con le informazioni da usare per connettersi al servizio Device Provisioning e all'hub IoT.

Preparare le informazioni seguenti:

• Valore Ambito ID del servizio Device Provisioning
• ID di registrazione del dispositivo creato
• Chiave primaria per una registrazione singola oppure 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 Device Provisioning di Azure IoT Edge selezionare Chiave simmetrica (DPS) dall'elenco a discesa del metodo di provisioning.

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

3. Specificare l'ID ambito dps, l'ID registrazione del dispositivo e la chiave primaria di registrazione o la chiave derivata nei campi di 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 lo stato di IoT Edge 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 singola

È 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 è assegnata e che l'ID dispositivo è elencato.

Registrazione di gruppo

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

PowerShell

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

   Connect-EflowVm
   

   Nota

   L'unico account autorizzato a connettersi tramite SSH alla macchina virtuale è quello dell'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, utilizzare i comandi Linux seguenti.

   1. Recuperare i log del servizio.

      sudo journalctl -u iotedge
      

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

      sudo iotedge check
      

   Nota

   In un dispositivo di cui è stato appena effettuato il provisioning potrebbe essere visualizzato un errore correlato all'hub di IoT Edge:

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

   Non è stati possibile controllare lo stato corrente del contenitore edgeHub

   Questo errore è previsto in un dispositivo di cui è stato appena effettuato il provisioning, perché il modulo hub di IoT Edge non è in esecuzione. Per risolvere l'errore, nell'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 hub di IoT Edge.

Windows Admin Center

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

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

   • La sezione Elenco moduli IoT Edge 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 Stato di IoT Edge mostra lo stato del servizio e deve essere attiva (in esecuzione).

Quando si crea un nuovo dispositivo IoT Edge, verrà visualizzato il codice di stato 417 -- The device's deployment configuration is not set 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

Per rimuovere l'installazione di Azure IoT Edge per Linux in Windows dal dispositivo, utilizzare i comandi seguenti.

1. Aprire 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 mentre si effettua 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 tramite il portale di Azure o usando l'interfaccia della riga di comando di Azure.

È anche possibile:

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