группа устройств
Создает группы устройств и управляет ими.
Группы устройств адресуются по идентификатору или по парой имени продукта и группы устройств.
| Операции | Описание |
|---|---|
| Создать | Создает новую группу устройств. |
| Список | Список всех групп устройств в клиенте Azure Sphere. |
| Удалить | Удаляет существующую группу устройств. |
| Развертывания | Управляет развертываниями в группе устройств. |
| Устройства | Выводит список устройств в группе устройств. |
| Показать | Отображает сведения о группе устройств. |
| Обновление | Изменяет существующую группу устройств. |
Создать
Создает группу устройств с указанным именем для указанного продукта. Группа устройств организует устройства с одинаковым продуктом и получают одни и те же приложения из облака.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -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-boundary | Строка | Граница региональных данных для этого образа. Допустимые значения: EU, None. Значение по умолчанию — None. Если значение не указано, будет использоваться значение по умолчанию. Дополнительные сведения см. в разделе Настройка аварийных дампов — рекомендации по pivacy. |
Глобальные параметры
Для Azure Sphere CLI доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --Отладки | Повышает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, укажите выходные данные, созданные с флагом --debug в при отправке отчета об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах, а также список доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляющие предупреждения. |
| -o, --output | Изменяет формат вывода. Доступные форматы выходных данных: json, jsonc (цветной JSON), tsv (значения, разделенные табуляциями), таблица (читаемые человеком таблицы ASCII) и yaml. По умолчанию CLI выводит .table Дополнительные сведения о доступных форматах вывода см. в статье Формат вывода для команд Azure Sphere CLI. |
| --Запроса | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см. в руководстве по JMESPath и запросе выходных данных команды Azure CLI . |
| --Подробного | Выводит сведения о ресурсах, созданных в 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 CLI доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --Отладки | Повышает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, укажите выходные данные, созданные с флагом --debug в при отправке отчета об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах, а также список доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляющие предупреждения. |
| -o, --output | Изменяет формат вывода. Доступные форматы выходных данных: json, jsonc (цветной JSON), tsv (значения, разделенные табуляциями), таблица (читаемые человеком таблицы ASCII) и yaml. По умолчанию CLI выводит .table Дополнительные сведения о доступных форматах вывода см. в статье Формат вывода для команд Azure Sphere CLI. |
| --Запроса | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см. в руководстве по JMESPath и запросе выходных данных команды Azure CLI . |
| --Подробного | Выводит сведения о ресурсах, созданных в 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-group device list перечисляет все устройства в группе устройств. Выполните команду azsphere device update --device-group , чтобы переместить устройство в другую группу устройств.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -g, --device-group | Строка | Указывает удаляемую группу устройств. Можно указать идентификатор группы устройств или имя группы устройств. Чтобы использовать имя группы устройств, необходимо указать имя продукта и имя группы устройств в <product-name/device-group-name> формате . |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент, в котором будет выполняться эта операция. Переопределяет выбранный по умолчанию клиент. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Azure Sphere CLI доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --Отладки | Повышает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, укажите выходные данные, созданные с флагом --debug в при отправке отчета об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах, а также список доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляющие предупреждения. |
| -o, --output | Изменяет формат вывода. Доступные форматы выходных данных: json, jsonc (цветной JSON), tsv (значения, разделенные табуляциями), таблица (читаемые человеком таблицы ASCII) и yaml. По умолчанию CLI выводит .table Дополнительные сведения о доступных форматах вывода см. в статье Формат вывода для команд Azure Sphere CLI. |
| --Запроса | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см. в руководстве по JMESPath и запросе выходных данных команды Azure CLI . |
| --Подробного | Выводит сведения о ресурсах, созданных в 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
Развертывания
Управляет развертываниями для группы устройств.
| Операции | Описание |
|---|---|
| Создать | Создает новое развертывание для указанной группы устройств. |
| Список | Отображает развертывания для группы устройств. |
создание развертывания
Создает новое развертывание для группы устройств с предоставленными образами.
Группу устройств можно определить по идентификатору (id) или по парой имен группы устройств и продуктов.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -g, --device-group | Строка | Указывает группу устройств, в которой создается развертывание. Можно указать идентификатор группы устройств или имя группы устройств. Чтобы использовать имя группы устройств, необходимо указать имя продукта и имя группы устройств в <product-name/device-group-name> формате . |
| -i, --images | Строка | Указывает идентификаторы образов для одного или нескольких образов, которые будут включены в развертывание. Можно добавить несколько изображений, добавив дополнительные параметры, или несколько идентификаторов изображений можно объединить в одном параметре в разделенном пробелом списке. Выполните команду azsphere image add , чтобы получить идентификатор образа. |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент, в котором будет выполняться эта операция. Переопределяет выбранный по умолчанию клиент. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Azure Sphere CLI доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --Отладки | Повышает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, укажите выходные данные, созданные с флагом --debug в при отправке отчета об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах, а также список доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляющие предупреждения. |
| -o, --output | Изменяет формат вывода. Доступные форматы выходных данных: json, jsonc (цветной JSON), tsv (значения, разделенные табуляциями), таблица (читаемые человеком таблицы ASCII) и yaml. По умолчанию CLI выводит .table Дополнительные сведения о доступных форматах вывода см. в статье Формат вывода для команд Azure Sphere CLI. |
| --Запроса | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см. в руководстве по JMESPath и запросе выходных данных команды Azure CLI . |
| --Подробного | Выводит сведения о ресурсах, созданных в 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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
список развертывания
Отображает журнал развертывания для группы устройств. Возвращает идентификатор развертывания, метку времени и список включенных образов. Список упорядочивается по последним развертываниям.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -g, --device-group | Строка | Указывает группу устройств, для которой будет отображаться список журналов развертывания. Можно указать идентификатор группы устройств или имя группы устройств. Чтобы использовать имя группы устройств, необходимо указать имя продукта и имя группы устройств в <product-name/device-group-name> формате . |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент, в котором будет выполняться эта операция. Переопределяет выбранный по умолчанию клиент. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Azure Sphere CLI доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --Отладки | Повышает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, укажите выходные данные, созданные с флагом --debug в при отправке отчета об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах, а также список доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляющие предупреждения. |
| -o, --output | Изменяет формат вывода. Доступные форматы выходных данных: json, jsonc (цветной JSON), tsv (значения, разделенные табуляциями), таблица (читаемые человеком таблицы ASCII) и yaml. По умолчанию CLI выводит .table Дополнительные сведения о доступных форматах вывода см. в статье Формат вывода для команд Azure Sphere CLI. |
| --Запроса | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см. в руководстве по JMESPath и запросе выходных данных команды Azure CLI . |
| --Подробного | Выводит сведения о ресурсах, созданных в 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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Устройства
Управляет устройствами для группы устройств.
| Операции | Описание |
|---|---|
| Список | Отображает устройства в группе устройств. |
| show-count | Показывает количество устройств в группе устройств. |
Список устройств
Отображает устройства в группе устройств.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -g, --device-group | Строка | Указывает группу устройств, для которой будет отображаться список устройств. Можно указать идентификатор группы устройств или имя группы устройств. Чтобы использовать имя группы устройств, необходимо указать имя продукта и имя группы устройств в <product-name/device-group-name> формате . |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент, в котором будет выполняться эта операция. Переопределяет выбранный по умолчанию клиент. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Azure Sphere CLI доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --Отладки | Повышает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, укажите выходные данные, созданные с флагом --debug в при отправке отчета об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах, а также список доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляющие предупреждения. |
| -o, --output | Изменяет формат вывода. Доступные форматы выходных данных: json, jsonc (цветной JSON), tsv (значения, разделенные табуляциями), таблица (читаемые человеком таблицы ASCII) и yaml. По умолчанию CLI выводит .table Дополнительные сведения о доступных форматах вывода см. в статье Формат вывода для команд Azure Sphere CLI. |
| --Запроса | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см. в руководстве по JMESPath и запросе выходных данных команды Azure CLI . |
| --Подробного | Выводит сведения о ресурсах, созданных в 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
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
количество показов устройств
Отображает количество устройств в группе устройств.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -g, --device-group | Строка | Указывает группу устройств, для которой будет отображаться число устройств. Можно указать идентификатор группы устройств или имя группы устройств. Чтобы использовать имя группы устройств, необходимо указать имя продукта и имя группы устройств в <product-name/device-group-name> формате . |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент, в котором будет выполняться эта операция. Переопределяет выбранный по умолчанию клиент. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Azure Sphere CLI доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --Отладки | Повышает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, укажите выходные данные, созданные с флагом --debug в при отправке отчета об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах, а также список доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляющие предупреждения. |
| -o, --output | Изменяет формат вывода. Доступные форматы выходных данных: json, jsonc (цветной JSON), tsv (значения, разделенные табуляциями), таблица (читаемые человеком таблицы ASCII) и yaml. По умолчанию CLI выводит .table Дополнительные сведения о доступных форматах вывода см. в статье Формат вывода для команд Azure Sphere CLI. |
| --Запроса | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см. в руководстве по JMESPath и запросе выходных данных команды Azure CLI . |
| --Подробного | Выводит сведения о ресурсах, созданных в 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
------
Показать
Возвращает сведения о группе устройств.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -g, --device-group | Строка | Указывает группу устройств, для которой будут отображаться сведения. Можно указать идентификатор группы устройств или имя группы устройств. Чтобы использовать имя группы устройств, необходимо указать имя продукта и имя группы устройств в <product-name/device-group-name> формате . |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент, в котором будет выполняться эта операция. Переопределяет выбранный по умолчанию клиент. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Azure Sphere CLI доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --Отладки | Повышает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, укажите выходные данные, созданные с флагом --debug в при отправке отчета об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах, а также список доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляющие предупреждения. |
| -o, --output | Изменяет формат вывода. Доступные форматы выходных данных: json, jsonc (цветной JSON), tsv (значения, разделенные табуляциями), таблица (читаемые человеком таблицы ASCII) и yaml. По умолчанию CLI выводит .table Дополнительные сведения о доступных форматах вывода см. в статье Формат вывода для команд Azure Sphere CLI. |
| --Запроса | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см. в руководстве по JMESPath и запросе выходных данных команды Azure CLI . |
| --Подробного | Выводит сведения о ресурсах, созданных в 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-boundary | Строка | Граница региональных данных для этого образа. Допустимые значения: EU, None. Значение по умолчанию — None. Если значение не указано, будет использоваться значение по умолчанию. Дополнительные сведения см. в разделе Настройка аварийных дампов — рекомендации по pivacy. |
Глобальные параметры
Для Azure Sphere CLI доступны следующие глобальные параметры:
| Параметр | Описание |
|---|---|
| --Отладки | Повышает детализацию ведения журнала для отображения всех журналов отладки. Если вы обнаружили ошибку, укажите выходные данные, созданные с флагом --debug в при отправке отчета об ошибке. |
| -h, --help | Выводит справочные сведения о командах и их аргументах, а также список доступных подгрупп и команд. |
| --only-show-errors | Отображает только ошибки, подавляющие предупреждения. |
| -o, --output | Изменяет формат вывода. Доступные форматы выходных данных: json, jsonc (цветной JSON), tsv (значения, разделенные табуляциями), таблица (читаемые человеком таблицы ASCII) и yaml. По умолчанию CLI выводит .table Дополнительные сведения о доступных форматах вывода см. в статье Формат вывода для команд Azure Sphere CLI. |
| --Запроса | Использует язык запросов JMESPath для фильтрации выходных данных, возвращаемых службами безопасности Azure Sphere. Дополнительные сведения и примеры см. в руководстве по JMESPath и запросе выходных данных команды Azure CLI . |
| --Подробного | Выводит сведения о ресурсах, созданных в 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
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------