Exibir informações do dispositivo

Importante

Esta é a documentação do Azure Sphere (herdado). O Azure Sphere (herdado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).

Um locatário do Azure Sphere pode conter milhares de dispositivos, e o gerenciamento dos dispositivos requer um método para obter informações detalhadas sobre cada um deles. Usando os comandos da CLI, você pode listar informações sobre dispositivos, produtos e grupos de dispositivos em um locatário. Você também pode redirecionar a saída padrão de um comando para um arquivo para revisão detalhada.

Você também pode usar os comandos da CLI para baixar informações de diagnóstico e configuração, dados sobre os erros e outros eventos que afetam seus dispositivos.

Redirecionar ou paginar resultados

A CLI (interface de linha de comando) do Azure Sphere fornece os comandos a seguir para listar informações sobre os dispositivos, produtos e grupos de dispositivos em um locatário.

• azsphere device-group device list exibe todos os dispositivos dentro de um grupo de dispositivos específico.
• A lista de dispositivos do azsphere exibe todos os dispositivos em um locatário.
• A Lista de Dispositivos de Produtos do Azsphere exibe todos os dispositivos em um produto.

Esses comandos podem retornar uma grande lista de itens que podem ser redirecionados ou paginados. Esta seção descreve as diferentes maneiras de redirecionar ou paginar a saída de ambas as CLIs.

Azure Sphere CLI

A CLI do Azure Sphere não dá suporte à paginação interativa. No entanto, você pode paginar a saída na tela canalizando para as ferramentas de paginação existentes.

Por exemplo:

• No PowerShell (Windows): azsphere device list | Out-Host –Paging
• Em um prompt de comando (Windows): azsphere device list | more
• No shell Bash (Linux): azsphere device list | less

Observação

Essa operação pode ser potencialmente lenta, dependendo da quantidade de dados retornados.

Você também pode redirecionar a saída padrão de um comando para um arquivo. No exemplo a seguir, a saída padrão é enviada para output.txt e o erro padrão é enviado para logs.txt.

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

CLI Clássica do Azure Sphere

A ação padrão desses comandos é retornar uma página de registros em um determinado momento, em que o tamanho da página normalmente é definido para conter 100 registros. Na parte inferior de cada página de resultados há uma mensagem para pressionar qualquer tecla para continuar a exibição com a próxima página de resultados. O tamanho da página é ajustado automaticamente com base em fatores como a atividade do banco de dados e a largura de banda de rede disponível.

Você pode redirecionar os resultados de um comando de lista para um arquivo CSV (valores separados por vírgula) para revisão aprofundada, especificando um caminho e um nome de arquivo para --output o parâmetro e adicionando o --noninteractive parâmetro ao comando. O --noninteractive parâmetro remove a paginação dos resultados para que toda a lista seja capturada no arquivo CSV sem a necessidade de continuar manualmente no final de cada página.

Exibir informações para suporte

Os comandos usados para obter informações de suporte dependerão se você está coletando dados de suporte ao cliente para um único dispositivo do Azure Sphere ao trabalhar com o suporte da Microsoft ou retornando dados sobre condições de erro envolvendo os aplicativos em execução em dispositivos em um locatário. Na maioria dos cenários, você consultará o locatário em busca de condições de erro em todos os dispositivos usando o comando azsphere tenant download-error-report. Esse método dependerá da comunicação do Serviço de Segurança do Azure Sphere com os dispositivos por meio de uma conexão com a Internet para coletar os eventos correspondentes.

get-support-data

O comando azsphere get-support-data reúne e gera arquivos de log contendo informações de diagnóstico e configuração do computador, da nuvem e do dispositivo do Azure Sphere anexado. As informações nesses arquivos de log podem ser usadas para ajudar você ou a equipe de suporte técnico a analisar e solucionar problemas. Use o --destination parâmetro para especificar o caminho e o nome do arquivo .zip no qual salvar os dados de suporte. Você pode fornecer um caminho relativo ou absoluto.

download-error-report

O comando azsphere tenant download-error-report retorna informações sobre erros relatados por dispositivos em um locatário. Os dados de evento são extraídos da nuvem do Serviço de Segurança do Azure Sphere e não exigem uma conexão física com um dispositivo específico. O comando funciona no contexto do locatário atual e retorna relatórios de erros para todos os dispositivos dentro desse locatário.

Use o --destination parâmetro para especificar o caminho e o nome do arquivo .csv no qual salvar os dados de suporte. Você pode fornecer um caminho relativo ou absoluto.