Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
L'interfaccia della riga di comando di Azure viene usata per creare e gestire le risorse di Azure dalla riga di comando o negli script. Questa guida introduttiva illustra in dettaglio l'uso dell'interfaccia della riga di comando di Azure per creare un hub IoT e un'istanza del servizio Device Provisioning in hub IoT e collegare i due servizi.
Se non si ha un account Azure, creare un account gratuito prima di iniziare.
Importante
Sia l'hub IoT che il servizio di provisioning creato in questa guida introduttiva saranno individuabili pubblicamente come endpoint DNS. Assicurarsi di evitare eventuali informazioni riservate se si decide di modificare i nomi usati per queste risorse.
Prerequisiti
È possibile utilizzare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Introduzione ad Azure Cloud Shell.
Se preferisci eseguire localmente i comandi di riferimento della CLI, installa l'Azure CLI. Se si esegue in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
Se usi un'installazione locale, accedi all'interfaccia della riga di comando di Azure usando il comando az login. Per completare il processo di autenticazione, seguire i passaggi visualizzati nel terminale. Per altre opzioni di accesso, vedere Eseguire l'autenticazione ad Azure con l'interfaccia della riga di comando di Azure.
Quando ti viene richiesto, installa l'estensione Azure CLI al primo utilizzo. Per altre informazioni sulle estensioni, vedere Usare e gestire le estensioni con l'interfaccia della riga di comando di Azure.
Esegui az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, avviare az upgrade.
Creare un gruppo di risorse
Creare un gruppo di risorse con il comando az group create. Un gruppo di risorse di Azure è un contenitore logico in cui le risorse di Azure vengono distribuite e gestite.
L'esempio seguente crea un gruppo di risorse denominato my-sample-resource-group nella località westus .
az group create --name my-sample-resource-group --location westus
Suggerimento
Nell'esempio viene creato il gruppo di risorse nell'area Stati Uniti Ovest. È possibile visualizzare un elenco di posizioni disponibili eseguendo il comando az account list-locations -o table.
Creare un hub IoT
Creare un hub IoT con il comando az iot hub create .
L'esempio seguente crea un hub IoT denominato my-sample-hub nella località westus . Un nome dell'hub IoT deve essere globalmente univoco in Azure, quindi aggiungere un prefisso univoco o un suffisso al nome dell'esempio o scegliere completamente un nuovo nome. Assicurarsi che il nome segua le convenzioni di denominazione appropriate per un hub IoT: deve contenere 3-50 caratteri e può contenere solo caratteri alfanumerici maiuscoli o minuscoli ('-').
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus
Creare un'istanza del servizio Device Provisioning
Creare un'istanza del servizio Device Provisioning con il comando az iot dps create .
L'esempio seguente crea un'istanza del servizio Device Provisioning denominata my-sample-dps nella posizione westus . È necessario scegliere anche un nome globalmente univoco per la propria istanza. Assicurarsi che segua le convenzioni di denominazione appropriate per un servizio di provisioning di dispositivi in un hub IoT: deve avere una lunghezza compresa tra 3 e 64 caratteri e può contenere solo caratteri alfanumerici maiuscoli o minuscoli o trattini ('-').
az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus
Suggerimento
Nell'esempio viene creato il servizio di provisioning nella sede nell'ovest degli Stati Uniti. È possibile visualizzare un elenco delle posizioni disponibili eseguendo il comando az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table o passando alla pagina Stato di Azure e cercando "Servizio Device Provisioning". Nei comandi, le posizioni possono essere specificate in un formato di parola o di più parole; ad esempio: westus, Stati Uniti occidentali, Stati Uniti occidentali e così via. Il valore non fa distinzione tra maiuscole e minuscole. Se si utilizza il formato multi-parola per specificare la posizione, racchiudere il valore tra virgolette; ad esempio . --location "West US"
Per garantire resilienza e affidabilità, è consigliabile eseguire la distribuzione in una delle aree che supportano le Zone di disponibilità.
Ottenere la stringa di connessione per l'hub IoT
È necessaria la stringa di connessione dell'hub IoT per collegarla al servizio Device Provisioning. Usare il comando az iot hub connection-string show per ottenere la stringa di connessione e usare il relativo output per impostare una variabile usata in un secondo momento, quando si collegano le due risorse.
L'esempio seguente imposta la variabile hubConnectionString sul valore della stringa di connessione per la chiave primaria del criterio iothubowner dell'hub (il --policy-name parametro può essere usato per specificare un criterio diverso). Sostituisci my-sample-hub con il nome univoco dell'hub IoT che hai scelto in precedenza. Il comando usa le opzioni di query e output dell'interfaccia della riga di comando di Azure per estrarre la stringa di connessione dall'output del comando.
hubConnectionString=$(az iot hub connection-string show --name my-sample-hub --key primary --query connectionString -o tsv)
È possibile usare il echo comando per visualizzare la stringa di connessione.
echo $hubConnectionString
Annotazioni
Questi due comandi sono validi per un host in esecuzione in Bash.
Se si usa una shell Windows/CMD locale o un host di PowerShell, modificare i comandi per usare la sintassi corretta per tale ambiente.
Se si usa Azure Cloud Shell, verificare che l'elenco a discesa dell'ambiente a sinistra della finestra della shell indichi Bash.
Collegare l'hub IoT e il servizio di provisioning
Collegare l'hub IoT e il servizio di provisioning con il comando az iot dps linked-hub create .
L'esempio seguente collega un hub IoT denominato my-sample-hub nella posizione westus e un servizio Device Provisioning denominato my-sample-dps. Sostituire questi nomi con i nomi univoci dell'hub IoT e del Servizio di Provisioning dei Dispositivi scelti in precedenza. Il comando usa la stringa di connessione per l'hub IoT archiviato nella variabile hubConnectionString nel passaggio precedente.
az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --location westus
Il completamento del comando può richiedere alcuni minuti.
Verificare il servizio di provisioning
Ottieni i dettagli del tuo servizio di provisioning con il comando az iot dps show.
L'esempio seguente ottiene i dettagli di un servizio di provisioning denominato my-sample-dps. Sostituire questo nome con il proprio nome del servizio Device Provisioning.
az iot dps show --name my-sample-dps
L'hub IoT collegato viene visualizzato nella raccolta properties.iotHubs .
Pulire le risorse
Altre guide di avvio rapido di questa raccolta si basano sulla presente guida di avvio rapido. Se si prevede di continuare a usare le guide introduttive successive o con le esercitazioni, non pulire le risorse create in questa guida introduttiva. Se non si prevede di continuare, è possibile usare i comandi seguenti per eliminare il servizio di provisioning, l'hub IoT o il gruppo di risorse e tutte le relative risorse. Sostituire i nomi delle risorse incluse nei comandi seguenti con i nomi delle proprie risorse.
Per eliminare il servizio di provisioning, eseguire il comando az iot dps delete :
az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group
Per eliminare l'hub IoT, eseguire il comando az iot hub delete :
az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group
Per eliminare un gruppo di risorse e tutte le relative risorse, eseguire il comando az group delete :
az group delete --name my-sample-resource-group
Passaggi successivi
In questa guida introduttiva è stato distribuito un hub IoT e un'istanza del servizio Device Provisioning e sono state collegate le due risorse. Per informazioni su come usare questa configurazione per effettuare il provisioning di un dispositivo, proseguire con l'argomento di avvio rapido per la creazione di un dispositivo.