Criar um hub IoT usando o cmdlet New-AzIotHub
É possível usar os cmdlets do Azure PowerShell para criar e gerenciar hubs IoT do Azure. Este tutorial mostra como criar um hub IoT com o PowerShell.
Observação
Recomendamos que você use o módulo Az PowerShell do Azure para interagir com o Azure. Para começar, consulte Instalar o Azure PowerShell. Para saber como migrar para o módulo Az PowerShell, confira 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 seu computador. A seção a seguir ajuda você a começar com o Azure Cloud Shell.
Azure Cloud Shell
O Azure hospeda o Azure Cloud Shell, um ambiente de shell interativo que pode ser usado por meio do navegador. É possível usar o bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. É possível usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada no seu ambiente local.
Para iniciar o Azure Cloud Shell:
Opção | Exemplo/Link |
---|---|
Selecione Experimentar no canto superior direito de um bloco de código ou de comando. Selecionar Experimentar não copia automaticamente o código nem o comando para o Cloud Shell. | |
Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador. | |
Selecione o botão Cloud Shell na barra de menus no canto superior direito 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 o comando.
Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e no Linux, ou selecionando Cmd+Shift+V no macOS.
Pressione Enter para executar o código ou comando.
Pré-requisitos
Você precisa de um grupo de recursos para implantar um hub IoT. É possível usar um grupo de recursos existente ou criar um novo.
Para criar um grupo de recursos para o 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"
Conecte-se à sua assinatura do Azure
Se você está usando o Cloud Shell, já está conectado à sua assinatura, então pode ignorar esta seção. Mas, se você estiver executando o PowerShell localmente, insira o seguinte comando para entrar em sua assinatura do Azure:
# Log into Azure account.
Login-AzAccount
Crie um hub IoT
Crie um hub IoT usando seu novo 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 será publicamente detectável como um ponto de extremidade DNS, evite inserir informações de identificação pessoal ou confidenciais ao nomeá-lo.
É possível listar todos os hubs IoT da assinatura usando o comando Get-AzIotHub.
Este exemplo mostra o Hub IoT Standard S1, que você criou na etapa anterior.
Get-AzIotHub
É possível excluir o hub IoT usando o comando Remove-AzIotHub.
Remove-AzIotHub `
-ResourceGroupName MyIoTRG1 `
-Name MyTestIoTHub
Atualizar o hub IoT
Você poderá 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 definir o número de unidades do Hub IoT.
Filtro de 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 outros lugares, como ID de recurso, grupo de recursos, localização e assim por diante.
Explore os comandos Set-AzIotHub para obter uma lista completa de opções de atualização.
Próximas etapas
Agora que você implantou um hub IoT usando um cmdlet do PowerShell, explore mais artigos:
Desenvolver para o Hub IoT:
Explore as funcionalidades do Hub IoT: