Creare un hub Internet delle cose usando il cmdlet New-AzIotHubCreate an IoT hub using the New-AzIotHub cmdlet

IntroduzioneIntroduction

È possibile usare i cmdlet di Azure PowerShell per creare e gestire hub IoT di Azure.You can use Azure PowerShell cmdlets to create and manage Azure IoT hubs. In questa esercitazione viene illustrato come creare un hub IoT con PowerShell.This tutorial shows you how to create an IoT hub with PowerShell.

Per completare questa esercitazione è necessario disporre di una sottoscrizione di Azure.To complete this how-to, you need an Azure subscription. Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

Nota

Questo articolo è stato aggiornato per usare il modulo Az di Azure PowerShell.This article has been updated to use the Azure Az PowerShell module. Il modulo Az di PowerShell è ora il modulo di PowerShell consigliato per l'interazione con Azure.The Az PowerShell module is the recommended PowerShell module for interacting with Azure. Per iniziare a usare il modulo Az PowerShell, vedere Installare Azure PowerShell.To get started with the Az PowerShell module, see Install Azure PowerShell. Per informazioni su come eseguire la migrazione al modulo AZ PowerShell, vedere Eseguire la migrazione di Azure PowerShell da AzureRM ad Az.To learn how to migrate to the Az PowerShell module, see Migrate Azure PowerShell from AzureRM to Az.

Usare Azure Cloud ShellUse Azure Cloud Shell

Azure Cloud Shell è un ambiente di shell interattivo ospitato in Azure e usato tramite il browser.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. È possibile usare Bash o PowerShell con Cloud Shell per usare i servizi di Azure.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. È possibile usare i comandi preinstallati di Cloud Shell per eseguire il codice contenuto in questo articolo senza dover installare strumenti nell'ambiente locale.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Per avviare Azure Cloud Shell:To start Azure Cloud Shell:

OpzioneOption Esempio/CollegamentoExample/Link
Selezionare Prova nell'angolo superiore destro di un blocco di codice.Select Try It in the upper-right corner of a code block. La selezione di Prova non comporta la copia automatica del codice in Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Esempio di Prova per Azure Cloud Shell
Passare a https://shell.azure.com o selezionare il pulsante Avvia Cloud Shell per aprire Cloud Shell nel browser.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. Avviare Cloud Shell in una nuova finestraLaunch Cloud Shell in a new window
Selezionare il pulsante Cloud Shell nella barra dei menu nell'angolo in alto a destra del portale di Azure.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Pulsante Cloud Shell nel portale di Azure

Per eseguire il codice di questo articolo in Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Avviare Cloud Shell.Start Cloud Shell.

  2. Selezionare il pulsante Copia in un blocco di codice per copiare il codice.Select the Copy button on a code block to copy the code.

  3. Incollare il codice nella sessione di Cloud Shell premendo CTRL+MAIUSC+V in Windows e Linux o CMD+MAIUSC+V in macOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Premere INVIO per eseguire il codice.Select Enter to run the code.

Connettersi alla sottoscrizione di AzureConnect to your Azure subscription

Se si usa Cloud Shell, si è già connessi alla sottoscrizione.If you are using the Cloud Shell, you are already logged in to your subscription. Se PowerShell è in esecuzione in locale, immettere il comando seguente per accedere alla sottoscrizione di Azure:If you are running PowerShell locally instead, enter the following command to sign in to your Azure subscription:

# Log into Azure account.
Login-AzAccount

Creare un gruppo di risorseCreate a resource group

Per la distribuzione di un hub IoT è necessario un gruppo di risorse.You need a resource group to deploy an IoT hub. È possibile usare un gruppo di risorse esistente o crearne uno nuovo.You can use an existing resource group or create a new one.

Per creare un gruppo di risorse per l'hub Internet delle cose, usare il comando New-AzResourceGroup .To create a resource group for your IoT hub, use the New-AzResourceGroup command. In questo esempio viene creato un gruppo di risorse denominato MyIoTRG1 nell'area degli Stati Uniti orientali:This example creates a resource group called MyIoTRG1 in the East US region:

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

Creare un hub IoTCreate an IoT hub

Per creare un hub Internet delle cose nel gruppo di risorse creato nel passaggio precedente, usare il comando New-AzIotHub .To create an IoT hub in the resource group you created in the previous step, use the New-AzIotHub command. In questo esempio viene creato un hub S1 denominato MyTestIoTHub nell'area degli Stati Uniti orientali:This example creates an S1 hub called MyTestIoTHub in the East US region:

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

Il nome dell'hub IoT deve essere globalmente univoco.The name of the IoT hub must be globally unique.

Importante

Dato che l'hub IoT sarà individuabile pubblicamente come endpoint DNS, evitare di includere nel nome informazioni personali o sensibili.Because the IoT hub will be publicly discoverable as a DNS endpoint, be sure to avoid entering any sensitive or personally identifiable information when you name it.

È possibile elencare tutti gli hub Internet delle cose nella sottoscrizione usando il comando Get-AzIotHub :You can list all the IoT hubs in your subscription using the Get-AzIotHub command:

Get-AzIotHub

Questo esempio illustra l'hub IoT Standard S1 che è stato creato nel passaggio precedente.This example shows the S1 Standard IoT Hub you created in the previous step.

È possibile eliminare l'hub Internet delle cose usando il comando Remove-AzIotHub :You can delete the IoT hub using the Remove-AzIotHub command:

Remove-AzIotHub `
    -ResourceGroupName MyIoTRG1 `
    -Name MyTestIoTHub

In alternativa, è possibile rimuovere un gruppo di risorse e tutte le risorse in esso contenute usando il comando Remove-AzResourceGroup :Alternatively, you can remove a resource group and all the resources it contains using the Remove-AzResourceGroup command:

Remove-AzResourceGroup -Name MyIoTRG1

Passaggi successiviNext steps

Dopo aver distribuito un hub IoT mediante il cmdlet di PowerShell, può essere opportuno ottenere informazioni più dettagliate consultando i seguenti articoli:Now you have deployed an IoT hub using a PowerShell cmdlet, if you want to explore further, check out the following articles:

Per altre informazioni sulle attività di sviluppo per l'hub IoT, vedere gli articoli seguenti:To learn more about developing for IoT Hub, see the following articles:

Per altre informazioni sulle funzionalità dell'hub IoT, vedere:To further explore the capabilities of IoT Hub, see: