Creare un hub IoT usando il cmdlet New-AzIotHub

È possibile usare i cmdlet di Azure PowerShell per creare e gestire hub IoT di Azure. In questa esercitazione viene illustrato come creare un hub IoT con PowerShell.

Nota

È consigliabile usare il modulo Azure Az PowerShell per interagire con Azure. Per iniziare, vedere Installare Azure PowerShell. Per informazioni su come eseguire la migrazione al modulo AZ PowerShell, vedere Eseguire la migrazione di Azure PowerShell da AzureRM ad Az.

In alternativa, è possibile usare Azure Cloud Shell, se si preferisce non installare moduli aggiuntivi nel computer. La sezione seguente illustra come iniziare a usare Azure Cloud Shell.

Azure Cloud Shell

Azure Cloud Shell è un ambiente di shell interattivo ospitato in Azure e usato tramite il browser. È possibile usare Bash o PowerShell con Cloud Shell per usare i servizi di Azure. È possibile usare i comandi preinstallati di Cloud Shell per eseguire il codice in questo articolo, senza dover installare alcun elemento nell'ambiente locale.

Per avviare Azure Cloud Shell:

Opzione Esempio/Collegamento
Selezionare Prova nell'angolo superiore destro di un codice o di un blocco di comandi. Selezionando Prova non viene copiato automaticamente il codice o il comando in Cloud Shell. Screenshot that shows an example of Try It for Azure Cloud Shell.
Passare a https://shell.azure.com o selezionare il pulsante Avvia Cloud Shell per aprire Cloud Shell nel browser. Button to launch Azure Cloud Shell.
Selezionare il pulsante Cloud Shell nella barra dei menu nell'angolo in alto a destra del portale di Azure. Screenshot that shows the Cloud Shell button in the Azure portal

Per usare Azure Cloud Shell:

  1. Avviare Cloud Shell.

  2. Selezionare il pulsante Copia in un blocco di codice (o blocco di comandi) per copiare il codice o il comando.

  3. Incollare il codice o il comando nella sessione di Cloud Shell selezionando CTRL+MAIUSC+V in Windows e Linux oppure selezionando CMD+MAIUSC+V in macOS.

  4. Selezionare INVIO per eseguire il codice o il comando.

Prerequisiti

Per la distribuzione di un hub IoT è necessario un gruppo di risorse. È possibile usare un gruppo di risorse esistente o crearne uno nuovo.

Per creare un nuovo gruppo di risorse per l'hub IoT, usare il comando New-AzResourceGroup . In questo esempio viene creato un gruppo di risorse denominato MyIoTRG1 nell'area degli Stati Uniti orientali:

New-AzResourceGroup -Name MyIoTRG1 -Location "East US"

Connettersi alla sottoscrizione di Azure

Se si usa Cloud Shell, si è già connessi alla sottoscrizione, quindi è possibile ignorare questa sezione. Se invece si esegue PowerShell in locale, immettere il comando seguente per accedere alla sottoscrizione di Azure:

# Log into Azure account.
Login-AzAccount

Creare un hub IoT

Creare un hub IoT usando il gruppo di risorse. Usare il comando New-AzIotHub . In questo esempio viene creato un hub S1 denominato MyTestIoTHub nell'area degli Stati Uniti orientali:

New-AzIotHub `
    -ResourceGroupName MyIoTRG1 `
    -Name MyTestIoTHub `
    -SkuName S1 -Units 1 `
    -Location "East US"

Il nome dell'hub IoT deve essere globalmente univoco.

Importante

Dato che l'hub IoT sarà individuabile pubblicamente come endpoint DNS, evitare di includere nel nome informazioni personali o sensibili.

Per elencare tutti gli hub IoT nella sottoscrizione, usare il comando Get-AzIotHub .

Questo esempio illustra l'hub IoT Standard S1 che è stato creato nel passaggio precedente.

Get-AzIotHub

Per eliminare l'hub IoT, usare il comando Remove-AzIotHub .

Remove-AzIotHub `
    -ResourceGroupName MyIoTRG1 `
    -Name MyTestIoTHub

Aggiornare l'hub IoT

È possibile modificare le impostazioni di un hub IoT esistente dopo la creazione. Ecco alcune proprietà che è possibile impostare per un hub IoT:

Prezzi e scalabilità: eseguire la migrazione a un livello diverso o impostare il numero di unità di hub IoT.

Filtro IP: specificare un intervallo di indirizzi IP che verranno accettati o rifiutati dall'hub IoT.

Proprietà: elenco di proprietà che è possibile copiare e usare altrove, ad esempio l'ID risorsa, il gruppo di risorse, la posizione e così via.

Esplorare i comandi Set-AzIotHub per un elenco completo delle opzioni di aggiornamento.

Passaggi successivi

Dopo aver distribuito un hub IoT usando un cmdlet di PowerShell, vedere altri articoli:

Sviluppare per hub IoT:

Esplorare le funzionalità di hub IoT: