Отображение сведений об устройстве

  • Статья

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

Вы также можете использовать команды CLI для скачивания диагностических и конфигурационных сведений, данных об ошибках и других событиях, влияющих на устройства.

Результаты перенаправления или разбивки на страницы

Интерфейс командной строки (CLI) Azure Sphere предоставляет следующие команды для перечисления сведений об устройствах, продуктах и группах устройств в клиенте.

Эти команды могут возвращать большой список элементов, которые можно перенаправить или разбиение на страницы. В этом разделе описываются различные способы перенаправления или разбивки выходных данных на страницы из обоих clis.

Azure Sphere CLI

Azure Sphere CLI не поддерживает интерактивное разбиение на страницы. Однако можно разбиение выходных данных на страницы на экране путем отправки в существующие средства разбиения на страницы.

Например:

  • В PowerShell (Windows): azsphere device list | Out-Host –Paging
  • В командной строке (Windows): azsphere device list | more
  • В оболочке Bash (Linux): azsphere device list | less

Примечание

Эта операция может выполняться медленно в зависимости от объема возвращаемых данных.

Вы также можете перенаправить стандартные выходные данные команды в файл. В следующем примере стандартные выходные данные отправляются в output.txt, а стандартная ошибка — в logs.txt.

azsphere device list --verbose > output.txt 2> logs.txt

Классический интерфейс командной строки Azure Sphere

Действие этих команд по умолчанию — одновременное возвращение страницы записей, где размер страницы обычно равен 100 записям. В нижней части каждой страницы результатов отображается сообщение для нажатия любой клавиши, чтобы продолжить отображение со следующей страницей результатов. Размер страницы автоматически изменяется в зависимости от таких факторов, как активность базы данных и доступная пропускная способность сети.

Результаты команды списка можно перенаправить в CSV-файл для углубленной проверки, указав путь и имя файла для --output параметра и добавив --noninteractive параметр в команду . Параметр --noninteractive удаляет разбиение на страницы из результатов, поэтому весь список записывается в CSV-файл без необходимости вручную продолжать работу в конце каждой страницы.

Отображение сведений о поддержке

Команды, используемые для получения сведений о поддержке, будут зависеть от того, собираете ли вы данные о поддержке клиентов для одного устройства Azure Sphere при работе со службой поддержки Майкрософт или возвращаете данные об ошибках, связанных с приложениями, работающими на устройствах в клиенте. В большинстве случаев вы будете запрашивать у клиента условия ошибки на всех устройствах с помощью команды azsphere tenant download-error-report . Этот метод будет зависеть от взаимодействия службы безопасности Azure Sphere с устройствами через подключение к Интернету для сбора соответствующих событий.

get-support-data

Команда azsphere get-support-data собирает и создает файлы журналов, содержащие сведения о диагностике и конфигурации с компьютера, облака и подключенного устройства Azure Sphere. Сведения в этих файлах журнала могут быть использованы для того, чтобы помочь вам или группе технической поддержки проанализировать и устранить проблемы. --destination Используйте параметр , чтобы указать путь и имя файла .zip, в котором будут сохранены данные поддержки. Можно указать относительный или абсолютный путь.

download-error-report

Команда azsphere tenant download-error-report возвращает сведения об ошибках, сообщаемых устройствами в клиенте. Данные событий извлекаются из облака службы безопасности Azure Sphere и не требуют физического подключения к конкретному устройству. Команда работает в контексте текущего клиента и возвращает отчеты об ошибках для всех устройств в этом клиенте.

--destination Используйте параметр , чтобы указать путь и имя файла .csv, в котором будут сохранены данные поддержки. Можно указать относительный или абсолютный путь.