Gestire i dispositivi nell'applicazione Azure IoT CentralManage devices in your Azure IoT Central application

Questo articolo descrive come gestire i dispositivi nell'applicazione Azure IoT Central applicazione.This article describes how you manage devices in your Azure IoT Central application. È possibile:You can:

  • Usare la pagina Dispositivi per visualizzare, aggiungere ed eliminare i dispositivi connessi all Azure IoT Central app Azure IoT Central lavoro.Use the Devices page to view, add, and delete devices connected to your Azure IoT Central application.
  • Importare ed esportare i dispositivi in blocco.Import and export devices in bulk.
  • Mantenere aggiornato un inventario di dispositivi.Maintain an up-to-date inventory of your devices.
  • Mantenere aggiornati i metadati del dispositivo modificando i valori archiviati nelle proprietà del dispositivo dalle visualizzazioni.Keep your device metadata up to date by changing the values stored in the device properties from your views.
  • Controllare il comportamento dei dispositivi aggiornando un'impostazione in un dispositivo specifico dalle visualizzazioni.Control the behavior of your devices by updating a setting on a specific device from your views.

Per informazioni su come gestire gruppi personalizzati di dispositivi, vedere Esercitazione: Usare i gruppi di dispositivi per analizzare i dati di telemetria dei dispositivi.To learn how to manage custom groups of devices, see Tutorial: Use device groups to analyze device telemetry.

Visualizzare i dispositiviView your devices

Per visualizzare un singolo dispositivo:To view an individual device:

  1. Scegliere Dispositivi nel riquadro sinistro.Choose Devices on the left pane. Qui viene visualizzato un elenco di tutti i dispositivi e dei modelli di dispositivo.Here you see a list of all devices and of your device templates.

  2. Scegliere un modello di dispositivo.Choose a device template.

  3. Nel riquadro di destra della pagina Dispositivi viene visualizzato un elenco di dispositivi creati da tale modello di dispositivo.In the right-hand pane of the Devices page, you see a list of devices created from that device template. Scegliere un singolo dispositivo per visualizzare la pagina dei dettagli dispositivo per questo dispositivo:Choose an individual device to see the device details page for that device:

    Pagina dei dettagli dispositivo

Aggiungere un dispositivoAdd a device

Per aggiungere un dispositivo all'applicazione Azure IoT Central:To add a device to your Azure IoT Central application:

  1. Scegliere Dispositivi nel riquadro sinistro.Choose Devices on the left pane.

  2. Scegliere il modello di dispositivo da cui si vuole creare un dispositivo.Choose the device template from which you want to create a device.

  3. Scegliere + New (Nuovo).Choose + New.

  4. Impostare l'interruttore Simulato su On o Off.Turn the Simulated toggle to On or Off. Un dispositivo reale indica un dispositivo fisico che si connette a un'applicazione Azure IoT Central.A real device is for a physical device that you connect to your Azure IoT Central application. Un dispositivo simulato contiene dati di esempio generati automaticamente da Azure IoT Central.A simulated device has sample data generated for you by Azure IoT Central.

  5. Selezionare Crea.Select Create.

  6. Questo dispositivo viene ora visualizzato nell'elenco dei dispositivi per questo modello.This device now appears in your device list for this template. Selezionare il dispositivo per visualizzare la pagina dei dettagli del dispositivo che contiene tutte le visualizzazioni per il dispositivo.Select the device to see the device details page that contains all views for the device.

Importare dispositiviImport devices

Per connettere un numero elevato di dispositivi all'applicazione, è possibile importare in blocco i dispositivi da un file CSV.To connect large number of devices to your application, you can bulk import devices from a CSV file. È possibile trovare un file CSV di esempio nel repository di esempi di Azure.You can find an example CSV file in the Azure Samples repository. Il file CSV deve includere le intestazioni di colonna seguenti:The CSV file should include the following column headers:

ColonnaColumn DescrizioneDescription
IOTC_DEVICEIDIOTC_DEVICEID L'ID dispositivo è un identificatore univoco che verrà utilizzato da questo dispositivo per la connessione.The device ID is a unique identified this device will use to connect. L'ID dispositivo può contenere lettere, numeri - e il carattere senza spazi.The device ID can contain letters, numbers, and the - character without any spaces.
IOTC_DEVICENAMEIOTC_DEVICENAME facoltativo.Optional. Il nome del dispositivo è un nome descrittivo che verrà visualizzato in tutta l'applicazione.The device name is a friendly name that will be displayed throughout the application. Se non specificato, corrisponderà all'ID dispositivo.If not specified, this will be the same as the device ID.

Per registrare in blocco i dispositivi nell'applicazione:To bulk-register devices in your application:

  1. Scegliere Dispositivi nel riquadro sinistro.Choose Devices on the left pane.

  2. Nel riquadro di sinistra scegliere il modello di dispositivo per il quale si vuole creare in blocco i dispositivi.On the left panel, choose the device template for which you want to bulk create the devices.

    Nota

    Se non si ha ancora un modello di dispositivo, è possibile importare i dispositivi in Tutti i dispositivi e registrarli senza un modello.If you don't have a device template yet then you can import devices under All devices and register them without a template. Dopo aver importato i dispositivi, è possibile eseguirne la migrazione a un modello.After devices have been imported, you can then migrate them to a template.

  3. Selezionare Importa.Select Import.

    Azione di importazione

  4. Selezionare il file CSV contenente l'elenco di ID dispositivo da importare.Select the CSV file that has the list of Device IDs to be imported.

  5. Al termine del caricamento del file viene avviata l'importazione dei dispositivi.Device import starts once the file has been uploaded. È possibile tenere traccia dello stato dell'importazione nel pannello Operazioni del dispositivo.You can track the import status in the Device Operations panel. Questo pannello viene visualizzato automaticamente dopo l'avvio dell'importazione oppure è possibile accedervi tramite l'icona a forma di campana nell'angolo superiore destro.This panel appears automatically after the import starts or you can access it through the bell icon in the top right-hand corner.

  6. Al termine dell'importazione, nel pannello Operazioni del dispositivo viene visualizzato un messaggio di operazione riuscita.Once the import completes, a success message is shown in the Device Operations panel.

    Importazione riuscita

Se l'operazione di importazione del dispositivo non riesce, viene visualizzato un messaggio di errore nel pannello Operazioni del dispositivo.If the device import operation fails, you see an error message on the Device Operations panel. Verrà generato un file di log scaricabile in cui vengono acquisiti tutti gli errori.A log file capturing all the errors is generated that you can download.

Eseguire la migrazione dei dispositivi a un modelloMigrate devices to a template

Se si registrano i dispositivi avviando l'importazione in Tutti i dispositivi, i dispositivi vengono creati senza alcuna associazione di modelli di dispositivo.If you register devices by starting the import under All devices, then the devices are created without any device template association. I dispositivi devono essere associati a un modello per esplorare i dati e altri dettagli relativi al dispositivo.Devices must be associated with a template to explore the data and other details about the device. Per associare i dispositivi a un modello attenersi a questa procedura:Follow these steps to associate devices with a template:

  1. Scegliere Dispositivi nel riquadro sinistro.Choose Devices on the left pane.

  2. Nel pannello sinistro scegliere Tutti i dispositivi:On the left panel, choose All devices:

    Dispositivi non associati

  3. Usare il filtro nella griglia per determinare se il valore nella colonna Modello di dispositivo è Non associazione per uno dei dispositivi. Use the filter on the grid to determine if the value in the Device Template column is Unassociated for any of your devices.

  4. Selezionare i dispositivi da associare a un modello:Select the devices you want to associate with a template:

  5. Selezionare Esegui migrazione:Select Migrate:

    Associare i dispositivi

  6. Scegliere il modello dall'elenco dei modelli disponibili e selezionare Esegui migrazione.Choose the template from the list of available templates and select Migrate.

  7. I dispositivi selezionati verranno associati al modello di dispositivo scelto.The selected devices are associated with the device template you chose.

Esportare dispositiviExport devices

Per connettere un dispositivo reale a IoT Central, è necessario disporre della stringa di connessione corrispondente.To connect a real device to IoT Central, you need its connection string. È possibile esportare i dettagli del dispositivo in blocco per ottenere le informazioni necessarie per creare le stringhe di connessione del dispositivo.You can export device details in bulk to get the information you need to create device connection strings. Il processo di esportazione crea un file CSV con l'identità del dispositivo, il nome del dispositivo e le chiavi per tutti i dispositivi selezionati.The export process creates a CSV file with the device identity, device name, and keys for all the selected devices.

Per esportare in blocco i dispositivi dall'applicazione:To bulk export devices from your application:

  1. Scegliere Dispositivi nel riquadro sinistro.Choose Devices on the left pane.

  2. Nel riquadro sinistro scegliere il modello di dispositivo da cui esportare i dispositivi.On the left pane, choose the device template from which you want to export the devices.

  3. Selezionare i dispositivi da esportare e quindi selezionare l'azione Esporta.Select the devices that you want to export and then select the Export action.

    Esportazione

  4. Verrà avviato il processo di esportazione.The export process starts. È possibile tenere traccia dello stato usando il pannello Operazioni dispositivo.You can track the status using the Device Operations panel.

  5. Al termine dell'esportazione verrà visualizzato un messaggio di operazione completata insieme a un collegamento per scaricare il file generato.When the export completes, a success message is shown along with a link to download the generated file.

  6. Selezionare il collegamento Scarica file per scaricare il file in una cartella locale sul disco.Select the Download File link to download the file to a local folder on the disk.

    Esportazione riuscita

  7. Il file CSV esportato contiene le colonne relative all'ID di dispositivo, al nome di dispositivo, alle chiavi di dispositivo e alle identificazioni personali del certificato X509:The exported CSV file contains the following columns: device ID, device name, device keys, and X509 certificate thumbprints:

    • IOTC_DEVICEIDIOTC_DEVICEID
    • IOTC_DEVICENAMEIOTC_DEVICENAME
    • IOTC_SASKEY_PRIMARYIOTC_SASKEY_PRIMARY
    • IOTC_SASKEY_SECONDARYIOTC_SASKEY_SECONDARY
    • IOTC_X509THUMBPRINT_PRIMARYIOTC_X509THUMBPRINT_PRIMARY
    • IOTC_X509THUMBPRINT_SECONDARYIOTC_X509THUMBPRINT_SECONDARY

Per altre informazioni sulle stringhe di connessione e sulla connessione di dispositivi reali all'applicazione IoT Central, vedere Connettività dei dispositivi in Azure IoT Central.For more information about connection strings and connecting real devices to your IoT Central application, see Device connectivity in Azure IoT Central.

Eliminare un dispositivoDelete a device

Per eliminare un dispositivo simulato o reale dall'applicazione Azure IoT Central:To delete either a real or simulated device from your Azure IoT Central application:

  1. Scegliere Dispositivi nel riquadro sinistro.Choose Devices on the left pane.

  2. Scegliere il modello di dispositivo del dispositivo da eliminare.Choose the device template of the device you want to delete.

  3. Usare gli strumenti di filtro per filtrare e cercare i dispositivi.Use the filter tools to filter and search for your devices. Selezionare la casella accanto ai dispositivi da eliminare.Check the box next to the devices to delete.

  4. Scegliere Elimina.Choose Delete. È possibile tenere traccia dello stato di questa eliminazione nel pannello Operazioni dispositivo.You can track the status of this deletion in your Device Operations panel.

Modificare una proprietàChange a property

Le proprietà cloud sono i metadati del dispositivo associati al dispositivo, ad esempio città e numero di serie.Cloud properties are the device metadata associated with the device, such as city and serial number. Le proprietà cloud esistono solo nell'IoT Central e non vengono sincronizzate con i dispositivi.Cloud properties only exist in the IoT Central application and aren't synchronized to your devices. Le proprietà scrivibili controllano il comportamento di un dispositivo e consentono di impostare lo stato di un dispositivo in modalità remota, ad esempio impostando la temperatura di destinazione di un dispositivo termostato.Writable properties control the behavior of a device and let you set the state of a device remotely, for example by setting the target temperature of a thermostat device. Le proprietà del dispositivo vengono impostate dal dispositivo e sono di sola lettura all'interno IoT Central.Device properties are set by the device and are read-only within IoT Central. È possibile visualizzare e aggiornare le proprietà nelle visualizzazioni Dettagli dispositivo per il dispositivo.You can view and update properties on the Device Details views for your device.

  1. Scegliere Dispositivi nel riquadro sinistro.Choose Devices on the left pane.

  2. Scegliere il modello di dispositivo del dispositivo di cui si desidera modificare le proprietà e selezionare il dispositivo di destinazione.Choose the device template of the device whose properties you want to change and select the target device.

  3. Scegliere la visualizzazione che contiene le proprietà per il dispositivo. Questa visualizzazione consente di immettere i valori e selezionare Salva nella parte superiore della pagina.Choose the view that contains properties for your device, this view enables you to input values and select Save at the top of the page. Qui vengono visualizzati le proprietà del dispositivo e i relativi valori correnti.Here you see the properties your device has and their current values. Le proprietà cloud e le proprietà scrivibili hanno campi modificabili, mentre le proprietà del dispositivo sono di sola lettura.Cloud properties and writable properties have editable fields, while device properties are read-only. Per le proprietà scrivibili, è possibile visualizzarne lo stato di sincronizzazione nella parte inferiore del campo.For writable properties, you can see their sync status at the bottom of the field.

  4. Modificare le proprietà in base ai valori necessari.Modify the properties to the values you need. È possibile modificare più proprietà contemporaneamente e aggiornarle tutte contemporaneamente.You can modify multiple properties at a time and update them all at the same time.

  5. Scegliere Salva.Choose Save. Se sono state salvate proprietà scrivibili, i valori vengono inviati al dispositivo.If you saved writable properties, the values are sent to your device. Quando il dispositivo conferma la modifica per la proprietà scrivibile, lo stato torna a sincronizzato.When the device confirms the change for the writable property, the status returns back to synced. Se è stata salvata una proprietà cloud, il valore viene aggiornato.If you saved a cloud property, the value is updated.

Passaggi successiviNext steps

Ora che si è appreso come gestire i dispositivi nell'applicazione Azure IoT Central, il passaggio successivo consigliato consiste nell'apprendere come configurare le regoleper i dispositivi.Now that you've learned how to manage devices in your Azure IoT Central application, the suggested next step is to learn how toConfigure rules for your devices.