ca-certificate
Управляет сертификатами центра сертификации (ЦС) для текущего клиента Azure Sphere. Дополнительные сведения см. в разделе Управление сертификатом ЦС клиента.
| Операции | Описание |
|---|---|
| Скачать | Скачивает сертификат ЦС для текущего клиента Azure Sphere в виде CER-файла X.509. |
| download-chain | Скачивает цепочку сертификатов ЦС для текущего клиента Azure Sphere в виде PKCS#7B-файла. |
| подтверждение скачивания | Скачивает сертификат подтверждения владения для текущего клиента Azure Sphere в виде CER-файла X.509. |
| Список | Список всех сертификатов для текущего клиента Azure Sphere. |
Скачать
Скачивает сертификат ЦС для текущего клиента Azure Sphere в виде CER-файла X.509.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| --Назначения | Строка | Указывает путь и имя файла для сохранения сертификата ЦС клиента. Путь к файлу может быть абсолютным или относительным, но должен иметь расширение CER. |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| --Индекс | Целое число | Указывает индекс загружаемого сертификата. Выполните azsphere ca-certificate list команду, чтобы получить список сертификатов и значений индекса. Если индекс не указан, скачивается активный сертификат. Можно указать значение индекса или отпечаток. |
| --Отпечаток | Строка | Указывает отпечаток сертификата для скачивания. Выполните azsphere ca-certificate list команду, чтобы получить список сертификатов и значений отпечатка. Если отпечаток не указан, скачивается активный сертификат. Можно указать значение индекса или отпечаток. |
| -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 ca-certificate download --destination ca-cert.cer --index 1
Пример указания отпечатка для скачивания необходимого сертификата:
azsphere ca-certificate download --destination ca-cert.cer --thumbprint <value>
Вы должны увидеть следующие выходные данные:
Succeeded
download-chain
Скачивает цепочку сертификатов ЦС для текущего клиента Azure Sphere в виде PKCS#7B-файла.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| --Назначения | Строка | Указывает путь и имя файла для сохранения цепочки сертификатов ЦС клиента. Можно указать относительный или абсолютный путь и использовать расширение P7B. |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| --Индекс | Целое число | Указывает индекс загружаемого сертификата. Выполните azsphere ca-certificate list команду, чтобы получить список сертификатов и значений индекса. Если индекс не указан, скачивается активный сертификат. Можно указать значение индекса или отпечаток. |
| --Отпечаток | Строка | Указывает отпечаток сертификата для скачивания. Выполните azsphere ca-certificate list команду, чтобы получить список сертификатов и значений отпечатка. Если отпечаток не указан, скачивается активный сертификат. Можно указать значение индекса или отпечаток. |
| -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 ca-certificate download-chain --destination CA-cert-chain.p7b --index 1
Succeeded
подтверждение скачивания
Скачивает сертификат подтверждения владения для текущего клиента Azure Sphere для использования с предоставленным кодом и в виде CER-файла X.509. Этот сертификат является частью процесса проверки подлинности и аттестации устройства. Дополнительные сведения об использовании устройств Azure Sphere с Azure IoT см. в статье Использование Интернета вещей Azure с Azure Sphere.
Обязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| --Назначения | Строка | Указывает путь и имя файла для сохранения сертификата подтверждения владения. Путь к файлу может быть абсолютным или относительным, но должен использовать расширение CER. |
| --verification-code | Строка | Указывает код проверки для службы безопасности Azure Sphere, который будет использоваться при создании сертификата. |
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| --Индекс | Целое число | Указывает индекс загружаемого сертификата. Выполните azsphere ca-certificate list команду, чтобы получить список сертификатов и значений индекса. Если индекс не указан, скачивается активный сертификат. Можно указать значение индекса или отпечаток. |
| --Отпечаток | Строка | Указывает отпечаток сертификата для скачивания. Выполните azsphere ca-certificate list команду, чтобы получить список сертификатов и значений отпечатка. Если отпечаток не указан, скачивается активный сертификат. Можно указать значение индекса или отпечаток. |
| -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 ca-certificate download-proof --destination validation.cer --verification-code 123412341234 --index 1
Succeeded
Список
Выводит список всех сертификатов для текущего клиента.
Необязательные параметры
| Параметр | Тип | Описание |
|---|---|---|
| -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 ca-certificate list
----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------
Index Thumbprint CertificateDetails Status StartDate EndDate
=========================================================================================================================================================
1 <value> CN: Microsoft Azure Sphere <tenant-ID> Active 09/06/2020 17:39:40 09/06/2022 17:39:40
O: Microsoft Corporation
L: Redmond
ST: Washington
C: US
----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------
2 <value> CN: Microsoft Azure Sphere <tenant-ID> Ready 29/04/2020 22:51:47 29/04/2022 22:51:47
O: Microsoft Corporation
L: Redmond
ST: Washington
C: US
----- ---------------------------------------- --------------------------------------------------------------- ------ ----------------- -----------------