Usare iothub-explorer per la gestione di dispositivi hub IoT di AzureUse iothub-explorer for Azure IoT Hub device management

Diagramma end-to-end

Nota

Prima di iniziare questa esercitazione, configurare il dispositivo.Before you start this tutorial, set up your device. In questo articolo si configureranno il dispositivo e l'hub IoT di Azure e si distribuirà un'applicazione di esempio da eseguire nel dispositivo.In the article, you set up your Azure IoT device and IoT hub, and you deploy a sample application to run on your device. L'applicazione invia i dati del sensore raccolti all'hub IoT.The application sends collected sensor data to your IoT hub.

iothub-explorer è uno strumento dell'interfaccia della riga di comando eseguito in un computer host che consente di gestire le identità dei dispositivi nel registro dell'hub IoT.iothub-explorer is a CLI tool that you run on a host computer to manage device identities in your IoT hub registry. Include opzioni di gestione che consentono di eseguire varie attività.It comes with management options that you can use to perform various tasks.

Opzione di gestioneManagement option AttivitàTask
Metodi direttiDirect methods Far eseguire un'attività al dispositivo, quale l'avvio o l'arresto dell'invio di messaggi o il riavvio del dispositivo.Make a device act such as starting or stopping sending messages or rebooting the device.
Proprietà desiderate del dispositivo gemelloTwin desired properties Impostare determinati stati di un dispositivo, ad esempio impostare la luce verde per un LED o impostare l'intervallo di invio dei dati di telemetria su 30 minuti.Put a device into certain states, such as setting an LED to green or setting the telemetry send interval to 30 minutes.
Proprietà segnalate del dispositivo gemelloTwin reported properties Ottenere lo stato restituito da un dispositivo.Get the reported state of a device. Ad esempio, il dispositivo segnala che il LED sta lampeggiando.For example, the device reports the LED is blinking now.
Tag dei dispositivi gemelliTwin tags Archiviare i metadati specifici del dispositivo nel cloud,Store device-specific metadata in the cloud. ad esempio il percorso di distribuzione di un distributore automatico.For example, the deployment location of a vending machine.
Messaggi da cloud a dispositivoCloud-to-device messages Inviare notifiche a un dispositivo.Send notifications to a device. Ad esempio "Oggi è molto probabile che piova.For example, "It is very likely to rain today. Meglio non dimenticare l'ombrello".Don't forget to bring an umbrella."
Query del dispositivo gemelloDevice twin queries Eseguire query su tutti i dispositivi gemelli per identificare quelli che si trovano in una determinata condizione, ad esempio i dispositivi disponibili per l'uso.Query all device twins to retrieve those with arbitrary conditions, such as identifying the devices that are available for use.

Per altre informazioni sulle differenze e sull'uso di queste opzioni, vedere Device-to-cloud communication guidance (Indicazioni sulla comunicazione da dispositivo a cloud) e Cloud-to-device communication guidance (Indicazioni sulla comunicazione da cloud a dispositivo).For more detailed explanation on the differences and guidance on using these options, see Device-to-cloud communication guidance and Cloud-to-device communication guidance.

Nota

I dispositivi gemelli sono documenti JSON nei quali vengono archiviate informazioni sullo stato dei dispositivi (metadati, configurazioni e condizioni).Device twins are JSON documents that store device state information (metadata, configurations, and conditions). L'hub IoT rende permanente un dispositivo gemello per ogni dispositivo che si connette.IoT Hub persists a device twin for each device that connects to it. Per altre informazioni sui dispositivi gemelli, vedere Introduzione ai dispositivi gemelli.For more information about device twins, see Get started with device twins.

Contenuto dell'esercitazioneWhat you learn

Si apprende l'uso di iothub-explorer con varie opzioni di gestione presenti nel proprio computer di sviluppo.You learn using iothub-explorer with various management options on your development machine.

Operazioni da fareWhat you do

Eseguire iothub-explorer con diverse opzioni di gestione.Run iothub-explorer with various management options.

Elementi necessariWhat you need

  • Completare l'esercitazione Configurare il dispositivo che prevede i requisiti seguenti:Tutorial Setup your device completed which covers the following requirements:
    • Una sottoscrizione di Azure attiva.An active Azure subscription.
    • Un hub IoT di Azure nella sottoscrizione.An Azure IoT hub under your subscription.
    • Un'applicazione client che invia messaggi all'hub IoT di Azure.A client application that sends messages to your Azure IoT hub.
  • Verificare che il dispositivo sia in esecuzione con l'applicazione client durante questa esercitazione.Make sure your device is running with the client application during this tutorial.
  • iothub-explorer, Installare iothub-explorer sul computer di sviluppo.iothub-explorer, Install iothub-explorer on your development machine.

Accedere all'hub IoTConnect to your IoT hub

Accedere all'hub IoT eseguendo il comando seguente:Connect to your IoT hub by running the following command:

iothub-explorer login <your IoT hub connection string>

Usare iothub-explorer con i metodi direttiUse iothub-explorer with direct methods

Chiamare il metodo start nell'app per dispositivi per inviare messaggi all'hub IoT eseguendo il comando seguente:Invoke the start method in the device app to send messages to your IoT hub by running the following command:

iothub-explorer device-method <your device Id> start

Chiamare il metodo stop nell'app per dispositivi per interrompere l'invio di messaggi all'hub IoT eseguendo il comando seguente:Invoke the stop method in the device app to stop sending messages to your IoT hub by running the following command:

iothub-explorer device-method <your device Id> stop

Usare iothub-explorer con le proprietà desiderate del dispositivo gemelloUse iothub-explorer with twin’s desired properties

Impostare l'intervallo di proprietà desiderato su 3000 eseguendo il comando seguente:Set a desired property interval = 3000 by running the following command:

iothub-explorer update-twin <your device id> {\"properties\":{\"desired\":{\"interval\":3000}}}

Questa proprietà può essere letta dal dispositivo.This property can be read by your device.

Usare iothub-explorer con le proprietà segnalate del dispositivo gemelloUse iothub-explorer with twin’s reported properties

Ottenere le proprietà segnalate del dispositivo eseguendo il comando seguente:Get the reported properties of the device by running the following command:

iothub-explorer get-twin <your device id>

Una delle proprietà è $metadata.$lastUpdated, che visualizza l'ora di invio o ricezione dell'ultimo messaggio nel dispositivo.One of the properties is $metadata.$lastUpdated which shows the last time this device sends or receives a message.

Usare iothub-explorer con i tag del dispositivo gemelloUse iothub-explorer with twin’s tags

Visualizzare i tag e le proprietà del dispositivo eseguendo il comando seguente:Display the tags and properties of the device by running the following command:

iothub-explorer get-twin <your device id>

Aggiungere il campo role = temperature&humidity al dispositivo eseguendo il comando seguente:Add a field role = temperature&humidity to the device by running the following command:

iothub-explorer update-twin <your device id> "{\"tags\":{\"role\":\"temperature&humidity\"}}"

Usare iothub-explorer con i messaggi da cloud a dispositivoUse iothub-explorer with Cloud-to-device messages

Inviare un messaggio "Hello World" al dispositivo eseguendo il comando seguente:Send a "Hello World" message to the device by running the following command:

iothub-explorer send <device-id> "Hello World"

Per uno scenario reale dell'uso di questo comando, vedere Usare iothub-explorer per inviare e ricevere messaggi tra il dispositivo e l'hub IoT.See Use iothub-explorer to send and receive messages between your device and IoT Hub for a real scenario of using this command.

Usare iothub-explorer con le query del dispositivo gemelloUse iothub-explorer with device twins queries

Eseguire una query su tutti i dispositivi con il tag role = 'temperature&humidity' eseguendo il comando seguente:Query devices with a tag of role = 'temperature&humidity' by running the following command:

iothub-explorer query-twin "SELECT * FROM devices WHERE tags.role = 'temperature&humidity'"

Eseguire una query su tutti i dispositivi meno quelli con il tag role = 'temperature&humidity' eseguendo il comando seguente:Query all devices except those with a tag of role = 'temperature&humidity' by running the following command:

iothub-explorer query-twin "SELECT * FROM devices WHERE tags.role != 'temperature&humidity'"

Passaggi successiviNext steps

Si è appreso l'uso di iothub-explorer con diverse opzioni di gestione.You've learned how to use iothub-explorer with various management options.

Per altre informazioni sulle attività iniziali con l'hub IoT di Azure e per esplorare altri scenari IoT, vedere:To continue to get started with Azure IoT Hub and to explore other IoT scenarios, see the following: