estensione hub IoT di Azure per Visual Studio Code

Visual Studio Code (VS Code) consente di aggiungere estensioni, ad esempio linguaggi, debugger e strumenti, all'installazione di VS Code per supportare il flusso di lavoro di sviluppo. L'estensione hub IoT di Azure per Visual Studio Code consente di aggiungere hub IoT di Azure supporto all'installazione di VS Code, in modo da poter gestire e interagire con hub IoT, dispositivi e moduli durante lo sviluppo. L'estensione hub IoT di Azure è disponibile in Visual Studio Code Marketplace.

Nota

Alcune delle funzionalità indicate in questo articolo, come la messaggistica da cloud a dispositivo, i dispositivi gemelli e la gestione dei dispositivi, sono disponibili solo nel livello Standard dell'hub IoT. Per altre informazioni sui livelli di hub IoT di base e standard/gratuiti, vedere Scegliere il livello di hub IoT appropriato per la soluzione.

Installare l'estensione

È possibile trovare e installare l'estensione da Visual Studio Code o in Visual Studio Code Marketplace.

Installare da Visual Studio Code

Per trovare e installare l'estensione da Visual Studio Code, seguire questa procedura.

1. In VS Code selezionare la visualizzazione Estensioni selezionando l'icona Visualizzazione Estensioni dalla barra di visualizzazione o selezionando CTRL+MAIUSC+X.

   

2. Immettere hub IoT di Azure nella casella di ricerca per filtrare le offerte del Marketplace. Verrà visualizzata l'estensione hub IoT di Azure nell'elenco. Selezionare l'estensione dall'elenco per visualizzare la pagina dei dettagli dell'estensione.

   

3. Verificare che l'identificatore univoco per l'estensione selezionata, visualizzato nella sezione Altre informazioni della pagina dei dettagli dell'estensione, sia impostata su vsciot-vscode.azure-iot-toolkit.

   

4. Selezionare il pulsante Installa per l'estensione selezionata, nell'elenco o nella pagina dei dettagli dell'estensione, per installare l'estensione.

Installare da Visual Studio Code Marketplace

Per trovare e installare l'estensione da VS Code Marketplace, seguire questa procedura.

1. Nel browser passare alla pagina dell'estensione hub IoT di Azure in VS Code Marketplace.

2. Verificare che l'identificatore univoco per l'estensione selezionata, visualizzato nella sezione Altre informazioni della pagina dell'estensione hub IoT di Azure, sia impostata su vsciot-vscode.azure-iot-toolkit.

3. Selezionare il pulsante Installa per avviare Visual Studio Code, se non è già in esecuzione e visualizzare la pagina dei dettagli dell'estensione per l'estensione in VS Code.

4. In VS Code selezionare il pulsante Installa dalla pagina dei dettagli dell'estensione per installare l'estensione.

L'installazione dell'estensione hub IoT di Azure per Visual Studio Code installa anche l'estensione account di Azure per Visual Studio Code, che offre un'esperienza di filtro dell'accesso e della sottoscrizione di Azure per tutte le altre estensioni di Azure. L'estensione account di Azure rende disponibile anche il servizio azure Cloud Shell nel terminale integrato di VS Code.

Nota

L'estensione hub IoT di Azure dipende dall'estensione account di Azure per la connettività. Non è possibile disinstallare l'estensione account di Azure senza disinstallare l'estensione hub IoT di Azure.

Accedere con l'account Azure

Prima che l'estensione possa interagire con hub IoT di Azure, è necessario accedere all'account Azure da Visual Studio Code. È possibile usare l'estensione account di Azure per:

• Creare un account Azure
• Accedere e uscire dall'account Azure
• Filtrare le sottoscrizioni di Azure disponibili per l'estensione hub IoT di Azure dall'account Azure
• Caricare un file nell'account di archiviazione di Azure Cloud Shell

Seguire questa procedura per accedere ad Azure e selezionare l'hub IoT dalla sottoscrizione di Azure:

1. Nella visualizzazione Esplora risorse di VS Code espandere la sezione hub IoT di Azure nella barra laterale.

2. Selezionare il pulsante con i puntini di sospensione (...) della sezione hub IoT di Azure per visualizzare il menu azione e quindi selezionare Seleziona hub IoT dal menu azione.

3. Se non si è connessi ad Azure, viene visualizzata una notifica popup nell'angolo inferiore destro per consentire l'accesso ad Azure. Selezionare Accedi e seguire le istruzioni per accedere ad Azure.

4. Selezionare la sottoscrizione di Azure dall'elenco a discesa Seleziona sottoscrizione .

5. Selezionare l'hub IoT dall'elenco a discesa Seleziona hub IoT.

6. I dispositivi per l'hub IoT vengono recuperati da hub IoT e visualizzati nel nodo Dispositivi nella sezione hub IoT di Azure della barra laterale.

   Nota

   È anche possibile usare una stringa di connessione per accedere all'hub IoT selezionando Imposta stringa di connessione hub IoT dal menu azione e immettendo la stringa di connessione dei criteri iothubowner per l'hub IoT nella casella di input della stringa di connessione hub IoT.

Dopo aver eseguito l'accesso, è possibile interagire con hub, dispositivi e moduli dal riquadro comandi o dal menu azione nella visualizzazione Esplora codice. Per altre informazioni sull'interazione con l'estensione, incluse le domande frequenti e gli esempi di interazione, vedere il wiki per l'estensione hub IoT di Azure.

Gestire gli hub IoT

È possibile eseguire le attività di gestione dell'hub IoT seguenti dall'estensione:

• Creare un nuovo hub IoT e selezionarlo come hub IoT corrente per l'estensione
• Selezionare un hub IoT esistente come hub IoT corrente per l'estensione
• Elencare gli endpoint predefiniti e personalizzati esistenti per l'hub IoT corrente selezionando il pulsante Aggiorna per la sezione hub IoT di Azure nella visualizzazione Esplora risorse
• Copiare la stringa di connessione per l'hub IoT corrente negli Appunti
• Generare un token di firma di accesso condiviso per l'hub IoT corrente e copiarlo negli Appunti

Gestire i dispositivi

È possibile eseguire le attività di gestione dei dispositivi seguenti per l'hub IoT corrente dall'estensione:

• Creare un nuovo dispositivo hub IoT
• Creare un nuovo dispositivo IoT Edge
• Elencare i dispositivi esistenti selezionando il pulsante Aggiorna per l'hub IoT corrente nella visualizzazione Esplora o specificando il comando hub IoT di Azure: Elencare i dispositivi nel riquadro comandi
• Ottenere informazioni sul dispositivo selezionato come documento JSON, illustrato nel pannello Output di VS Code
• Modificare il dispositivo gemello per il dispositivo selezionato, come documento JSON nell'editor di VS Code
• Copiare la stringa di connessione per il dispositivo selezionato negli Appunti
• Generare un token di firma di accesso condiviso per il dispositivo selezionato e copiarlo negli Appunti
• Richiamare un metodo diretto per il dispositivo selezionato e visualizzare i risultati nel pannello Output di VS Code
• Eliminare il dispositivo selezionato dall'hub IoT corrente

Suggerimento

È possibile abilitare un blocco sulle risorse IoT per impedire l'eliminazione accidentale o dannosa. Per altre informazioni sui blocchi delle risorse in Azure, vedere Bloccare le risorse per proteggere l'infrastruttura.

Gestire i moduli

È possibile eseguire le attività di gestione dei moduli seguenti per il dispositivo selezionato nell'hub IoT corrente:

• Creare un nuovo modulo
• Elencare i moduli esistenti selezionando il pulsante Aggiorna per il dispositivo corrente nella visualizzazione Esplora risorse di VS Code
• Ottenere informazioni sul modulo selezionato come documento JSON, illustrato nel pannello Output di VS Code
• Modificare il modulo gemello per il modulo selezionato, come documento JSON nell'editor di VS Code
• Copiare la stringa di connessione per il modulo selezionato negli Appunti
• Richiamare un metodo diretto per il modulo selezionato e visualizzare i risultati nel pannello Output di VS Code
• Eliminare il modulo selezionato dal dispositivo corrente

Nota

I moduli di sistema di Azure IoT Edge sono di sola lettura e non possono essere modificati. È possibile inviare modifiche distribuendo una configurazione per il dispositivo di IoT Edge correlato.

Interagire con hub IoT

È possibile eseguire le attività interattive seguenti per le risorse nell'hub IoT corrente:

• Generare codice in un linguaggio di programmazione selezionato per eseguire un'attività comune, ad esempio l'invio di un messaggio da dispositivo a cloud, per la risorsa selezionata
• Inviare un messaggio da dispositivo a cloud (D2C) a hub IoT per il dispositivo selezionato
• Avviare e arrestare il monitoraggio dell'endpoint evento predefinito per l'hub IoT corrente e visualizzare i risultati nel pannello Output di VS Code
• Inviare un messaggio da cloud a dispositivo (C2D) al dispositivo selezionato per l'hub IoT corrente e visualizzare i risultati nel pannello Output di VS Code
• Avviare e arrestare il monitoraggio dei messaggi C2D nel dispositivo selezionato per l'hub IoT corrente e visualizzare i risultati nel pannello Output di VS Code
• Aggiornare le impostazioni di traccia distribuita per i dispositivi
• Avviare e arrestare il monitoraggio degli endpoint di Hub eventi personalizzati per l'hub IoT corrente e visualizzare i risultati nel pannello Output di VS Code

Interagire con IoT Edge

È possibile eseguire le attività interattive seguenti per i dispositivi di Azure IoT Edge nell'hub IoT corrente:

• Creare una distribuzione per il dispositivo selezionato IoT Edge e visualizzare i risultati nel pannello Output di VS Code
• Se si dispone di un manifesto di distribuzione appropriato, creare una distribuzione su larga scala per più dispositivi IoT Edge e visualizzare i risultati nel pannello Output di VS Code