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

Статья
11/05/2024

Внимание

Это документация по Azure Sphere (устаревшая версия). Служба Azure Sphere (устаревшая версия) выходит на пенсию 27 сентября 2027 г., и к этому времени пользователи должны перейти в Azure Sphere (интегрированная). Используйте селектор версий, расположенный над toC, чтобы просмотреть документацию по Azure Sphere (интегрированная).

Клиент Azure Sphere может содержать тысячи устройств и управлять устройствами, для получения подробных сведений о каждом из них требуется метод. С помощью команд ИНТЕРФЕЙСА командной строки можно перечислить сведения об устройствах, продуктах и группах устройств в клиенте. Вы также можете перенаправить стандартные выходные данные команды в файл для подробной проверки.

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

Перенаправление или разбивка результатов

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

azsphere device-group device list отображает все устройства в определенной группе устройств.
azsphere device list отображает все устройства в клиенте.
azsphere product device list отображает все устройства в продукте.

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

CLI Azure Sphere

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

Например:

В 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 файла, в котором сохраняются данные поддержки. Вы можете указать относительный или абсолютный путь.

Поделиться через