Поделиться через

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

  • Статья

Внимание

Это документация по Azure Sphere (устаревшая версия). Служба Azure Sphere (устаревшая версия) выходит на пенсию 27 сентября 2027 г., и к этому времени пользователи должны перейти в Azure Sphere (интегрированная). Используйте селектор версий, расположенный над toC, чтобы просмотреть документацию по Azure Sphere (интегрированная).

В этом разделе описано, как управлять группами устройств с помощью интерфейса командной строки или Обозревателя Azure Sphere. В этом разделе предполагается, что вы знакомы с понятиями клиентов, продуктов и групп устройств Azure Sphere.

Вывод списка групп устройств

Вывод списка всех групп устройств в клиенте Azure Sphere с помощью команды azsphere device-group list или с помощью API списка "Группа устройств".

Список всех групп устройств:

azsphere device-group list

Выведите список групп устройств в определенном продукте с помощью команды azsphere product device-group list или с помощью API "Product - List Groups".

azsphere product device-group list --product <product-name>

Совет

Чтобы вывести список всех продуктов в клиенте Azure Sphere, выполните azsphere product list. Если нет перечисленных продуктов, создайте продукт.

Чтобы вывести список всех устройств в клиенте Azure Sphere, выполните azsphere device list. В выходных данных отображается группа продуктов и устройств, в которой существует устройство.

  1. Откройте Обозреватель Azure Sphere.

  2. Разверните узел клиента для интересующего вас клиента.

  1. Откройте Обозреватель Azure Sphere.

  2. Разверните узел клиента для интересующего вас клиента.

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

  1. Откройте Обозреватель Azure Sphere.

  2. Разверните узел клиента для интересующего вас клиента.

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

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

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

  1. Откройте Обозреватель Azure Sphere.

  2. Разверните узел клиента для интересующего вас клиента.

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

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

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

Создайте группу устройств с помощью команды azsphere device-group create или с помощью группы устройств — создание API.

Чтобы создать группу устройств, сделайте следующее:

azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>

Имена групп устройств могут содержать только буквенно-цифровые символы и пробелы. Они не могут превышать 50 символов. Если имя или описание содержит пробелы, заключите его в кавычки.

Можно включить следующие необязательные параметры:

  • --os-feed указывает тип веб-канала ОС, используемый для обновлений ОС.
  • --application-update задает политику обновлений приложений для этой группы устройств.

  1. Откройте Обозреватель Azure Sphere.

  2. Для интересующего вас клиента разверните узел Product.

  3. Для интересующего вас продукта щелкните правой кнопкой мыши и выберите новую группу устройств.

  4. Укажите имя группы устройств и нажмите клавишу ВВОД. Имена групп устройств могут содержать только буквенно-цифровые символы и пробелы. Они не могут превышать 50 символов. Если указать недопустимое имя, в окне вывода сообщается ошибка.

Вы можете создать группу устройств в Visual Studio Code, но не удалить ее. Чтобы удалить группу устройств, используйте команду azsphere device-group delete или общедоступный API Azure Sphere.

  1. Откройте Обозреватель Azure Sphere.

  2. Для интересующего вас клиента разверните узел Product.

  3. Для интересующего вас продукта щелкните правой кнопкой мыши и выберите новую группу устройств.

  4. Укажите имя группы устройств и нажмите клавишу ВВОД или нажмите кнопку "Применить". Имена групп устройств могут содержать только буквенно-цифровые символы и пробелы. Они не могут превышать 50 символов. Если указать недопустимое имя, в окне вывода сообщается ошибка.

Вы можете создать группу устройств в Visual Studio, но не удалить ее. Чтобы удалить продукты, используйте команду azsphere device-group delete или общедоступный API Azure Sphere.

Обновление группы устройств

Имя или описание группы устройств можно изменить с помощью команды azsphere device-group update или с помощью API исправлений для группы устройств.

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

azsphere device-group update --device-group <device group ID or product-name/device-group-name> --new-name <new-device-group-name> --new-description <new-device-group-description>

Вы также можете обновить os-feed параметры с application-update помощью команды azsphere device-group update.

  1. Откройте Обозреватель Azure Sphere.

  2. Для интересующего вас клиента разверните узел Product.

  3. Для интересующего вас продукта разверните узел продукта, чтобы отобразить включенные группы устройств. Вы можете переименовать группу устройств или обновить его описание, тип веб-канала ОС или политику обновления:

  • Чтобы переименовать группу устройств, щелкните правой кнопкой мыши имя группы устройств и выберите "Переименовать", введите новое имя и нажмите клавишу ВВОД. Имена групп устройств могут содержать только буквенно-цифровые символы и пробелы. Они не могут превышать 50 символов. Если указать недопустимое имя, в окне вывода сообщается ошибка.

  • Чтобы обновить описание группы устройств, щелкните правой кнопкой мыши имя группы устройств и выберите "Обновить описание", введите новое описание и нажмите клавишу ВВОД.

  • Чтобы обновить тип веб-канала ОС, разверните группу устройств, щелкните правой кнопкой мыши тип веб-канала ОС, выберите "Обновить", а затем выберите "Розничная" или "Розничная торговля".

  • Чтобы изменить политику обновления, разверните группу устройств, щелкните правой кнопкой мыши политику обновления, выберите "Обновить", а затем в меню выберите No3rdPartyAppUpdates или UpdateAll. (Третий вариант, NoUpdates в настоящее время зарезервирован для внутреннего использования. Если этот параметр выбран, в окне вывода сообщается сообщение об ошибке.)

Переместите устройство в другую группу устройств с помощью команды azsphere device update или с помощью API перемещения устройств.

  1. Откройте Обозреватель Azure Sphere.

  2. Для интересующего вас клиента разверните узел Product.

  3. Для интересующего вас продукта разверните узел продукта, чтобы отобразить включенные группы устройств. Вы можете переименовать группу устройств или обновить его описание, тип веб-канала ОС или политику обновления:

  • Чтобы переименовать группу устройств, выберите имя группы устройств и нажмите клавишу F2 или щелкните правой кнопкой мыши имя группы устройств и выберите "Переименовать", введите новое имя и нажмите клавишу ВВОД или нажмите кнопку "Применить". Имена групп устройств могут содержать только буквенно-цифровые символы и пробелы. Они не могут превышать 50 символов. Если указать недопустимое имя, в окне вывода сообщается ошибка.

  • Чтобы обновить описание группы устройств, разверните группу устройств, выберите "Описание" и нажмите клавишу F2 или щелкните "Описание" правой кнопкой мыши и выберите "Изменить", введите новое описание и нажмите клавишу ВВОД или нажмите кнопку "Применить".

  • Чтобы обновить тип веб-канала ОС, разверните группу устройств, выберите тип веб-канала ОС и нажмите клавишу F2 или щелкните правой кнопкой мыши тип веб-канала ОС и выберите "Изменить", выберите "Розничная" или "Розничная торговля " в меню, а затем нажмите клавишу ВВОД или нажмите кнопку "Применить".

  • Чтобы изменить политику обновления, разверните группу устройств, выберите "Обновить политику" и нажмите клавишу F2 или щелкните правой кнопкой мыши "Обновить политику" и выберите "Изменить", выберите "No3rdPartyAppUpdates" или UpdateAll в меню, а затем нажмите клавишу ВВОД или нажмите кнопку "Применить". (Третий вариант, NoUpdates в настоящее время зарезервирован для внутреннего использования. Если этот параметр выбран, в окне вывода сообщается сообщение об ошибке.

Переместите устройство в другую группу устройств с помощью команды azsphere device update или с помощью API перемещения устройств.

Перемещение устройства в другую группу устройств

Переместите устройство в другую группу устройств с помощью команды azsphere device update или с помощью API перемещения устройств.

Укажите идентификатор группы устройств или сочетание имени продукта и группы устройств в <формате product-name>/<device-group-name> :

azsphere device update --device-group <device-group-id>

azsphere device update --device-group <product-name/device-group-name>

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

Удалите указанную группу устройств в клиенте Azure Sphere с помощью команды azsphere device-group delete или с помощью API удаления.

Группу устройств можно удалить только в том случае, если:

  • У пользователя есть разрешения администратора для клиента.
  • Группа устройств пуста и не имеет в ней устройств. Команда azsphere device-group device list выводит список всех устройств в группе устройств. Запустите azsphere device update --device-group , чтобы переместить устройство в другую группу устройств.

Укажите идентификатор группы устройств или сочетание имени продукта и группы устройств в <формате product-name>/<device-group-name> :

azsphere device-group delete --device-group <device-group-id>

azsphere device-group delete --device-group <product-name/device-group-name>