Краткое руководство. Настройка службы подготовки устройств к добавлению в Центр Интернета вещей с помощью Azure CLIQuickstart: Set up the IoT Hub Device Provisioning Service with Azure CLI

Azure CLI используется для создания ресурсов Azure и управления ими из командной строки или с помощью скриптов.The Azure CLI is used to create and manage Azure resources from the command line or in scripts. В этом кратком руководстве описано создание центра Интернета вещей и службы "Подготовка устройств к добавлению в Центр Интернета вещей" с помощью Azure CLI, а также связывание этих двух служб.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.

Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начать работу.If you don't have an Azure subscription, create a free account before you begin.

Важно!

Центр Интернета вещей и служба подготовки, которые вы создадите в рамках этого краткого руководства, будут общедоступными как конечные точки DNS,Both the IoT hub and the provisioning service you create in this quickstart will be publicly discoverable as DNS endpoints. поэтому не используйте конфиденциальную информацию при изменении имен этих ресурсов.Make sure to avoid any sensitive information if you decide to change the names used for these resources.

Предварительные требованияPrerequisites

  • Azure Cloud Shell можно использовать в среде Bash.Use Azure Cloud Shell using the bash environment.

    Внедрение запускаEmbed launch

  • При необходимости установите Azure CLI, чтобы выполнять справочные команды CLI.If you prefer, install Azure CLI to run CLI reference commands.

    • Если вы используете локальную установку, выполните вход с помощью команды Azure CLI az login.If you're using a local install, sign in with Azure CLI by using the az login command. Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала.To finish the authentication process, follow the steps displayed in your terminal. Сведения о дополнительных возможностях, доступных при входе, см. в статье Вход с помощью Azure CLI.See Sign in with Azure CLI for additional sign-in options.
    • Если появится запрос, установите расширения Azure CLI при первом использовании.When you're prompted, install Azure CLI extensions on first use. Дополнительные сведения о расширениях см. в статье Использование расширений с Azure CLI.For more information about extensions, see Use extensions with Azure CLI.
    • Выполните команду az version, чтобы узнать установленную версию и зависимые библиотеки.Run az version to find the version and dependent libraries that are installed. Чтобы обновиться до последней версии, выполните команду az upgrade.To upgrade to the latest version, run az upgrade.

Создание группы ресурсовCreate a resource group

Создайте группу ресурсов с помощью команды az group create.Create a resource group with the az group create command. Группа ресурсов Azure является логическим контейнером, в котором происходит развертывание ресурсов Azure и управление ими.An Azure resource group is a logical container into which Azure resources are deployed and managed.

В следующем примере создается группа ресурсов с именем my-sample-resource-group в расположении 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

Совет

В примере создается группа ресурсов в расположении западной части США.The example creates the resource group in the West US location. Список доступных расположений можно просмотреть, выполнив команду az account list-locations -o table.You can view a list of available locations by running the command az account list-locations -o table.

Создание Центра Интернета вещейCreate an IoT hub

Создайте Центр Интернета вещей с помощью команды az iot hub create.Create an IoT hub with the az iot hub create command.

В следующем примере создается Центр Интернета вещей с именем my-sample-hub в расположении westus.The following example creates an IoT hub named my-sample-hub in the westus location. Имя центра Интернета вещей должно быть глобально уникальным в Azure. Для этого можно добавить уникальный префикс или суффикс к имени примера или же вообще выбрать новое имя.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. Убедитесь, что это имя соответствует соглашению об именовании: оно должно быть длиной от 3 до 50 символов и может содержать только буквы верхнего или нижнего регистра, цифры или дефисы (-).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

Создание службы подготовки устройствCreate a Device Provisioning Service

Создайте службу подготовки устройств с помощью команды az iot dps create.Create a Device Provisioning Service with the az iot dps create command.

В следующем примере создается служба подготовки устройств с именем my-sample-dps в расположении westus.The following example creates a provisioning service named my-sample-dps in the westus location. Кроме того, нужно будет выбрать глобально уникальное имя для службы подготовки.You will also need to choose a globally unique name for your own provisioning service. Убедитесь, что это имя соответствует соглашению об именовании для Службы подготовки устройств к добавлению в Центр Интернета вещей: оно должно быть длиной от 3 до 64 символов и может содержать только буквы верхнего или нижнего регистра, цифры или дефисы.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

Совет

В примере создается служба подготовки устройств в расположении "Западная часть США".The example creates the provisioning service in the West US location. Чтобы просмотреть список доступных расположений, выполните команду az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table, или перейдите на страницу Состояние Azure и введите в строке поиска "Служба подготовки устройств".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". В командах расположения можно указать, используя одно слово или несколько. Например: westus, West US, WEST US и т. д. Обратите внимание, что регистр не учитывается.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. Если для указания расположения вы используете несколько слов, укажите значение поиска в кавычках, например --location "West US".If you use multi-word format to specify location, enclose the value in quotes; for example, --location "West US".

Получение строки подключения для Центра Интернета вещейGet the connection string for the IoT hub

Необходимо связать строку подключения Центра Интернета вещей со службой подготовки устройств.You need your IoT hub's connection string to link it with the Device Provisioning Service. Используйте команду az iot hub show-connection-string, чтобы получить строку подключения. Ее выходные данные потребуются, чтобы задать переменную, необходимую для связывания двух ресурсов.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.

В следующем примере переменной hubConnectionString задается значение строки подключения для первичного ключа политики iothubowner в центре (параметр --policy-name можно использовать для указания другой политики).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). Замените my-sample-hub на уникальное имя центра Интернета вещей, которое вы выбрали ранее.Trade out my-sample-hub for the unique IoT hub name you chose earlier. Для извлечения строки подключения из выходных данных команды в Azure CLI в ней используются параметры query и output.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)

Чтобы получить строку подключения, можно использовать команду echo.You can use the echo command to see the connection string.

echo $hubConnectionString

Примечание

Эти две команды можно использовать для узла, где работает Bash.These two commands are valid for a host running under Bash.

Если вы используете локальную оболочку Windows или CMD либо узел PowerShell, измените команды, чтобы использовать правильный синтаксис для этой среды.If you're using a local Windows/CMD shell or a PowerShell host, modify the commands to use the correct syntax for that environment.

Если вы используете Azure Cloud Shell, убедитесь, что в раскрывающемся списке со средами в левой части окна оболочки указано Bash.If you're using Azure Cloud Shell, check that the environment drop-down on the left side of the shell window says Bash.

Свяжите Центр Интернета вещей со службой подготовки устройств с помощью команды az iot dps linked-hub create.Link the IoT hub and your provisioning service with the az iot dps linked-hub create command.

В следующем примере связываются центр Интернета вещей с именем my-sample-hub в расположении westus и служба подготовки устройств с именем 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. Замените эти имена на уникальные имена центра Интернета вещей и службы подготовки устройств, которые вы выбрали ранее.Trade out these names for the unique IoT hub and Device Provisioning Service names you chose earlier. В команде используется строка подключения для центра Интернета вещей, сохраненная в переменной hubConnectionString на предыдущем шаге.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

Выполнение этой команды может занять несколько минут.The command may take a few minutes to complete.

Проверка службы подготовки устройствVerify the provisioning service

Получите сведения о службе подготовки устройств, выполнив команду az iot dps show.Get the details of your provisioning service with the az iot dps show command.

В следующем примере возвращаются сведения о службе подготовки устройств с именем my-sample-dps.The following example gets the details of a provisioning service named my-sample-dps. Замените это имя на собственное имя службы подготовки устройств.Trade out this name for your own Device Provisioning Service name.

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

Связанный Центр Интернета вещей отображается в коллекции properties.iotHubs.The linked IoT hub is shown in the properties.iotHubs collection.

Проверка службы подготовки устройств

Очистка ресурсовClean up resources

Другие краткие руководства в этой коллекции созданы на основе этого документа.Other quickstarts in this collection build upon this quickstart. Если вы планируете продолжать работу с этими руководствами по быстрому запуску или обычными руководствами, не удаляйте созданные ресурсы.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. Если же вы не планируете продолжать работу, вы можете использовать команды ниже, чтобы удалить службу подготовки устройств, Центр Интернета вещей или группу ресурсов со всеми связанными ресурсами.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. Замените имена ресурсов, указанные ниже, именами собственных ресурсов.Replace the names of the resources written below with the names of your own resources.

Чтобы удалить службу подготовки устройств, выполните команду 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

Чтобы удалить Центр Интернета вещей, выполните команду 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

Чтобы удалить группу ресурсов со всеми связанными ресурсами, выполните команду 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

Дальнейшие действияNext steps

Вы развернули центр Интернета вещей и экземпляр службы подготовки устройств, а затем связали эти два ресурса.In this quickstart, you’ve deployed an IoT hub and a Device Provisioning Service instance, and linked the two resources. Чтобы узнать, как подготовить виртуальное устройство, см. краткое руководство по созданию имитированного устройства.To learn how to use this setup to provision a simulated device, continue to the quickstart for creating a simulated device.