Criar um hub IoT usando o cmdlet New-AzIotHub

Artigo
03/08/2024

Você pode usar cmdlets do Azure PowerShell para criar e gerenciar hubs IoT do Azure. Este tutorial mostra como criar um hub IoT com o PowerShell.

Nota

Recomendamos que utilize o módulo do Azure Az PowerShell para interagir com o Azure. Veja Instalar o Azure PowerShell para começar. Para saber como migrar para o módulo do Az PowerShell, veja Migrar o Azure PowerShell do AzureRM para o Az.

Como alternativa, você pode usar o Azure Cloud Shell, se preferir não instalar módulos adicionais em sua máquina. A seção a seguir ajuda você a começar a usar o Azure Cloud Shell.

Azure Cloud Shell

O Azure aloja o Azure Cloud Shell, um ambiente de shell interativo que pode utilizar através do seu browser. Pode utilizar o Bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. Você pode usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada em seu ambiente local.

Para iniciar o Azure Cloud Shell:

Opção	Exemplo/Ligação
Selecione Experimentar no canto superior direito de um código ou bloco de comandos. Selecionar Experimentar não copia automaticamente o código ou comando para o Cloud Shell.
Aceda a https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir o Cloud Shell no browser.
Selecione o botão Cloud Shell na barra de menus, na parte direita do portal do Azure.

Para usar o Azure Cloud Shell:

Inicie o Cloud Shell.
Selecione o botão Copiar em um bloco de código (ou bloco de comando) para copiar o código ou comando.
Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e Linux ou selecionando Cmd+Shift+V no macOS.
Selecione Enter para executar o código ou comando.

Pré-requisitos

Você precisa de um grupo de recursos para implantar um hub IoT. Pode utilizar um grupo de recursos existente ou criar um novo.

Para criar um novo grupo de recursos para seu hub IoT, use o comando New-AzResourceGroup . Este exemplo cria um grupo de recursos chamado MyIoTRG1 na região Leste dos EUA :

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

Ligar à sua subscrição do Azure

Se estiver a utilizar o Cloud Shell, já iniciou sessão na sua subscrição, pelo que pode ignorar esta secção. Se você estiver executando o PowerShell localmente, digite o seguinte comando para entrar em sua assinatura do Azure:

# Log into Azure account.
Login-AzAccount

Criar um hub IoT

Crie um hub IoT usando seu grupo de recursos. Use o comando New-AzIotHub . Este exemplo cria um hub S1 chamado MyTestIoTHub na região Leste dos EUA :

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

O nome do hub IoT deve ser globalmente exclusivo.

Importante

Como o hub IoT poderá ser descoberto publicamente como um ponto de extremidade DNS, evite inserir informações confidenciais ou pessoalmente identificáveis ao nomeá-lo.

Para listar todos os hubs IoT em sua assinatura, use o comando Get-AzIotHub .

Este exemplo mostra o S1 Standard IoT Hub que você criou na etapa anterior.

Get-AzIotHub

Para excluir o hub IoT, use o comando Remove-AzIotHub .

Remove-AzIotHub `
    -ResourceGroupName MyIoTRG1 `
    -Name MyTestIoTHub

Atualizar o hub IoT

Você pode alterar as configurações de um hub IoT existente depois que ele for criado. Aqui estão algumas propriedades que você pode definir para um hub IoT:

Preço e escala: migre para uma camada diferente ou defina o número de unidades do Hub IoT.

Filtro IP: especifique um intervalo de endereços IP que serão aceitos ou rejeitados pelo hub IoT.

Propriedades: uma lista de propriedades que você pode copiar e usar em outro lugar, como a ID do recurso, o grupo de recursos, o local e assim por diante.

Explore os comandos Set-AzIotHub para obter uma lista completa de opções de atualização.