device-group
Внимание
Это документация по Azure Sphere (устаревшая версия). Служба Azure Sphere (устаревшая версия) выходит на пенсию 27 сентября 2027 г., и к этому времени пользователи должны перейти в Azure Sphere (интегрированная). Используйте селектор версий, расположенный над toC, чтобы просмотреть документацию по Azure Sphere (интегрированная).
Создает и управляет группами устройств.
Обращение к группам устройств выполняется по идентификатору группы или по паре имени продукта и имени группы устройств.
| Операция | Description |
|---|---|
| создание | Создает новую группу устройств. |
| список | Список всех групп устройств в клиенте Azure Sphere. |
| Удаление | Удаляет существующую группу устройств. |
| deployment | Управляет развертываниями в группе устройств. |
| device | Перечисляет устройства в группе устройств. |
| show | Отображает сведения о группе устройств. |
| обновить | Изменяет существующую группу устройств. |
create
Создает группу устройств с указанным именем для указанного продукта. Группа устройств позволяет упорядочить устройства, которые относятся к одному продукту и получают из облака одинаковые приложения.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -p, --product | GUID или имя | Указывает продукт, в который нужно добавить эту группу устройств. Можно указать идентификатор или имя продукта Azure Sphere. |
| -n, --name | Строка | Указывает имя группы устройств. Имя может содержать только буквенно-цифровые символы. Если имя содержит пробелы, заключите его в двойные кавычки. Имя группы устройств не может превышать 50 символов, не учитывает регистр, должен быть уникальным в пределах продукта. |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -a, --application-update | Перечисление | Указывает политику обновления приложения, применяемую для этой группы устройств. Допустимые значения: No3rdPartyAppUpdates, UpdateAllи NoUpdates. По умолчанию — UpdateAll. Политика NoUpdates в настоящее время зарезервирована только для внутреннего использования. |
| -f, --os-feed | Перечисление | Указывает тип веб-канала ОС, используемый для обновлений ОС. Допустимые значения: Retail, RetailEval. |
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
| -d, --description | Строка | Указывает необязательный текст для описания группы устройств. Максимальная длина составляет 100 символов. Если описание содержит пробелы, заключите его в кавычки. |
| -r, --regional-data-гранич | Строка | Граница региональных данных для этого изображения. Допустимые значения: EU, None. Значение по умолчанию — None. Если значение не указано, будет использоваться значение по умолчанию. Дополнительные сведения см. в разделе "Настройка аварийных дампов" — рекомендации по pivacy |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --debug | Увеличивает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах и списках доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляя предупреждения. |
| -o, --output | Изменяет формат выходных данных. Доступные форматы выходных данных : jsonc, jsonc (цветной JSON), tsv (значения с разделительными табуляциями), таблица (таблицы ASCII, доступные для чтения человека) и yaml. По умолчанию CLI выводит формат table. Дополнительные сведения о доступных форматах выходных данных см. в разделе "Формат выходных данных" для команд Azure Sphere CLI. |
| --query | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см . в руководстве по JMESPath и выходным данным команды Azure CLI. |
| --verbose | Выводит сведения о ресурсах, созданных в Azure Sphere во время операции, и другие полезные сведения. Используйте параметр--debug, чтобы включить полные журналы отладки. |
Примечание.
Если вы используете классический интерфейс командной строки Azure Sphere, дополнительные сведения о доступных параметрах см. в статье "Глобальные параметры ".
Пример
azsphere device-group create --name Marketing --product DW100
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- ---------------------
Id TenantId OsFeedType ProductId Name UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
===================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
список
Список всех групп устройств в клиенте Azure Sphere.
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --debug | Увеличивает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах и списках доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляя предупреждения. |
| -o, --output | Изменяет формат выходных данных. Доступные форматы выходных данных : jsonc, jsonc (цветной JSON), tsv (значения с разделительными табуляциями), таблица (таблицы ASCII, доступные для чтения человека) и yaml. По умолчанию CLI выводит формат table. Дополнительные сведения о доступных форматах выходных данных см. в разделе "Формат выходных данных" для команд Azure Sphere CLI. |
| --query | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см . в руководстве по JMESPath и выходным данным команды Azure CLI. |
| --verbose | Выводит сведения о ресурсах, созданных в Azure Sphere во время операции, и другие полезные сведения. Используйте параметр--debug, чтобы включить полные журналы отладки. |
Примечание.
Если вы используете классический интерфейс командной строки Azure Sphere, дополнительные сведения о доступных параметрах см. в статье "Глобальные параметры ".
Пример
azsphere device-group list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- ---------------------
Id Name Description ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
=====================================================================================================================================================================================================================================================================================
a3a49688-4601-4422-8b51-a0838ea84627 Development Default development device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept only system software updates. Don't accept application updates. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
7cb46b96-8c17-4afd-bd3f-614acad9d264 Field Test Default test device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
30c39bae-f525-4094-8008-d03705429ef0 Production Default production device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
cb5c9685-5dbe-470c-91a9-91dc129884d6 Production OS Evaluation Default Production OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
63e72035-3fcf-4fdc-b88a-05e30d1ba224 Field Test OS Evaluation Default Field Test OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
удалить
Удаляет указанную группу устройств в клиенте Azure Sphere.
Группу устройств можно удалить только в том случае, если:
- У пользователя есть разрешения администратора для клиента.
- Группа устройств пуста и не имеет в ней устройств. Команда azsphere device-group device list выводит список всех устройств в группе устройств. Запустите azsphere device update --device-group , чтобы переместить устройство в другую группу устройств.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -g, --device-group | Строка | Указывает группу устройств для удаления. Можно указать идентификатор группы устройств или имя группы устройств. Чтобы использовать имя группы устройств, необходимо указать имя продукта и имя группы устройств в <product-name/device-group-name> формате. |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --debug | Увеличивает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах и списках доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляя предупреждения. |
| -o, --output | Изменяет формат выходных данных. Доступные форматы выходных данных : jsonc, jsonc (цветной JSON), tsv (значения с разделительными табуляциями), таблица (таблицы ASCII, доступные для чтения человека) и yaml. По умолчанию CLI выводит формат table. Дополнительные сведения о доступных форматах выходных данных см. в разделе "Формат выходных данных" для команд Azure Sphere CLI. |
| --query | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см . в руководстве по JMESPath и выходным данным команды Azure CLI. |
| --verbose | Выводит сведения о ресурсах, созданных в Azure Sphere во время операции, и другие полезные сведения. Используйте параметр--debug, чтобы включить полные журналы отладки. |
Примечание.
Если вы используете классический интерфейс командной строки Azure Sphere, дополнительные сведения о доступных параметрах см. в статье "Глобальные параметры ".
Пример
azsphere device-group delete --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Successfully deleted the device group
azsphere device-group delete --device-group DW100/Development
Successfully deleted the device group
развертывание
Позволяет управлять развертываниями для группы устройств.
| Операция | Description |
|---|---|
| создание | Создает развертывание для указанной группы устройств. |
| список | Отображает список развертываний для группы устройств. |
deployment create
Создает новое развертывание для группы устройств с предоставленными образами.
Вы можете указать группу устройств по идентификатору группы или по паре имени продукта и имени группы устройств.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -g, --device-group | Строка | Указывает группу устройств, в которой необходимо создать развертывание. Можно указать идентификатор группы устройств или имя группы устройств. Чтобы использовать имя группы устройств, необходимо указать имя продукта и имя группы устройств в <product-name/device-group-name> формате. |
| -i, --images | Строка | Указывает идентификаторы изображений для одного или нескольких образов, которые необходимо включить в развертывание. Можно добавить несколько изображений, добавив дополнительные параметры или несколько идентификаторов изображений, можно объединить в одном параметре в разделенном пробелом списке. Выполните команду azsphere image add, чтобы получить идентификатор образа. |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --debug | Увеличивает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах и списках доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляя предупреждения. |
| -o, --output | Изменяет формат выходных данных. Доступные форматы выходных данных : jsonc, jsonc (цветной JSON), tsv (значения с разделительными табуляциями), таблица (таблицы ASCII, доступные для чтения человека) и yaml. По умолчанию CLI выводит формат table. Дополнительные сведения о доступных форматах выходных данных см. в разделе "Формат выходных данных" для команд Azure Sphere CLI. |
| --query | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см . в руководстве по JMESPath и выходным данным команды Azure CLI. |
| --verbose | Выводит сведения о ресурсах, созданных в Azure Sphere во время операции, и другие полезные сведения. Используйте параметр--debug, чтобы включить полные журналы отладки. |
Примечание.
Если вы используете классический интерфейс командной строки Azure Sphere, дополнительные сведения о доступных параметрах см. в статье "Глобальные параметры ".
Пример
Параметр --device-group определяет группу устройств. Идентификатор группы устройств предоставляет GUID, который однозначно определяет группу устройств во всех продуктах. Кроме того, можно использовать пару имен продукта и группы устройств в <формате product-name>/<device-group-name> . Эта пара имен однозначно определяет группу устройств для конкретного продукта.
Пример указания группы устройств по идентификатору:
azsphere device-group deployment create --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Пример указания группы устройств по имени:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Пример указания нескольких идентификаторов изображений путем предоставления списка значений, разделенных пробелами:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1 3bbd2d2a-2870-4dde-9db8-ae50548ea7b4
Вы должны увидеть примерно такой результат:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb 5572509b-43a4-45b0-88c5-365cbf9732c1 2021-04-01T18:48:41.721662+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
deployment list
Отображает историю развертываний для группы устройств. Возвращает идентификатор развертывания, метку времени и список включенных образов. Список упорядочивается по убыванию актуальности развертываний.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -g, --device-group | Строка | Указывает группу устройств, для которой будет отображаться список журналов развертывания. Можно указать идентификатор группы устройств или имя группы устройств. Чтобы использовать имя группы устройств, необходимо указать имя продукта и имя группы устройств в <product-name/device-group-name> формате. |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --debug | Увеличивает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах и списках доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляя предупреждения. |
| -o, --output | Изменяет формат выходных данных. Доступные форматы выходных данных : jsonc, jsonc (цветной JSON), tsv (значения с разделительными табуляциями), таблица (таблицы ASCII, доступные для чтения человека) и yaml. По умолчанию CLI выводит формат table. Дополнительные сведения о доступных форматах выходных данных см. в разделе "Формат выходных данных" для команд Azure Sphere CLI. |
| --query | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см . в руководстве по JMESPath и выходным данным команды Azure CLI. |
| --verbose | Выводит сведения о ресурсах, созданных в Azure Sphere во время операции, и другие полезные сведения. Используйте параметр--debug, чтобы включить полные журналы отладки. |
Примечание.
Если вы используете классический интерфейс командной строки Azure Sphere, дополнительные сведения о доступных параметрах см. в статье "Глобальные параметры ".
Пример
Пример указания группы устройств по идентификатору:
azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Пример указания группы устройств по имени:
azsphere device-group deployment list --device-group DW100/Development
Вы должны увидеть примерно такой результат:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb e3769536-dc4b-48d9-afd4-22ed321ba4bc 2020-11-18T19:46:50.514429+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
device
Позволяет управлять устройствами для группы устройств.
| Операция | Description |
|---|---|
| список | Отображает список устройств, входящих в группу устройств. |
| show-count | Отображает число устройств в группе устройств. |
device list
Отображает список устройств, входящих в группу устройств.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -g, --device-group | Строка | Указывает группу устройств, для которой будет отображаться список устройств. Можно указать идентификатор группы устройств или имя группы устройств. Чтобы использовать имя группы устройств, необходимо указать имя продукта и имя группы устройств в <product-name/device-group-name> формате. |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --debug | Увеличивает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах и списках доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляя предупреждения. |
| -o, --output | Изменяет формат выходных данных. Доступные форматы выходных данных : jsonc, jsonc (цветной JSON), tsv (значения с разделительными табуляциями), таблица (таблицы ASCII, доступные для чтения человека) и yaml. По умолчанию CLI выводит формат table. Дополнительные сведения о доступных форматах выходных данных см. в разделе "Формат выходных данных" для команд Azure Sphere CLI. |
| --query | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см . в руководстве по JMESPath и выходным данным команды Azure CLI. |
| --verbose | Выводит сведения о ресурсах, созданных в Azure Sphere во время операции, и другие полезные сведения. Используйте параметр--debug, чтобы включить полные журналы отладки. |
Примечание.
Если вы используете классический интерфейс командной строки Azure Sphere, дополнительные сведения о доступных параметрах см. в статье "Глобальные параметры ".
Пример
Пример указания группы устройств по идентификатору:
azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Пример указания группы устройств по имени:
azsphere device-group device list --device-group DW100/Marketing
Вы должны увидеть примерно такой результат:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
device show-count
Отображает число устройств в группе устройств.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -g, --device-group | Строка | Указывает группу устройств, для которой отображается число устройств. Можно указать идентификатор группы устройств или имя группы устройств. Чтобы использовать имя группы устройств, необходимо указать имя продукта и имя группы устройств в <product-name/device-group-name> формате. |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --debug | Увеличивает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах и списках доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляя предупреждения. |
| -o, --output | Изменяет формат выходных данных. Доступные форматы выходных данных : jsonc, jsonc (цветной JSON), tsv (значения с разделительными табуляциями), таблица (таблицы ASCII, доступные для чтения человека) и yaml. По умолчанию CLI выводит формат table. Дополнительные сведения о доступных форматах выходных данных см. в разделе "Формат выходных данных" для команд Azure Sphere CLI. |
| --query | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см . в руководстве по JMESPath и выходным данным команды Azure CLI. |
| --verbose | Выводит сведения о ресурсах, созданных в Azure Sphere во время операции, и другие полезные сведения. Используйте параметр--debug, чтобы включить полные журналы отладки. |
Примечание.
Если вы используете классический интерфейс командной строки Azure Sphere, дополнительные сведения о доступных параметрах см. в статье "Глобальные параметры ".
Пример
Пример указания группы устройств по идентификатору:
azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Пример указания группы устройств по имени:
azsphere device-group device show-count --device-group DW100/Marketing
Вы должны увидеть примерно такой результат:
------
Result
======
1
------
show
Возвращает сведения об группе устройств.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -g, --device-group | Строка | Указывает группу устройств, для которой будут отображаться сведения. Можно указать идентификатор группы устройств или имя группы устройств. Чтобы использовать имя группы устройств, необходимо указать имя продукта и имя группы устройств в <product-name/device-group-name> формате. |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --debug | Увеличивает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах и списках доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляя предупреждения. |
| -o, --output | Изменяет формат выходных данных. Доступные форматы выходных данных : jsonc, jsonc (цветной JSON), tsv (значения с разделительными табуляциями), таблица (таблицы ASCII, доступные для чтения человека) и yaml. По умолчанию CLI выводит формат table. Дополнительные сведения о доступных форматах выходных данных см. в разделе "Формат выходных данных" для команд Azure Sphere CLI. |
| --query | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см . в руководстве по JMESPath и выходным данным команды Azure CLI. |
| --verbose | Выводит сведения о ресурсах, созданных в Azure Sphere во время операции, и другие полезные сведения. Используйте параметр--debug, чтобы включить полные журналы отладки. |
Примечание.
Если вы используете классический интерфейс командной строки Azure Sphere, дополнительные сведения о доступных параметрах см. в статье "Глобальные параметры ".
Пример
Пример указания группы устройств по идентификатору:
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Пример указания группы устройств по имени:
azsphere device-group show --device-group DW100/Marketing
Вы должны увидеть примерно такой результат:
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Id Name Description TenantId ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd Marketing Marketing device group 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
обновить
Обновляет существующую группу устройств, которая определяется по идентификатору или по паре имени продукта и имени группы устройств.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -g, --device-group | Строка | Указывает группу устройств, для которой необходимо обновить сведения. Можно указать идентификатор группы устройств или имя группы устройств. Чтобы использовать имя группы устройств, необходимо указать имя продукта и имя группы устройств в <product-name/device-group-name> формате. |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -c, --allow-crash-dumps-collection | Строка | Задайте согласие на сбор аварийных дампов корпорацией Майкрософт для группы устройств. По умолчанию — Off. Допустимые значения: Off и On. --regional-data-boundary Используйте параметр, чтобы указать, где должны храниться файлы аварийного дампа. Дополнительные сведения см. в разделе "Настройка аварийных дампов". |
| -a, --application-update | ApplicationUpdatePolicyType | Указывает политику обновления приложения для группы устройств. Допустимые значения: No3rdPartyAppUpdates, UpdateAll и NoUpdates. По умолчанию — UpdateAll. Политика NoUpdates в настоящее время зарезервирована только для внутреннего использования. |
| -d, --new-description | Строка | Указывает необязательный текст для описания группы устройств. Максимальная длина составляет 100 символов. |
| -n, --new-name | Строка | Задает новое имя для группы устройств. Имя может содержать только буквенно-цифровые символы. Если имя содержит пробелы, заключите его в двойные кавычки. Имя группы устройств не может превышать 50 символов, не учитывает регистр и должен быть уникальным внутри продукта. |
| -f, --os-feed | Строка | Указывает веб-канал операционной системы для группы устройств. Возможные значения: Retail и RetailEval. |
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
| -r, --regional-data-гранич | Строка | Граница региональных данных для этого изображения. Допустимые значения: EU, None. Значение по умолчанию — None. Если значение не указано, будет использоваться значение по умолчанию. Дополнительные сведения см. в разделе "Настройка аварийных дампов" — рекомендации по pivacy |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --debug | Увеличивает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, включите выходные данные, полученные с помощью флага --debug, в отправляемый отчет об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах и списках доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляя предупреждения. |
| -o, --output | Изменяет формат выходных данных. Доступные форматы выходных данных : jsonc, jsonc (цветной JSON), tsv (значения с разделительными табуляциями), таблица (таблицы ASCII, доступные для чтения человека) и yaml. По умолчанию CLI выводит формат table. Дополнительные сведения о доступных форматах выходных данных см. в разделе "Формат выходных данных" для команд Azure Sphere CLI. |
| --query | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см . в руководстве по JMESPath и выходным данным команды Azure CLI. |
| --verbose | Выводит сведения о ресурсах, созданных в Azure Sphere во время операции, и другие полезные сведения. Используйте параметр--debug, чтобы включить полные журналы отладки. |
Примечание.
Если вы используете классический интерфейс командной строки Azure Sphere, дополнительные сведения о доступных параметрах см. в статье "Глобальные параметры ".
Пример
Пример указания группы устройств по идентификатору:
azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"
Пример указания группы устройств по имени:
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
Вы должны увидеть примерно такой результат:
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
Id TenantId OsFeedType ProductId Name Description UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Marketing device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------