Управление группами устройств для обновления устройств Azure для Центр Интернета вещей

Обновление устройств Azure для Центр Интернета вещей позволяет развертывать обновления в определяемых пользователем группах устройств Интернета вещей. Каждое управляемое устройство с обновлением устройств является членом группы устройств, но определение групп устройств является необязательным. Можно также развернуть в группе устройств по умолчанию, которую предоставляет обновление устройства.

При создании и назначении определяемых пользователем значений тегов обновления устройств для устройств обновление устройств автоматически создает группы на основе назначенных тегов и свойств совместимости устройств. Для каждой группы устройств обновление устройств может создавать несколько подгрупп с различными классами устройств. Обновление устройства помещает устройства без тегов в default группе устройств.

В этой статье описывается, как использовать портал Azure или Azure CLI для создания тегов и групп устройств, определенных пользователем. Сведения о развертывании обновлений в определяемых пользователем группах устройств или группах устройств по умолчанию см. в статье "Развертывание обновления устройства".

Необходимые компоненты

Портал Azure

• Стандартный (S1) или более высокий экземпляр Центр Интернета вещей Azure с обновлением устройства для Центр Интернета вещей включен.
• Устройство Интернета вещей или симулятор , подготовленный для обновления устройств в Центре Интернета вещей.
• Агент обновления устройств установлен и запущен на устройстве как удостоверение на уровне модуля или устройства.
• Импортированное обновление для подготовленного устройства.

Azure CLI

• Стандартный (S1) или более высокий экземпляр Центр Интернета вещей Azure с обновлением устройства для Центр Интернета вещей включен.

• Устройство Интернета вещей или симулятор , подготовленный для обновления устройств в Центре Интернета вещей.

• Агент обновления устройств установлен и запущен на устройстве как удостоверение на уровне модуля или устройства.

• Импортированное обновление для подготовленного устройства.

• Среда Bash в Azure Cloud Shell для выполнения команд Azure CLI. Выберите "Запустить Cloud Shell", чтобы открыть Cloud Shell, или щелкните значок Cloud Shell на верхней панели инструментов портал Azure.

  

  Примечание.

  Если вы предпочитаете, вы можете выполнять команды Azure CLI локально:

  1. Установка Azure CLI. Запустите az version , чтобы просмотреть установленную версию Azure CLI и зависимые библиотеки, а затем запустите az upgrade , чтобы установить последнюю версию.
  2. Войдите в Azure, выполнив команду az login.
  3. azure-iot Установите расширение при появлении запроса на первое использование. Чтобы убедиться, что вы используете последнюю версию расширения, выполните команду az extension update --name azure-iot.

Добавление тегов на устройства

Чтобы назначить группу устройств обновления устройств, добавьте ADUGroup тег в целевой набор подключенных устройств обновления устройств в Центр Интернета вещей. Добавьте тег в двойник устройства, если агент обновления устройств подготовлен с удостоверением устройства или в соответствующий двойник модуля, если агент обновления устройств подготовлен с удостоверением модуля.

Тег обновления ADUGroup устройств использует формат "ключ-значение", как показано в следующем примере двойника устройства или модуля:

"etag": "",
"deviceId": "",
"deviceEtag": "",
"version": <version>,
"tags": {
   "ADUGroup": "<CustomTagValue>"
}

Дополнительные сведения и примеры синтаксиса JSON двойников см. в статье "Общие сведения о двойниках устройств" или "Общие сведения о двойниках модулей" и "Использование".

Тег ADUGroup имеет следующие свойства и ограничения:

• Устройство может иметь только один ADUGroup тег и принадлежать только одной группе обновления устройств одновременно. Добавление другого тега с именем ADUGroup переопределяет существующее ADUGroup значение.
• Можно использовать любое значение для тега, кроме зарезервированных значений Uncategorized и $default.
• Значение тега не может превышать 200 символов.
• Значение тега может содержать буквенно-цифровые символы и следующие специальные символы: . - _ ~
• Значения ADUGroup имени тега и имени группы чувствительны к регистру.

В следующих разделах описано несколько способов добавления и обновления тега.

Добавление тегов с пакетами SDK

Вы можете обновить двойник устройства или модуля с соответствующим тегом с помощью RegistryManager после регистрации устройства с помощью обновления устройства. Дополнительные сведения см. в следующих статьях:

• Начало работы с двойниками устройств с помощью .NET
• Общие сведения о формате тегов и свойств

Добавление тегов с помощью заданий

Вы можете запланировать задания для добавления или обновления тегов обновления устройств на нескольких устройствах. Примеры операций заданий см. в разделе "Расписание заданий" на нескольких устройствах. Вы можете обновить двойники устройств или двойники модулей с помощью заданий в зависимости от того, подготовлен ли агент обновления устройств с помощью удостоверения устройства или модуля. Дополнительные сведения см. в разделе "Расписание и широковещательные задания".

Примечание.

Эта операция учитывает квоту Центр Интернета вещей сообщений. Если вы изменяете 50 000 или более тегов двойников устройств или модулей за раз, вы можете превысить квоту ежедневного сообщения Центр Интернета вещей и приобрести больше единиц Центр Интернета вещей. Дополнительные сведения см. в разделе "Квоты" и "Регулирование".

Добавление тегов путем обновления двойников

Вы также можете добавить или обновить ADUGroup тег непосредственно в двойнике устройства или модуля.

Портал Azure

1. Найдите нужный Центр Интернета вещей на портале Azure.

2. Выберите устройства в разделе "Управление устройствами" в области навигации слева. Если у вас есть устройство IoT Edge, выберите IoT Edge .

3. На странице "Устройства" выберите устройство.

4. На странице устройства выберите двойник устройства в верхнем меню или выберите удостоверение модуля в разделе "Удостоверения модуля", а затем выберите двойник модуля.

5. В двойнике добавьте ADUGroup тег с определяемым пользователем значением, как показано ниже. Чтобы обновить существующее ADUGroup значение тега, перезаписать его другим пользовательским значением.

       "tags": {
               "ADUGroup": "<CustomTagValue>"
               }
   

6. Выберите Сохранить.

Azure CLI

Используйте az iot hub device-twin update или az iot hub module-twin update, чтобы добавить тег в ADUGroup двойник устройства или модуля с соответствующим значением. Для обеих update команд --tags аргумент принимает встроенный json или путь к JSON-файлу.

Например:

az iot hub module-twin update \
    --hub-name <IoT hub name> \
    --device-id <device name> \
    --module-id <module name> \
    --tags '{"ADUGroup": "<custom_tag_value"}'

Просмотр групп устройств

Портал Azure

1. В портал Azure перейдите в центр Интернета вещей, подключенный к экземпляру обновления устройств.

2. Выберите параметр "Обновления" в разделе Управление устройствами в области навигации слева.

3. Перейдите на вкладку "Группы и развертывания".

   

После создания группы будет обновлена диаграмма соответствия требованиям и список групп. На диаграмме соответствия обновлений устройств отображается количество устройств в различных состояниях соответствия требованиям: при последнем обновлении, новых доступных обновлениях и обновлениях. Дополнительные сведения см. в разделе "Соответствие обновлению устройств".

Существующие группы обновления устройств и все доступные обновления для устройств в этих группах отображаются в списке групп. Все устройства, которые не соответствуют требованиям класса устройства группы, отображаются в соответствующей недопустимой группе. Вы можете развернуть лучшее доступное обновление в группе из этого представления, нажав кнопку "Развернуть рядом с группой".

Azure CLI

Используйте az iot du device group list для просмотра всех групп устройств в экземпляре обновления устройств.

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>

Аргумент можно использовать --order-by для упорядочивания возвращаемого списка по таким аспектам, как идентификатор группы, количество устройств или количество подгрупп с доступными новыми обновлениями.

Просмотр сведений об устройстве для группы

Портал Azure

1. На вкладке "Группы и развертывания" выберите имя группы.

   На странице сведений о группе показана диаграмма соответствия обновлений с количеством устройств-членов группы в различных состояниях соответствия, а также список устройств-членов группы со своими свойствами обновления устройства.

   

2. Выберите отдельное устройство в группе, чтобы перейти на страницу сведений об устройстве в Центр Интернета вещей.

   

   

Azure CLI

Используйте az iot du device group show для просмотра сведений о конкретной группе устройств.

• Необязательный --best-updates флаг возвращает список лучших доступных обновлений для группы устройств, включая количество устройств, необходимых каждому обновлению.

• Необязательный --update-compliance флаг возвращает сведения о соответствии для группы устройств, включая количество устройств в последнем обновлении, необходимость новых обновлений или наличие обновлений.

az iot du device group show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <value of the ADUGroup tag for this group>
    --best-updates
    --update-compliance

Удаление устройства из группы устройств

Чтобы удалить устройство из группы устройств, измените ADUGroup значение null тега на двойник и нажмите кнопку "Сохранить".

    "tags": {
            "ADUGroup": "null"
            }

Это действие удаляет тег группы из двойника устройства и удаляет устройство из группы устройств.

Удаление группы устройств

Обновление устройства автоматически создает группы устройств и сохраняет группы устройств, классы устройств и развертывания для исторических записей или других пользователей, а не автоматически очищает их. Группы устройств можно удалить с помощью портал Azure, выбрав и удалив группы или вызвав az iot du device group delete команду Azure CLI в группе.

Чтобы удалить, группа должна соответствовать следующим требованиям:

• Не должно быть default группой.
• Не должно быть устройств-членов. То есть в экземпляре обновления устройств не может быть ADUGroup тег со значением, соответствующим имени группы.
• Не должно быть связанных активных или отмененных развертываний.

Примечание.

Если вы не можете удалить группу, которая соответствует приведенным выше требованиям, проверьте наличие неработоспособных устройств, помеченных как часть группы. Неработоспособные устройства не могут получать развертывание, поэтому они не отображаются непосредственно в списке устройств-участников в группе.

Чтобы проверить наличие неработоспособных устройств, выполните следующие действия.

1. Найдите нужный Центр Интернета вещей на портале Azure.
2. Выберите "Обновления" в области навигации слева и перейдите на вкладку "Диагностика ".
3. Разверните раздел "Поиск отсутствующих устройств".

Если у вас есть неработоспособные устройства, помеченные как часть группы, необходимо изменить значение тега или удалить устройство, прежде чем удалить группу.

Если устройство когда-либо назначается удаленному имени группы снова, обновление устройства автоматически повторно создает группу, но не связанная с ним история устройства или развертывания.

Связанный контент

• Группы устройств
• Соответствие обновлений устройств
• Развертывание обновления