Início Rápido: Configurar o Serviço de Provisionamento de Dispositivos no Hub IoT com a CLI do AzureQuickstart: Set up the IoT Hub Device Provisioning Service with Azure CLI

A CLI do Azure é usada para criar e gerenciar recursos do Azure da linha de comando ou em scripts.The Azure CLI is used to create and manage Azure resources from the command line or in scripts. Este início rápido detalha o uso da CLI do Azure para criar um Hub IoT e um Serviço de Provisionamento de Dispositivos no Hub IoT e vincular os dois serviços.This quickstart details using the Azure CLI to create an IoT hub and an IoT Hub Device Provisioning Service, and to link the two services together.

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Importante

O Hub IoT e o serviço de provisionamento criado neste início rápido serão detectáveis publicamente como pontos de extremidade DNS.Both the IoT hub and the provisioning service you create in this quickstart will be publicly discoverable as DNS endpoints. Evite usar informações confidenciais se você decidir alterar os nomes usados nesses recursos.Make sure to avoid any sensitive information if you decide to change the names used for these resources.

Pré-requisitosPrerequisites

  • Use o Azure Cloud Shell usando o ambiente bash.Use Azure Cloud Shell using the bash environment.

    Inserir inicializaçãoEmbed launch

  • Se preferir, instale a CLI do Azure para executar comandos de referência da CLI.If you prefer, install Azure CLI to run CLI reference commands.

    • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login.If you're using a local install, sign in with Azure CLI by using the az login command. Para concluir o processo de autenticação, siga as etapas exibidas no terminal.To finish the authentication process, follow the steps displayed in your terminal. Confira Entrar com a CLI do Azure para obter outras opções de entrada.See Sign in with Azure CLI for additional sign-in options.
    • Quando solicitado, instale as extensões da CLI do Azure no primeiro uso.When you're prompted, install Azure CLI extensions on first use. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.For more information about extensions, see Use extensions with Azure CLI.
    • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas.Run az version to find the version and dependent libraries that are installed. Para fazer a atualização para a versão mais recente, execute az upgrade.To upgrade to the latest version, run az upgrade.

Criar um grupo de recursosCreate a resource group

Crie um grupo de recursos com o comando az group create.Create a resource group with the az group create command. Um grupo de recursos do Azure é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados.An Azure resource group is a logical container into which Azure resources are deployed and managed.

O exemplo a seguir cria um grupo de recursos chamado my-sample-resource-group na localização westus.The following example creates a resource group named my-sample-resource-group in the westus location.

az group create --name my-sample-resource-group --location westus

Dica

O exemplo cria o grupo de recursos localizado no Oeste dos EUA.The example creates the resource group in the West US location. Você pode exibir uma lista dos locais disponíveis executando o comando az account list-locations -o table.You can view a list of available locations by running the command az account list-locations -o table.

Crie um hub IoTCreate an IoT hub

Crie um hub IoT com o comando az iot hub create.Create an IoT hub with the az iot hub create command.

O exemplo a seguir cria um hub IoT denominado my-sample-hub no local westus.The following example creates an IoT hub named my-sample-hub in the westus location. O nome de um Hub IoT deve ser globalmente exclusivo no Azure, de modo que talvez você queira adicionar um prefixo ou sufixo exclusivo ao nome de exemplo ou escolher um novo nome.An IoT hub name must be globally unique in Azure, so you may want to add a unique prefix or suffix to the example name, or choose a new name altogether. Certifique-se de que seu nome siga a convenção de nomenclatura adequada do hub IoT: ele deve ter de 3 a 50 caracteres de comprimento e conter somente caracteres alfanuméricos minúsculos ou hifens ('-').Make sure your name follows proper naming conventions for an IoT hub: it should be 3-50 characters in length, and can contain only upper or lower case alphanumeric characters or hyphens ('-').

az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus

Criar um Serviço de Provisionamento de DispositivosCreate a Device Provisioning Service

Crie um Serviço de Provisionamento de Dispositivos com o comando az iot dps create.Create a Device Provisioning Service with the az iot dps create command.

O exemplo a seguir cria um serviço de provisionamento denominado my-sample-dps na localização westus.The following example creates a provisioning service named my-sample-dps in the westus location. Você também precisará escolher um nome globalmente exclusivo para seu próprio serviço de provisionamento.You will also need to choose a globally unique name for your own provisioning service. Certifique-se de que ele siga a convenção de nomenclatura adequada para um Serviço de Provisionamento de Dispositivos no Hub IoT: ele deve ter de 3 a 64 caracteres de comprimento e conter somente caracteres alfanuméricos minúsculos ou hifens ('-').Make sure it follows proper naming conventions for an IoT Hub Device Provisioning Service: it should be 3-64 characters in length and can contain only upper or lower case alphanumeric characters or hyphens ('-').

az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus

Dica

O exemplo cria o serviço de provisionamento no local Oeste dos EUA.The example creates the provisioning service in the West US location. Você pode exibir uma lista de locais disponíveis executando o comando az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table ou acessando a página Status do Azure e pesquisando por "Serviço de Provisionamento de Dispositivos".You can view a list of available locations by running the command az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table or by going to the Azure Status page and searching for "Device Provisioning Service". Nos comandos, os locais podem ser especificados em formato de uma ou várias palavras, por exemplo, westus, West US, WEST US, etc. O valor não diferencia maiúsculas de minúsculas.In commands, locations can be specified either in one word or multi-word format; for example: westus, West US, WEST US, etc. The value is not case sensitive. Se você usar o formato de várias palavras para especificar o local, coloque o valor entre aspas, por exemplo, --location "West US".If you use multi-word format to specify location, enclose the value in quotes; for example, --location "West US".

Obter a cadeia de conexão para o hub IoTGet the connection string for the IoT hub

Você precisa da cadeia de conexão do seu hub IoT para vinculá-lo ao serviço de provisionamento de dispositivos.You need your IoT hub's connection string to link it with the Device Provisioning Service. Use o comando az iot hub show-connection-string para obter a cadeia de conexão e use a saída para definir uma variável que será usada quando for vincular os dois recursos.Use the az iot hub show-connection-string command to get the connection string and use its output to set a variable that you will use when you link the two resources.

O exemplo a seguir define a variável hubConnectionString como o valor da cadeia de conexão para a chave primária da política iothubowner do hub (o parâmetro --policy-name pode ser usado para especificar uma política diferente).The following example sets the hubConnectionString variable to the value of the connection string for the primary key of the hub's iothubowner policy (the --policy-name parameter can be used to specify a different policy). Troque my-sample-hub pelo nome exclusivo do Hub IoT escolhido anteriormente.Trade out my-sample-hub for the unique IoT hub name you chose earlier. O comando usa as opções consulta e saída da CLI do Azure para extrair a cadeia de conexão da saída do comando.The command uses the Azure CLI query and output options to extract the connection string from the command output.

hubConnectionString=$(az iot hub show-connection-string --name my-sample-hub --key primary --query connectionString -o tsv)

Você pode usar o comando echo para ver a cadeia de conexão.You can use the echo command to see the connection string.

echo $hubConnectionString

Observação

Esses dois comandos são válidos para um host executado em Bash.These two commands are valid for a host running under Bash.

Se você estiver usando um shell CMD/Windows local ou um host do PowerShell, modifique os comandos para usar a sintaxe correta do ambiente.If you're using a local Windows/CMD shell or a PowerShell host, modify the commands to use the correct syntax for that environment.

Se você estiver usando o Azure Cloud Shell, verifique se a lista suspensa ambiente no lado esquerdo da janela do shell diz Bash.If you're using Azure Cloud Shell, check that the environment drop-down on the left side of the shell window says Bash.

Vincule o hub IoT e o serviço de provisionamento ao comando az iot dps linked-hub create.Link the IoT hub and your provisioning service with the az iot dps linked-hub create command.

O exemplo a seguir vincula um hub IoT denominado my-sample-hub na localização westus e um serviço de provisionamento de dispositivos denominado my-sample-dps.The following example links an IoT hub named my-sample-hub in the westus location and a Device Provisioning Service named my-sample-dps. Troque esses nomes pelos nomes exclusivos do hub IoT e do Serviço de Provisionamento de Dispositivos escolhidos anteriormente.Trade out these names for the unique IoT hub and Device Provisioning Service names you chose earlier. O comando usa a cadeia de conexão para seu hub IoT que foi armazenada na variável hubConnectionString na etapa anterior.The command uses the connection string for your IoT hub that was stored in the hubConnectionString variable in the previous step.

az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --location westus

O comando pode demorar um pouco para ser concluído.The command may take a few minutes to complete.

Verificar o serviço de provisionamentoVerify the provisioning service

Obtenha os detalhes do seu serviço de provisionamento com o comando az iot dps show.Get the details of your provisioning service with the az iot dps show command.

O exemplo a seguir obtém os detalhes de um serviço de provisionamento denominado my-sample-dps.The following example gets the details of a provisioning service named my-sample-dps. Troque esse nome pelo nome de seu Serviço de Provisionamento de Dispositivos.Trade out this name for your own Device Provisioning Service name.

az iot dps show --name my-sample-dps

O hub IoT vinculado é mostrado na coleção properties.iotHubs.The linked IoT hub is shown in the properties.iotHubs collection.

Verificar o Serviço de Provisionamento

Limpar os recursosClean up resources

Outros inícios rápidos nessa coleção aproveitam esse início rápido.Other quickstarts in this collection build upon this quickstart. Se você planeja continuar trabalhando com inícios rápidos subsequentes ou com os tutoriais, não limpe os recursos criados nesse início rápido.If you plan to continue on to work with subsequent quickstarts or with the tutorials, do not clean up the resources created in this quickstart. Se você não planeja continuar, pode usar os comandos a seguir para excluir o serviço de provisionamento, o hub IoT ou o grupo de recursos e todos os seus recursos.If you do not plan to continue, you can use the following commands to delete the provisioning service, the IoT hub or the resource group and all of its resources. Substitua os nomes dos recursos escritos abaixo pelos nomes dos seus recursos.Replace the names of the resources written below with the names of your own resources.

Para excluir o serviço de provisionamento, execute o comando az iot dps delete:To delete the provisioning service, run the az iot dps delete command:

az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group

Para excluir o hub IoT, execute o comando az iot hub delete:To delete the IoT hub, run the az iot hub delete command:

az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group

Para excluir um grupo de recursos e todos os seus recursos, execute o comando az group delete:To delete a resource group and all its resources, run the az group delete command:

az group delete --name my-sample-resource-group

Próximas etapasNext steps

Neste Início Rápido, você implantou um Hub IoT e uma instância do Serviço de Provisionamento de Dispositivos, bem como vinculou os dois recursos.In this quickstart, you’ve deployed an IoT hub and a Device Provisioning Service instance, and linked the two resources. Para aprender a usar essa configuração a fim de provisionar um dispositivo simulado, prossiga para o Início Rápido de criação de dispositivo simulado.To learn how to use this setup to provision a simulated device, continue to the quickstart for creating a simulated device.