продукт
Внимание
Это документация по Azure Sphere (устаревшая версия). Служба Azure Sphere (устаревшая версия) выходит на пенсию 27 сентября 2027 г., и к этому времени пользователи должны перейти в Azure Sphere (интегрированная). Используйте селектор версий, расположенный над toC, чтобы просмотреть документацию по Azure Sphere (интегрированная).
Позволяет управлять продуктами.
| Операция | Description |
|---|---|
| создание | Создает продукт. |
| Удаление | Удаляет существующий продукт. |
| device | Отображает устройства в этом продукте. |
| device-group | Позволяет управлять группами устройств для продукта. |
| список | Выводит список всех продуктов в клиенте Azure Sphere. |
| show | Отображает сведения о конкретном продукте. |
| обновить | Обновляет указанные метаданные. |
create
Создает продукт.
Команда azsphere product create автоматически добавляет в созданный продукт следующие пять стандартных групп устройств.
- В группе устройств Development отключены обновления облачных приложений и предоставляется розничная версия операционной системы.
- Группа устройств "Тестирование полей" включает обновления облачных приложений и предоставляет розничную ОС.
- Группа рабочих устройств включает обновления облачных приложений и предоставляет операционную систему розничной торговли.
- Группа устройств Production OS Evaluation включает обновления облачных приложений и предоставляет операционную систему розничной ознакомительной версии.
- В группе устройств Field Test OS Evaluation включены обновления облачных приложений и предоставляется операционная система розничной ознакомительной версии.
Обязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -n, --name | Строка | Указывает имя продукта. Имя может содержать только буквенно-цифровые символы. Если имя содержит пробелы, заключите его в двойные кавычки. Имя продукта не может превышать 50 символов, не учитывает регистр и должен быть уникальным в клиенте. |
Необязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -g, --no-default-device-groups | Логический | Указывает необязательный флаг, который предотвращает создание групп устройств по умолчанию. |
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
| -d, --description | Строка | Указывает необязательный текст для описания продукта. Максимальная длина составляет 100 символов. Если описание содержит пробелы, заключите его в кавычки. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Description |
|---|---|
| --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, чтобы включить полные журналы отладки. |
Пример
azsphere product create --name DW100 --description "Contoso DW100 models"
Default device groups will been created for this product, use the 'azsphere product device-group list' command to see them.
------------------------------------ -------------------- ----- ------------------------------------
TenantId Description Name Id
====================================================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb Contoso DW100 models DW100 6f52bead-700d-4289-bdc2-2f11f774270e
------------------------------------ -------------------- ----- ------------------------------------
удалить
Удаляет указанный продукт в клиенте Azure Sphere.
Продукт можно удалить только в том случае, если:
- У пользователя есть разрешения администратора для клиента.
- Продукт пуст, и группы устройств не имеют в нем устройств. Команда azsphere product device list выводит список всех устройств в продукте. Запустите azsphere device update --device-group , чтобы переместить устройство в другую группу устройств или azsphere device-group delete , чтобы удалить группу устройств.
Обязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -p, --product | GUID или имя | Указывает продукт для удаления. Можно указать идентификатор или имя продукта Azure Sphere. |
Необязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Description |
|---|---|
| --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, чтобы включить полные журналы отладки. |
Пример
Пример указания продукта по идентификатору:
azsphere product delete --product 6f52bead-700d-4289-bdc2-2f11f774270e
Пример указания продукта по имени:
azsphere product delete --product DW100
Вы должны увидеть примерно такой результат:
Successfully deleted the product
device
Отображает список устройств в продукте.
| Операция | Description |
|---|---|
| список | Отображает список устройств в указанном продукте. |
| show-count | Возвращает число устройств в указанном продукте. |
device list
Отображает список устройств в указанном продукте с сортировкой по идентификатору устройства.
Обязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -p, --product | GUID или имя | Указывает продукт, в котором будет отображаться список устройств. Можно указать идентификатор или имя продукта Azure Sphere. |
Необязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Description |
|---|---|
| --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, чтобы включить полные журналы отладки. |
Пример
Пример указания продукта по идентификатору:
azsphere product device list --product 6f52bead-700d-4289-bdc2-2f11f774270e
Пример указания продукта по имени:
azsphere product device list --product DW100
Вы должны увидеть примерно такой результат:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===============================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ------------------------------------
device show-count
Возвращает общее количество устройств во всех группах устройств для продукта.
Обязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -p, --product | GUID или имя | Указывает продукт, для которого отображается число целевых устройств. Можно указать идентификатор или имя продукта Azure Sphere. |
Необязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Description |
|---|---|
| --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, чтобы включить полные журналы отладки. |
Пример
Пример указания продукта по идентификатору:
azsphere product device show-count --product 6f52bead-700d-4289-bdc2-2f11f774270e
Пример указания продукта по имени:
azsphere product device show-count --product DW100
Вы должны увидеть примерно такой результат:
------
Result
======
2
------
device-group
Позволяет управлять группами устройств для продукта.
| Операция | Description |
|---|---|
| create-defaults | Создает стандартные группы устройств для указанного продукта. |
| список | Отображает список групп устройств в указанном продукте. |
device-group create-defaults
Создает стандартные группы устройств для существующего продукта.
Обязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -p, --product | GUID или имя | Указывает продукт для получения. Можно указать идентификатор или имя продукта Azure Sphere. |
Необязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Description |
|---|---|
| --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, чтобы включить полные журналы отладки. |
Пример
Пример указания продукта по идентификатору:
azsphere product device-group create-defaults --product 6f52bead-700d-4289-bdc2-2f11f774270e
Пример указания продукта по имени:
azsphere product device-group create-defaults --product DW100
Вы должны увидеть примерно такой результат:
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- -------------------------
Id Name Description ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
=====================================================================================================================================================================================================================================================================================
6406868c-19bb-4bea-b4cf-fd80608ee5cb Development Default development device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail Accept only system software updates. Don't accept application updates. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
d2e2b2e7-e219-4af8-8876-f8d10624778b Field Test Default test device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
822f1bda-32d7-404a-bf37-9f90aad09509 Production Default production device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
3fafc0e1-f336-4a8a-9be4-fb275322d2cc Production OS Evaluation Default Production OS Evaluation device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
b9b7f388-2ad4-4a7e-a4dc-6559fb80741d Field Test OS Evaluation Default Field Test OS Evaluation device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
device-group list
Выводит список всех групп устройств в продукте.
Обязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -p, --product | GUID или имя | Указывает продукт для перечисления групп устройств. Можно указать идентификатор или имя продукта Azure Sphere. |
Необязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Description |
|---|---|
| --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, чтобы включить полные журналы отладки. |
Пример
Пример указания продукта по идентификатору:
azsphere product device-group list --product 6f52bead-700d-4289-bdc2-2f11f774270e
Пример указания продукта по имени:
azsphere product device-group list --product DW100
Вы должны увидеть примерно такой результат:
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- -------------------------
Id TenantId OsFeedType ProductId Name Description UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
==========================================================================================================================================================================================================================================================================================================================
6406868c-19bb-4bea-b4cf-fd80608ee5cb 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 4f48d618-09f7-45dc-a5a4-1433cabbee91 Development Default development device group Accept only system software updates. Don't accept application updates. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
d2e2b2e7-e219-4af8-8876-f8d10624778b 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 4f48d618-09f7-45dc-a5a4-1433cabbee91 Field Test Default test device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
822f1bda-32d7-404a-bf37-9f90aad09509 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 4f48d618-09f7-45dc-a5a4-1433cabbee91 Production Default production device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
a6c64cda-4ff0-48bb-8a30-6ffab322b846 143adbc9-1bf0-4be2-84a2-084a331d81cb RetailEval 4f48d618-09f7-45dc-a5a4-1433cabbee91 Production OS Evaluation Default Production OS Evaluation device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
3fafc0e1-f336-4a8a-9be4-fb275322d2cc 143adbc9-1bf0-4be2-84a2-084a331d81cb RetailEval 4f48d618-09f7-45dc-a5a4-1433cabbee91 Field Test OS Evaluation Default Field Test OS Evaluation device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
b9b7f388-2ad4-4a7e-a4dc-6559fb80741d 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 4f48d618-09f7-45dc-a5a4-1433cabbee91 Marketing Default Marketing device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
список
Выводит список всех продуктов в клиенте Azure Sphere.
Необязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Description |
|---|---|
| --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, чтобы включить полные журналы отладки. |
Пример
azsphere product list
------------------------------------ ------------------------------------ --------- --------------------
Id TenantId Name Description
========================================================================================================
6f52bead-700d-4289-bdc2-2f11f774270e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW100 Contoso DW100 models
------------------------------------ ------------------------------------ --------- --------------------
6a82518f-8965-4bd6-ba79-43aa3fcafe5e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW200 Contoso DW200 models
------------------------------------ ------------------------------------ --------- --------------------
show
Отображает сведения о конкретном продукте.
Обязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -p, --product | GUID или имя | Указывает продукт для получения. Можно указать идентификатор или имя продукта Azure Sphere. |
Необязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -t, --tenant | GUID или имя | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Description |
|---|---|
| --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, чтобы включить полные журналы отладки. |
Пример
Пример указания продукта и клиента по идентификатору:
azsphere product show --product 6f52bead-700d-4289-bdc2-2f11f774270e --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
Пример указания продукта и клиента по имени:
azsphere product show --product DW100 --tenant MyTenant
Вы должны увидеть примерно такой результат:
------------------------------------ ------------------------------------ ----- --------------------
Id TenantId Name Description
====================================================================================================
6f52bead-700d-4289-bdc2-2f11f774270e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW100 Contoso DW100 models
------------------------------------ ------------------------------------ ----- --------------------
обновить
Обновляет метаданные для указанного продукта.
Необходимо указать хотя бы один необязательный параметр.--newname--newdescription Можно указать сразу оба параметра в одной команде.
Обязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -p, --product | GUID или имя | Указывает продукт для обновления. Можно указать идентификатор или имя продукта Azure Sphere. |
Необязательные параметры
| Параметр | Тип | Description |
|---|---|---|
| -n, --new-name | Строка | Задает новое имя продукта. Имя может содержать только буквенно-цифровые символы. Если имя содержит пробелы, заключите его в двойные кавычки. Имя продукта не может превышать 50 символов, не учитывает регистр и должен быть уникальным в клиенте. |
| -d, --new-description | Строка | Указывает необязательный текст для описания продукта. Максимальная длина составляет 100 символов. |
| -t, --tenant | Строка | Указывает клиент для выполнения этой операции. Переопределяет выбранный клиент по умолчанию. Можно указать идентификатор клиента или имя клиента. |
Глобальные параметры
Для Интерфейса командной строки Azure Sphere доступны следующие глобальные параметры:
| Параметр | Description |
|---|---|
| --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, чтобы включить полные журналы отладки. |
Пример
Пример указания продукта по идентификатору:
azsphere product update --product 6f52bead-700d-4289-bdc2-2f11f774270e --new-description Contoso DW100 models
Пример указания продукта по имени:
azsphere product update --product DW100 --new-description Contoso DW100 models
Вы должны увидеть примерно такой результат:
------------------------------------ ------------------------------------ ----- ------------------
Id TenantId Name Description
==================================================================================================
6a82518f-8965-4bd6-ba79-43aa3fcafe5e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW200 Contoso DW200 models
------------------------------------ ------------------------------------ ----- ------------------