Creare e effettuare il provisioning di un IoT Edge per Linux nel dispositivo Windows 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 registrazione e il provisioning di un IoT Edge per Linux nel dispositivo Windows.

Ogni dispositivo che si connette a un hub IoT ha un ID dispositivo usato per tenere traccia delle comunicazioni da cloud a dispositivo o da dispositivo a cloud. Si configura un dispositivo con le relative informazioni di connessione, che include il nome host dell'hub IoT, l'ID dispositivo e le informazioni usate dal dispositivo per eseguire l'autenticazione in hub IoT.

I passaggi descritti in questo articolo illustrano un processo denominato provisioning manuale, in cui si connette un singolo dispositivo all'hub IoT. Per il provisioning manuale, sono disponibili due opzioni per l'autenticazione dei dispositivi IoT Edge:

• Chiavi simmetriche: quando si crea una nuova identità del dispositivo in hub IoT, il servizio crea due chiavi. Si inserisce una delle chiavi nel dispositivo e presenta la chiave per hub IoT durante l'autenticazione.

  Questo metodo di autenticazione è più veloce per iniziare, ma non come sicuro.

• X.509 autofirmato: si creano due certificati di identità X.509 e li inseriscono nel dispositivo. Quando si crea una nuova identità del dispositivo in hub IoT, si forniscono identificazioni personali da entrambi i certificati. Quando il dispositivo esegue l'autenticazione a hub IoT, presenta un certificato e hub IoT verifica che il certificato corrisponda all'identificazione personale.

  Questo metodo di autenticazione è più sicuro e consigliato per gli scenari di produzione.

Questo articolo illustra l'uso di chiavi simmetriche come metodo di autenticazione. Per usare i certificati X.509, vedere Creare e effettuare il provisioning di un IoT Edge per Linux nel dispositivo Windows usando certificati X.509.

Nota

Se si dispone di molti dispositivi per configurare e non si vuole effettuare manualmente il provisioning di ognuno di essi, usare uno degli articoli seguenti per informazioni su come IoT Edge funziona con il servizio di provisioning dei dispositivi hub IoT:

• Creare e effettuare il provisioning di dispositivi IoT Edge su larga scala usando certificati X.509
• Creare e effettuare il provisioning di dispositivi IoT Edge su larga scala con un TPM
• Creare e effettuare il provisioning di dispositivi IoT Edge su larga scala usando chiavi simmetriche

Prerequisiti

Questo articolo illustra la registrazione del dispositivo IoT Edge e l'installazione di IoT Edge per Linux in Windows. Queste attività hanno prerequisiti e utilità diversi usati per eseguirli. Assicurarsi di disporre di tutti i prerequisiti coperti prima di procedere.

Strumenti di gestione dei dispositivi

È possibile usare l'portale di Azure, Visual Studio Code o l'interfaccia della riga di comando di Azure per la procedura per registrare il dispositivo. Ogni utilità ha i propri prerequisiti:

Portale

Un hub IoT gratuito o standard nella sottoscrizione di Azure.

Visual Studio Code

• Hub IoT gratuito o standard nella sottoscrizione di Azure
• Visual Studio Code
• estensione hub IoT di Azure
• IoT Edge di Azure per Visual Studio Code

Interfaccia della riga di comando di Azure

• Hub IoT gratuito o standard nella sottoscrizione di Azure

• Interfaccia della riga di comando di Azure nell'ambiente

  Almeno, la versione dell'interfaccia della riga di comando di Azure deve essere 2.0.70 o successiva. Usare il comando az --version per verificare. Questa versione supporta i comandi dell'estensione az e introduce il framework dei comandi Knack.

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.

Registrazione del dispositivo

È possibile usare il portale di Azure, Visual Studio Code o l'interfaccia della riga di comando di Azure per registrare il dispositivo, a seconda delle preferenze.

Portale

Nell'hub IoT nell'portale di Azure, i dispositivi IoT Edge vengono creati e gestiti separatamente dai dispositivi IoT non abilitati per dispositivi perimetrali.

1. Accedere al portale di Azure e passare all'hub IoT.

2. Nel riquadro sinistro selezionare Dispositivi dal menu, quindi selezionare Aggiungi dispositivo.

3. Nella pagina Crea un dispositivo specificare le informazioni seguenti:

   • Creare un ID dispositivo descrittivo. Prendere nota di questo ID dispositivo, perché verrà usato in un secondo momento.
   • Selezionare la casella di controllo IoT Edge Dispositivo.
   • Selezionare Chiave simmetrica come tipo di autenticazione.
   • Usare le impostazioni predefinite per la generazione automatica delle chiavi di autenticazione e la connessione del nuovo dispositivo all'hub.

4. Selezionare Salva.

Visual Studio Code

Eseguire l'accesso all'hub IoT

Per eseguire operazioni con l'hub IoT, è possibile usare le estensioni Azure IoT per Visual Studio Code. Per consentire il funzionamento di queste operazioni, è necessario accedere all'account Azure e selezionare l'hub.

1. In Visual Studio Code aprire la finestra di esplorazione.

2. Nella parte inferiore di Explorer, espandere la sezione Hub IoT di Azure.

   

3. Fare clic sui puntini di sospensione ( ... ) nell'intestazione della sezione Hub IoT di Azure. Se i puntini di sospensione non sono visibili, passare il puntatore sull'intestazione o fare clic su di essa.

4. Scegliere Select IoT Hub (Seleziona l'hub IoT).

5. Se ancora non lo si è fatto, eseguire l'accesso all'account di Azure seguendo le istruzioni.

6. Selezionare la sottoscrizione di Azure.

7. Selezionare l'hub IoT.

Registrare un nuovo dispositivo con Visual Studio Code

1. In Esplora risorse di Visual Studio Code espandere la sezione hub IoT di Azure.
2. Fare clic sui puntini di sospensione ( ... ) nell'intestazione della sezione Hub IoT di Azure. Se i puntini di sospensione non sono visibili, passare il puntatore sull'intestazione o fare clic su di essa.
3. Selezionare Create IoT Edge Device (Crea dispositivo IoT Edge).
4. Nella casella di testo che si apre specificare un ID per il dispositivo.

Nella schermata di output viene visualizzato il risultato del comando. Vengono stampate le informazioni relative al dispositivo, che includono il valore di deviceId fornito dall'utente e il valore di connectionString utilizzabile per connettere il dispositivo fisico all'hub IoT.

Interfaccia della riga di comando di Azure

Usare il comando az iot hub device-identity create per creare una nuova identità del dispositivo nell'hub IoT. Ad esempio:

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

Questo comando include tre parametri:

• --device-id o -d: specificare un nome descrittivo univoco all'interno dell'hub IoT.

• --hub-name o -n: specificare il nome dell'hub IoT.

• --edge-enabledo --ee: dichiarare che il dispositivo è un dispositivo IoT Edge.

  

Dopo aver registrato un dispositivo in hub IoT, recuperare le informazioni usate per completare l'installazione e il provisioning del runtime di IoT Edge.

Visualizzare i dispositivi registrati e recuperare le informazioni di provisioning

I dispositivi che usano l'autenticazione con chiave simmetrica necessitano delle stringhe di connessione per completare l'installazione e il provisioning del runtime di IoT Edge.

Portale

I dispositivi abilitati per dispositivi perimetrali che si connettono all'hub IoT sono elencati nella pagina Dispositivi . È possibile filtrare l'elenco in base al tipo Dispositivo Iot Edge.

Quando si è pronti per configurare il dispositivo, è necessaria la stringa di connessione che collega il dispositivo fisico alla relativa identità nell'hub IoT.

I dispositivi che eseguono l'autenticazione con chiavi simmetriche hanno le stringhe di connessione disponibili per la copia nel portale.

1. Nella pagina Dispositivi del portale selezionare l'ID dispositivo IoT Edge nell'elenco.
2. Copiare il valore Stringa di connessione primaria o Stringa di connessione secondaria.

Visual Studio Code

Tutti i dispositivi connessi all'hub IoT sono elencati nella sezione Hub IoT di Azure della finestra Explorer di Visual Studio Code. I dispositivi IoT Edge si distinguono dai dispositivi non Edge per la presenza di un'icona di tipo diverso e per la distribuzione dei moduli $edgeAgent e $edgeHub in ogni dispositivo IoT Edge.

Quando si è pronti per configurare il dispositivo, è necessaria la stringa di connessione che collega il dispositivo fisico alla relativa identità nell'hub IoT.

1. Fare clic con il pulsante destro del mouse sull'ID del dispositivo nella sezione Hub IoT di Azure.

2. Selezionare Copy Device Connection String (Copia stringa di connessione dispositivo).

   La stringa di connessione verrà copiata negli Appunti.

È anche possibile selezionare Get Device Info (Ottieni info dispositivo) dal menu di scelta rapida per visualizzare nella finestra di output tutte le informazioni relative al dispositivo, inclusa la stringa di connessione.

Interfaccia della riga di comando di Azure

Usare il comando az iot hub device-identity list per visualizzare tutti i dispositivi nell'hub IoT. Ad esempio:

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

Per qualsiasi dispositivo registrato come dispositivo IoT Edge, la proprietà capabilities.iotEdge sarà impostata su true.

Quando si è pronti per configurare il dispositivo, è necessaria la stringa di connessione che collega il dispositivo fisico alla relativa identità nell'hub IoT. Usare il comando az iot hub device-identity connection-string show per restituire la stringa di connessione per un singolo dispositivo:

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

Suggerimento

Il connection-string show comando è stato introdotto nella versione 0.9.8 dell'estensione Azure IoT, sostituendo il comando deprecato show-connection-string . Se viene visualizzato un errore durante l'esecuzione di questo comando, assicurarsi che la versione dell'estensione sia aggiornata alla versione 0.9.8 o successiva. Per altre informazioni e gli aggiornamenti più recenti, vedere Estensione Microsoft Azure IoT per l'interfaccia della riga di comando di Azure.

Per il parametro device-id viene fatta distinzione tra maiuscole e minuscole.

Quando si copia la stringa di connessione da usare in un dispositivo, non includere le virgolette intorno alla stringa di connessione.

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 eseguire la distribuzione in un dispositivo di destinazione remota tramite PowerShell, è possibile usare Remote PowerShell per stabilire una connessione a un dispositivo remoto ed eseguire questi comandi in remoto in 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 IoT Edge personalizzate per Linux per l'installazione e le directory VHDX di Windows aggiungendo INSTALLDIR="<FULLY_QUALIFIED_PATH>" parametri e VHDXDIR="<FULLY_QUALIFIED_PATH>" al comando di installazione. Ad esempio, se si vuole usare la cartella D:\EFLOW per l'installazione e 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 il IoT Edge per la distribuzione di Linux in Windows. La distribuzione crea la macchina virtuale Linux e installa automaticamente il runtime di IoT Edge.

   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, l'avvio non riuscirà.

   È possibile personalizzare le risorse disponibili della macchina virtuale usando i Deploy-Eflow 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. Impossibile raggiungere questo indirizzo IP interno dall'esterno del computer Windows. È possibile connettersi alla macchina virtuale in locale durante l'accesso alla macchina Windows.

    Se si usa Windows Server, configurare un commutatore predefinito prima di distribuire IoT Edge per Linux in Windows.

    È 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. Se si installano solo questi prerequisiti a questo punto nel processo di distribuzione, è 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 paravirtualization, non sono necessarie impostazioni aggiuntive.

    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.

    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 IoT Edge di Azure per Linux nel pacchetto Windows, l'installazione del pacchetto, la configurazione del dispositivo host e la configurazione della macchina virtuale Linux. Questo processo può richiedere diversi minuti per completare. Di seguito è riportata una distribuzione riuscita.

    

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

Effettuare il provisioning del dispositivo con la relativa identità cloud

È possibile configurare il dispositivo con le relative informazioni di identità e autenticazione cloud.

Per effettuare il provisioning del dispositivo usando chiavi simmetriche, sarà necessaria la stringa di connessione del dispositivo.

È possibile usare la Windows Admin Center o una sessione di PowerShell con privilegi elevati per effettuare il provisioning dei dispositivi.

PowerShell

Eseguire il comando seguente in una sessione di PowerShell con privilegi elevati nel dispositivo di destinazione. Sostituire il testo segnaposto con i propri valori.

Provision-EflowVm -provisioningType ManualConnectionString -devConnString "PASTE_DEVICE_CONNECTION_STRING_HERE"

Per altre informazioni sul Provision-EflowVM comando, vedere Funzioni di PowerShell per IoT Edge per Linux in Windows.

Windows Admin Center

1. Nel riquadro di provisioning dei dispositivi di Azure IoT Edge selezionare String di connessione (manuale) dall'elenco a discesa del metodo di provisioning.

2. Specificare la stringa di connessione dispositivo recuperata da hub IoT dopo la registrazione del dispositivo.

3. Selezionare Provisioning con il metodo selezionato.

   

4. Al termine del provisioning, selezionare Fine. Verrà restituito al dashboard principale. A questo momento, dovrebbe essere visualizzato un nuovo dispositivo elencato con il tipo IoT Edge Devices. È possibile selezionare il dispositivo IoT Edge a cui connettersi. Una volta nella pagina Panoramica, è possibile visualizzare l'elenco dei moduli IoT Edge e IoT Edge Stato del dispositivo.

Verificare la corretta configurazione

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

PowerShell

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

   Connect-EflowVm
   

   Nota

   L'unico account consentito a SSH nella macchina virtuale è l'utente che l'ha creata.

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

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