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).

Gerencia dispositivos do Azure Sphere.

Operação	Descrição
app	Altera o status dos aplicativos em um dispositivo.
capability	Gerencia funcionalidades do dispositivo.
certificate	Gerencia o repositório de certificados do dispositivo.
claim	Declara um dispositivo não solicitado anteriormente para o locatário do Azure Sphere.
enable-cloud-test	Configura um dispositivo para desabilitar a depuração e receber atualizações.
enable-development	Configura um dispositivo para depuração local.
imagem	Gerencia imagens para um dispositivo.
lista	Exibe todos os dispositivos no locatário.
list-attached	Lista os dispositivos conectados.
estado de fabricação	Gerencia o estado de fabricação do dispositivo conectado.
network	Fornece informações sobre o status das interfaces de rede no dispositivo.
recover	Usa o modo de recuperação especial para carregar o novo firmware no dispositivo.
Rescan-attached	Verifica novamente os dispositivos conectados como um auxílio para solução de problemas (somente Windows).
restart	Reinicia o dispositivo conectado.
show	Exibe detalhes sobre a configuração de atualização do dispositivo.
show-attached	Exibe detalhes sobre o dispositivo conectado do próprio dispositivo.
show-count	Mostra o número total de dispositivos em um locatário.
show-deployment-status	Exibe o status da atualização de implantação mais recente.
show-os-version	Exibe a versão do sistema operacional do dispositivo local.
carregamento lateral	Carrega uma imagem no dispositivo conectado.
update	Atualiza um dispositivo colocando-o em um grupo de dispositivos específico.
wifi	Gerencia a configuração de Wi-Fi do dispositivo.

app

Gerencia aplicativos no dispositivo.

Muitas das opções de aplicativo exigem a funcionalidade appDevelopment, que pode ser adquirida usando azsphere device enable-development. Para iniciar, interromper ou depurar um aplicativo assinado pelo SDK ou um aplicativo assinado em produção, o dispositivo precisa ter a funcionalidade appDevelopment.

Você pode usar azsphere device app stop e azsphere device app start para reiniciar um aplicativo em execução com capacidade em tempo real para determinar em qual núcleo em tempo real ele está sendo executado.

Operação	Descrição
mostrar estatísticas de memória	Exibe as estatísticas de memória dos aplicativos no dispositivo conectado.
show-quota	Exibe a quantidade de armazenamento usada pelo aplicativo no dispositivo atual.
show-status	Retorna o status do aplicativo atual no dispositivo.
start	Inicia o aplicativo que é carregado no dispositivo.
stop	Interrompe o aplicativo que está em execução no dispositivo.

aplicativo mostrar estatísticas de memória

Mostra as estatísticas de memória para aplicativos no dispositivo conectado. Esse comando só estará disponível se a funcionalidade do dispositivo appDevelopment estiver configurada. Informações adicionais serão mostradas se o rastreamento de alocação de memória heap estiver configurado.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device app show-memory-stats
 -------------- -------------
 Name           Usage (bytes)
 ============================
 Total          434176
 User Mode      147456
 Peak User Mode 147456
 -------------- -------------

app show-quota

Exibe a quantidade de armazenamento mutável alocado e em uso no dispositivo conectado.

Você define a cota de armazenamento mutável no manifesto do aplicativo e o sistema operacional do Azure Sphere impõe cotas quando aloca setores para o arquivo. Como resultado, se você diminuir o valor MutableStorage, a quantidade de armazenamento em uso não será alterada, mas o valor alocado relatado será diferente. Por exemplo, se o aplicativo já tiver usado 16 KB e você alterar o MutableStorage valor para 8 KB, o comando relatará que o aplicativo usa 16 KB de 8 KB alocados. Os dados permanecem no dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-i, --id do componente	GUID	Especifica a ID do componente para o qual obter informações de cota. Se omitido, mostra informações de cota para todos os componentes.
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device app show-quota
ae4714aa-03aa-492b-9663-962f966a9cc3: 0KB out of 8KB of mutable storage used.

app show-status

Exibe o status atual dos aplicativos no dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-i, --id do componente	GUID	Especifica a ID do componente cujo status se deseja exibir. Se omitido, mostra o status de todos os componentes.
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device app show-status
9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
App state: running

app start

Inicia aplicativos no dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
--modo de depuração	Booliano	Inicia o aplicativo para depuração. O --component-id deve ser fornecido.
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-i, --id do componente	GUID	Especifica a ID do componente a iniciar. Se omitido, inicia todos os aplicativos.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device app start
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: running
Core     : High-level

app stop

Interrompe os aplicativos no dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-i, --id do componente	GUID	Especifica a ID do componente a interromper. Se omitido, interrompe todos os aplicativos.
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device app stop
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: stopped

capability

Gerencia funcionalidades do dispositivo. As funcionalidades do dispositivo determinam as operações que podem ser executadas em um dispositivo Azure Sphere individual.

Os recursos do dispositivo são baixados como um arquivo do Serviço de Segurança do Azure Sphere usando o comando azsphere device capability download . Você pode aplicar a configuração de funcionalidade do dispositivo ao dispositivo do Azure Sphere anexado usando o comando azsphere device capability update e pode criar uma sessão de manutenção usando o comando azsphere device capability select. Para obter mais informações sobre os recursos do dispositivo, consulte Recursos e comunicação do dispositivo.

Operação	Descrição
fazer download	Baixa uma configuração de funcionalidade do dispositivo do Serviço de Segurança do Azure Sphere.
select	Seleciona um arquivo de funcionalidade baixado a ser usado para uma sessão de manutenção.
show-attached	Exibe a configuração de funcionalidade para o dispositivo anexado.
update	Aplica uma configuração de funcionalidade do dispositivo ao dispositivo conectado.

capability download

Baixa uma funcionalidade do dispositivo do Serviço de Segurança do Azure Sphere.

A funcionalidade appDevelopment permite que você realize sideload de aplicativos assinados pelo SDK e inicie, interrompa, depure ou exclua qualquer aplicativo no dispositivo. Sem a funcionalidade appDevelopment, somente os aplicativos carregados na nuvem podem ser carregados, e as operações de inicialização, interrupção, depuração e exclusão são proibidas. A funcionalidade appDevelopment é aplicada como parte do comando azsphere device enable-development.

O download da funcionalidade fieldServicing resulta em um arquivo que contém a funcionalidade de um só dispositivo Azure Sphere. O arquivo de funcionalidade fieldServicing é baixado no computador local e pode ser usado em conjunto com o comando azsphere device capability select.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
--type	Tipo de funcionalidade	Especifica o tipo de capacidade do dispositivo a ser baixado. Os valores são appDevelopment, fieldServicing ou none. Use none para remover a funcionalidade appDevelopment ou a funcionalidade fieldServicing.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando. Esse parâmetro é necessário quando vários dispositivos estão conectados ou quando nenhum dispositivo está conectado. O dispositivo conectado no momento é usado por padrão. Você pode fornecer uma ID de dispositivo para um dispositivo não anexado ou pode especificar o endereço IP ou a ID de conexão local de um dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
--destino	String	Especifica o caminho e o nome do arquivo no qual salvar a configuração da funcionalidade. Inclua um caminho absoluto ou relativo. Se você não fornecer um caminho, o comando armazenará o arquivo no diretório local usando o recurso de convenção de nomenclatura type-first<> oito caracteres de device ID.cap>.<
-t, --inquilino	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device capability download --type appDevelopment
The appdevelopment capability was saved as:
 --------------------------------------------
 Result
 ============================================
 C:\capability-file\appdevelopment-<first eight characters of device ID>.cap
 --------------------------------------------

capability select

Seleciona um arquivo de funcionalidade a ser usado com o dispositivo Azure Sphere anexado.

O comando azsphere device capability select pode ser usado com qualquer funcionalidade, mas é usado com mais frequência com a funcionalidade fieldServicing para habilitar uma sessão de manutenção. Qualquer função de usuário tem acesso ao comando azsphere device capability select.

Quando você usa a funcionalidade fieldServicing, a comunicação é habilitada entre o dispositivo Azure Sphere e o computador local que contém o arquivo de funcionalidade. O arquivo de funcionalidade fieldServicing é usado para uma sessão entre o computador local e o dispositivo Azure Sphere. Cada comando na sessão é precedido por uma mensagem indicando o arquivo de funcionalidade em uso.

Para encerrar uma sessão de manutenção, use azsphere device capability select --none.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
--capability-file	String	Especifica o caminho e o nome do arquivo para o arquivo de configuração de capacidade do dispositivo a ser selecionado. Você pode fornecer um caminho relativo ou absoluto.
-n, --none	-	Limpa a configuração de funcionalidade do dispositivo selecionada anteriormente.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device capability select --capability-file appdevcap
The capability session uses C:\capability-file\appdevcap.

capability show-attached

Exibe a configuração de funcionalidade armazenada no dispositivo anexado.

Observação

O comando exibe os recursos configurados usando um arquivo de recursos e alguns, mas não todos, recursos presentes por padrão nas placas.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device capability show-attached
 --------------------
 DeviceCapabilities
 ====================
 EnableFieldServicing
 --------------------

azsphere device capability show-attached
 --------------------
 DeviceCapabilities
 ====================
 EnableAppDevelopment
 --------------------

capability update

Aplica uma configuração de funcionalidade do dispositivo ao dispositivo conectado.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
--capability-file	String	Especifica o caminho e o nome do arquivo de capacidade do dispositivo a ser aplicado. Você pode fornecer um caminho relativo ou absoluto.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando. Esse parâmetro é necessário quando vários dispositivos estão conectados ou quando nenhum dispositivo está conectado. O dispositivo conectado no momento é usado por padrão. Você pode fornecer uma ID de dispositivo para um dispositivo não anexado ou pode especificar o endereço IP ou a ID de conexão local de um dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device capability update --capability-file appdevcap.bin
Using selected capability file: C:\capability-file\appdevcap.bin
The capability file C:\capability-file\appdevcap.bin was added on the device. The device will restart.

certificate

Gerencia os certificados no dispositivo anexado.

Operação	Descrição
add	Adiciona um certificado ao repositório de certificados no dispositivo anexado.
excluir	Exclui um certificado do repositório de certificados do dispositivo anexado.
lista	Lista as IDs de certificado que estão disponíveis no repositório de certificados do dispositivo anexado.
show	Exibe detalhes de um certificado no repositório de certificados do dispositivo anexado.
show-quota	Exibe o espaço livre disponível no repositório de certificados do dispositivo anexado.

certificate add

Adiciona um certificado ao repositório de certificados do dispositivo anexado.

Os certificados da Autoridade de Certificação raiz e do cliente devem estar no formato .pem para serem carregados no dispositivo Azure Sphere. Você precisa adquirir o certificado de CA raiz do servidor apropriado, juntamente com o certificado do cliente e a chave privada (e, opcionalmente, uma senha para sua chave privada) para seu dispositivo. Cada certificado deve ser gerado e assinado pelo servidor apropriado em sua rede EAP-TLS. O administrador de rede ou a equipe de segurança pode fornecer os detalhes de que você precisa para obter os certificados. Para obter mais informações sobre como adquirir o certificado de CA raiz, consulte Adquirir e implantar certificados para redes EAP-TLS.

Cuidado

Como as IDs do certificado são aplicadas a todo o sistema nos Certificados de Autoridade de Certificação raiz e nos certificados do cliente, um comando azsphere ou uma chamada de função que adiciona um novo certificado pode substituir um certificado que foi adicionado por um comando ou uma chamada de função anterior, potencialmente causando falhas de conexão de rede. Recomendamos que você desenvolva procedimentos de atualização de certificado bem definidos e escolha IDs de certificado com cuidado.

Confira IDs de certificado para obter mais informações.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
-i, --cert-id	String	Especifica o identificador do certificado a ser adicionado. Um identificador de cadeia de caracteres (de até 16 caracteres). Os caracteres válidos incluem letras maiúsculas (A-Z), letras minúsculas (a-z), números (0-9), sublinhado (_), ponto (.) e hífen (-). Esse identificador também é usado em configurações de Wi-Fi para redes EAP-TLS.
--cert-tipo	String	Especifica o tipo de certificado a ser adicionado, cliente ou rootca.
-p, --arquivo-chave-pública	String	Especifica o caminho para um arquivo .pem de certificado de chave pública. Você pode fornecer um caminho relativo ou absoluto.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
--arquivo-chave-privada	String	Especifica o caminho para um arquivo .pem de certificado de chave privada do cliente. Necessário ao adicionar um certificado do tipo cliente. Você pode fornecer um caminho relativo ou absoluto.
-w, --palavra-chave-privada	String	Especifica uma senha opcional para a chave privada do cliente. A senha é necessária ao adicionar uma chave privada do certificado do cliente que é criptografada.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device certificate add --cert-id certroot --cert-type rootca --public-key-file publiccert.pem
Certificate 'certroot' successfully added.

azsphere device certificate add --cert-id certclient --cert-type client --private-key-file privatekey.pem --private-key-password 1234 --public-key-file publiccert.pem
Certificate 'certclient' successfully added.

certificate delete

Exclui um certificado do repositório de certificados do dispositivo anexado.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
-c, --certificado ou --cert-id [Descontinuando]	String	Especifica o identificador do certificado a ser excluído. O --cert-id argumento será desativado e será removido em uma versão futura. Para obter mais informações, consulte Alterações importantes (desativando recursos) na CLI do Azure Sphere.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device certificate delete --certificate certclient

certificate list

Lista os certificados disponíveis no repositório de certificados do dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device certificate list
 -----------
 Identifiers
 ===========
 rootCert
 -----------

certificate show

Mostra os detalhes de um certificado individual no repositório de certificados do dispositivo.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
-c, --certificado ou --cert-id [Descontinuando]	String	Especifica o identificador do certificado para o qual mostrar os detalhes. O --cert-id argumento será desativado e será removido em uma versão futura. Para obter mais informações, consulte Alterações importantes (desativando recursos) na CLI do Azure Sphere.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device certificate show --certificate certclient
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
 Id         StartDate           EndDate             SubjectName                         IssuerName
 ==========================================================================================================================
 certclient 06/08/2019 19:15:48 06/08/2069 19:25:44 /DC=local/DC=azsphere/CN=azsphereca /DC=local/DC=azsphere/CN=azsphereca
 ---------- ------------------- ------------------- ----------------------------------- -----------------------------------

certificate show-quota

Exibe o espaço livre disponível no repositório de certificados do dispositivo anexado.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device certificate show-quota
--------------
Available space (bytes)
==============
24514
--------------

claim

Declara um dispositivo não declarado anteriormente para o locatário atual do Azure Sphere.

Importante

Antes de declarar o dispositivo, assegure que você está conectado ao locatário do Azure Sphere correto. Cada dispositivo pode ser declarado apenas uma vez. Uma vez reivindicado, um dispositivo não pode ser movido para um locatário diferente.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando. Esse parâmetro é necessário quando vários dispositivos estão conectados ou quando nenhum dispositivo está conectado. O dispositivo conectado no momento é usado por padrão. Você pode fornecer uma ID de dispositivo para um dispositivo não anexado ou pode especificar o endereço IP ou a ID de conexão local de um dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-t, --inquilino	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.
--force	Booliano	Força um dispositivo a ser reivindicado no locatário do Azure Sphere selecionado pelo usuário atual.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device claim
warn: You are claiming a device to the following tenant:
warn: a323c263-2aa3-2559-aabb-a3fc32631900 (Tenant1)
warn: Do you want to claim the device ID 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968 to this tenant?
warn: You cannot change the Azure Sphere tenant this device is claimed to once this action has completed.
Enter 'yes' to continue. Enter anything else to exit.
> yes
Claiming device.
Successfully claimed device ID '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968' into tenant 'Tenant1' with ID 'a323c263-2aa3-2559-aabb-a3fc32631900'.

enable-cloud-test

Prepara o dispositivo conectado para teste de carregamento de nuvem desabilitando o desenvolvimento de aplicativos, excluindo todos os aplicativos existentes e habilitando as atualizações de aplicativos carregados na nuvem.

Ele requer que um dispositivo esteja conectado ao PC e funciona apenas no dispositivo conectado.

Especificamente, enable-cloud-test:

• Remove o recurso appDevelopment para o dispositivo anexado.
• Atribui o dispositivo a um grupo de dispositivos que permite atualizações de aplicativos carregadas na nuvem.
• Reinicializa o dispositivo.

As tarefas específicas que enable-cloud-test realiza dependem de um produto e grupo de dispositivos já terem sido ou não atribuídos a este dispositivo.

Se azsphere device enable-cloud-test for executado sem parâmetros, o dispositivo será colocado no grupo de dispositivos Teste de Campo do produto atual do dispositivo. Este é um dos grupos de dispositivos padrão criados automaticamente para cada produto, o que habilita atualizações de aplicativos. Um erro será retornado se o dispositivo não tiver um produto ou se não existir um grupo de dispositivos de Teste de Campo dentro dele.

Se um produto for especificado, o dispositivo será colocado no grupo de dispositivos de teste de campo desse produto. Um erro será retornado se esse grupo de dispositivos não existir.

Se um grupo de dispositivos for especificado, o dispositivo será colocado nele. Um erro será retornado se o grupo de dispositivos de destino não habilitar atualizações de aplicativos.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-p, --produto	GUID ou nome	Especifica o produto de destino. Quando isso é especificado, o dispositivo é movido para o grupo de dispositivos de teste de campo padrão deste produto, a menos que --device-group também seja especificado. Você pode especificar a ID ou o nome do produto do Azure Sphere.
-t, --inquilino	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.
-g, --grupo-de-dispositivos	GUID ou nome	Especifica o grupo de dispositivos para o qual o dispositivo será movido. Você pode especificar a ID do grupo de dispositivos ou o nome do grupo de dispositivos. Para usar o nome do grupo de dispositivos, você deve fornecer o nome do produto e o nome do grupo de dispositivos no <product-name/device-group-name> formato. Por padrão, esse é o grupo de dispositivos de teste de campo do produto.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplos

Exemplo 1. Atribuir dispositivo a um grupo de dispositivos existente por sua ID

Este exemplo atribui um dispositivo conectado a um grupo de dispositivos e produto existentes.

azsphere device enable-cloud-test --device-group '3548b179-m16f-4f64-6dme-d3c643662e76'
Your internal capabilities will be retained, including the Enable App development capability. Sideloaded images may be removed by over-the-air application updates.
Getting device group by ID '3548b179-m16f-4f64-6dme-d3c643662e76'.
Leaving any existing applications on the device.
Setting device group to 'Field Test' with ID '3548b179-m16f-4f64-6dme-d3c643662e76')
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: 'ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD')

Exemplo 2. Atribuir dispositivo a um grupo de dispositivos diferente

Este exemplo é semelhante ao exemplo anterior, mas retém o produto existente para o dispositivo. Aqui a operação enable-cloud-test altera o grupo de dispositivos ao qual o dispositivo pertence e remove a funcionalidade appDevelopment. Esse comando é útil para mover um dispositivo de um ambiente de desenvolvimento que não habilita atualizações de aplicativo para um ambiente de produção que permite.

azsphere device enable-cloud-test --device-group "Marketing/Field Test"

Exemplo 3. Atribuir dispositivo por nome do produto

Este exemplo habilita o carregamento em nuvem e atribui o dispositivo a um produto por nome.

azsphere device enable-cloud-test --product DW100

enable-development

Habilita um dispositivo para desenvolvimento habilitando o sideload e a depuração no dispositivo e atribuindo-o a um grupo de dispositivos que desabilita as atualizações de aplicativos da nuvem. Por padrão, esse é o grupo de dispositivos de desenvolvimento do produto do dispositivo, mas outros grupos de dispositivos podem ser especificados. Não use em cenários de fabricação. Consulte Fabricação de dispositivos conectados para obter mais informações.

Especificamente, enable-development:

• Baixa e aplica o recurso appDevelopment para o dispositivo conectado.
• Atribui o dispositivo a um grupo de dispositivos que não habilita atualizações de aplicativos carregadas na nuvem.
• Reinicializa o dispositivo.

Se você executar o comando azsphere device enable-development sem parâmetros:

• Se o dispositivo ainda não tiver um grupo de produtos ou dispositivos, o comando baixará e aplicará a funcionalidade appDevelopment ao dispositivo anexado e o reinicializará. Todos os aplicativos existentes permanecem no dispositivo e o sistema operacional é atualizado. O processo de instalação para reivindicar seu dispositivo e o Início Rápido para criar um aplicativo de alto nível não são afetados.
• Se o dispositivo já tiver um produto, o comando moverá o dispositivo para o grupo de dispositivos de desenvolvimento do produto. Por padrão, as atualizações de aplicativos são desabilitadas para esse grupo, garantindo que os aplicativos de sideload não sejam substituídos.

Se você executar o comando azsphere device enable-development com o --product parâmetro:

• Coloca o dispositivo no grupo de dispositivos de desenvolvimento do produto. Um erro será retornado se esse grupo de dispositivos não existir.

Se você executar o comando azsphere device enable-development com o --device-group parâmetro:

• Coloca o dispositivo no grupo de dispositivos especificado. O grupo de dispositivos de destino não deve habilitar atualizações de aplicativos ou um erro será retornado.

Em alguns casos, azsphere device enable-development relata um erro e sugere que você declare o dispositivo. Caso já tenha declarado o dispositivo, use azsphere tenant show-selected para garantir que você está conectado ao locatário em que declarou o dispositivo. Caso contrário, use azsphere login para fazer logon no locatário correto. Quando tiver certeza de que está conectado ao locatário apropriado, use azsphere device claim para reivindicar o dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-g, --grupo-de-dispositivos	GUID ou nome	Especifica o grupo de dispositivos para o qual o dispositivo será movido. Se omitido, atribui o dispositivo a um grupo padrão. Você pode especificar a ID do grupo de dispositivos ou o nome do grupo de dispositivos. Para usar o nome do grupo de dispositivos, você deve fornecer o nome do produto e o nome do grupo de dispositivos no <product-name/device-group-name> formato.
-r, --enable-rt-core-debugging	Booliano	Instala os drivers necessários para depurar aplicativos executados em um núcleo em tempo real. Essa opção exige permissões de administrador.
-p, --produto	GUID ou nome	Especifica o produto de destino. Quando você especifica esse valor, o dispositivo é movido para o grupo de dispositivos de desenvolvimento padrão deste produto, a menos que --device-group também seja especificado. Você pode especificar a ID ou o nome do produto do Azure Sphere.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device enable-development
Capability configuration has been successfully cleared.
PS C:\Users\v-shypr> azsphere device enable-development
Getting device group 'Development' for product 'DW100'.
The device already has the 'Enable App development' capability. No changes will be applied to its existing capabilities.
Setting device group to 'Development' with ID '7f860cc1-4949-4000-a541-9a988ba4c3cd'.
Successfully disabled application updates.
Installing debugging server to device.
Deploying 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' to the attached device.
Image package 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' has been deployed to the attached device.
Previous device capabilities retained. Ensure that you have the correct development capabilities installed before continuing.
Successfully set up device for application development, and disabled application updates.
(Device ID: '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968')

imagem

Retorna informações sobre as imagens que estão instaladas no dispositivo conectado ou que são direcionadas a ele.

Operação	Descrição
list-installed	Fornece detalhes sobre as imagens que estão atualmente instaladas no dispositivo conectado.
list-targeted	Fornece detalhes sobre as imagens que são atualmente direcionadas ao dispositivo conectado.

image list-installed

Lista as imagens que estão instaladas no dispositivo conectado. A lista de informações inclui as IDs de componente e de imagem.

Observação

Os nomes de imagens longas são truncados em 31 caracteres.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-f, --full	Booliano	Lista todas as imagens de software instaladas no dispositivo. Por padrão, lista apenas imagens do aplicativo, depuradores e imagens de configuração do quadro.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device image list-installed
Installed images:
 --> gdbserver
   --> Image type:   Application
   --> Component ID: 8548b129-b16f-4f84-8dbe-d2c847862e78
   --> Image ID:     dc6205bd-4478-4c9b-81ad-5e41ac23ed68
 --> CrashApplicatio
   --> Image type:   Application
   --> Component ID: 9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
   --> Image ID:     cc77124e-6447-4c0f-9f99-fc0ad5ef46ef

image list-targeted

Lista as imagens que foram carregadas no Serviço de Segurança do Azure Sphere e serão instaladas quando o dispositivo for atualizado. Para obter mais informações sobre como garantir que seu dispositivo do Azure Sphere esteja pronto para aceitar atualizações de aplicativos baseados em nuvem, consulte Habilitar a implantação baseada em nuvem para seu dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando. Esse parâmetro é necessário quando vários dispositivos estão conectados ou quando nenhum dispositivo está conectado. O dispositivo conectado no momento é usado por padrão. Você pode fornecer uma ID de dispositivo para um dispositivo não anexado ou pode especificar o endereço IP ou a ID de conexão local de um dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-t, --inquilino	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.
-f, --full	Booliano	Lista todas as imagens em seu locatário do Azure Sphere.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device image list-targeted
 ----------------------- ------------------------------------ ------------------------------------ ---------------- --------------------
 Name                    ComponentId                          ImageId                              ImageType       RegionalDataBoundary 
 =======================================================================================================================================
 HelloWorld_HighLevelApp 1689d8b2-c835-2e27-27ad-e894d6d15fa9 50419cb6-a33b-4cbe-8bd0-425048664b6f Applications    None   
 ----------------------- ------------------------------------ ------------------------------------ -------------------------------------   

lista

Lista todos os dispositivos em um locatário. A lista é truncada após os primeiros 500 dispositivos.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-t, --inquilino	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device list
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                                                         TenantId                             ChipSku  ProductId                            DeviceGroupId
 ========================================================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------

Você pode usar o --query parâmetro para personalizar a saída exibida para este comando. Para obter mais informações, consulte Consultar saída do comando da CLI.

O exemplo a seguir mostra como selecionar apenas a ID do dispositivo e a ID do produto:

azsphere device list --query '[].{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 4f48d618-09f7-45dc-a5a4-1433cabbee91
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD 4f48d618-09f7-45dc-a5a4-1433cabbee91
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

Dica

Execute o produto azsphere show --product <product-ID> para exibir o nome do produto ou o azsphere device-group show --device-group <devicegroup-ID> para exibir o nome do grupo de dispositivos.

list-attached

Lista os dispositivos anexados ao PC local.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device list-attached
1 device attached:
--> Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
  --> Is responsive: yes
  --> IP address: 192.128.48.1
  --> Connection path: 21143

estado de fabricação

Gerencia o estado de fabricação do dispositivo conectado.

Operação	Descrição
show	Exibe o estado de fabricação do dispositivo conectado.
update	Atualiza o estado de fabricação do dispositivo conectado.

Cuidado

Alterações de estado de fabricação são permanentes e irreversíveis.

manufacturing-state show

Exibe o estado de fabricação do dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device manufacturing-state show
------------------
ManufacturingState
==================
Module1Complete
------------------

manufacturing-state update

Atualiza o estado de fabricação do dispositivo conectado. Para obter mais informações, consulte Definir o estado de fabricação do dispositivo.

Cuidado

Alterações de estado de fabricação são permanentes e irreversíveis.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
-s, --state	Estados de fabricação	Especifica o estado de produção a ser definido para o dispositivo. Os estados possíveis incluem DeviceComplete e Module1Complete.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device manufacturing-state update --state Module1Complete
Updating manufacturing state to Module1Complete.
Restarting device for changes to take effect.
The device was successfully restarted.

network

Fornece informações sobre o status das interfaces de rede no dispositivo conectado.

Operação	Descrição
enable	Habilita uma interface de rede no dispositivo conectado.
disable	Desativa uma interface de rede no dispositivo conectado.
listar-firewall-regras	Lista as regras de firewall para o dispositivo conectado.
interfaces de lista	Lista as interfaces de rede para o dispositivo conectado.
proxy	Gerencia as configurações de proxy de rede.
mostrar diagnóstico	Mostra o diagnóstico de rede para uma ou todas as redes sem fio no dispositivo conectado.
show-status	Mostra o status da rede do dispositivo conectado.
interface de atualização	Atualiza uma configuração de interface de rede para o dispositivo.

Habilitação de rede

Habilita uma interface de rede no dispositivo conectado.

Observação

Este comando é suportado para configurar Ethernet eth0 e wlan0 conexões. Um erro será retornado se você configurar lo ou azspheresvc.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
--interface	string	Especifica a interface a ser habilitada.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device network enable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.

Desativar rede

Desativa uma interface de rede no dispositivo conectado.

Observação

Este comando é suportado para configurar Ethernet eth0 e wlan0 conexões. Um erro será retornado se você configurar lo ou azspheresvc.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
--interface	string	Especifica a interface a ser habilitada.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device network disable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.

regras de firewall de lista de rede

Lista as regras de firewall para o dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

As seguintes regras são exibidas:

• Nome do conjunto de regras do firewall: Exibe o nome do bloco do conjunto de regras do firewall.
  • Os valores são PREROUTING, POSTROUTING, INPUT, FORWARD e OUTPUT.
• O conjunto de regras é válido: Exibe o status do conjunto de regras. Os valores são True ou False.
• Regras do conjunto de regras do firewall: exibe os valores das seguintes regras:
  • IP de origem: Exibe o endereço IP da máquina de envio.
  • Máscara de origem: Exibe a máscara de rede da máquina de envio.
  • IP de destino: Exibe o endereço IP da máquina de destino.
  • Máscara de destino: Exibe a máscara de rede da máquina de destomação.
  • UID: Exibe a identificação do usuário aplicada à regra. 4294967295 (0xFFFFFFFF) significa que nenhum UID foi aplicado e, portanto, se aplica a todos.
  • Ação: Exibe a ação a ser executada. Os valores podem ser aceitos ou descartados.
  • Nome IN da interface: Exibe o nome da interface de entrada. Por exemplo, wlan0.
  • Nome da interface OUT: Exibe o nome da interface de saída. Por exemplo, wlan0.
  • Estado: Exibe o estado da conexão. Os valores são none, estabelecidos ou relacionados.
  • Máscara TCP: Exibe a matriz de máscaras TCP. Os valores são fin, syn, rst, psh, ack e urg.
  • TCP Cmp: Exibe a matriz de sinalizadores TCP. Os valores são urg, ack, psh, rst, syb e fin.
  • TCP Inv: Boolean indica que o sentido dos sinalizadores TCP deve ser invertido. Os valores são True ou False.
  • Protocolo: Exibe o protocolo da regra de firewall. Os valores são icmp, igmp, tcp, udp.
  • Intervalo de portas de origem: exibe o intervalo de portas da origem que envia o tráfego. O valor pode estar entre 0 e 65535.
  • Intervalo de portas de destino: Exibe o intervalo de portas no destino que recebe o tráfego. O valor pode estar entre 0 e 65535.
  • Pacotes: Exibe o número de pacotes.
  • Bytes: Exibe o número de bytes.

Um breve resumo das bandeiras está listado a seguir:

• URG: Campo de ponteiro urgente significativo
• ACK: Campo de reconhecimento significativo
• PSH: Função de empurrar
• RST: Redefinir a conexão
• SYN: Sincronizar números de sequência
• FIN: Não há mais dados do remetente

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device network list-firewall-rules
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 Ruleset     IsValid SourceIp     SourceMask      DestinationIp   DestinationMask UID        Action InterfaceInName TcpInv Protocol SourcePortRange DestinationPortRange Packets Bytes  TcpMask TcpCmp
 =====================================================================================================================================================================================================
 PREROUTING  False   None         None            None            None            None       None   None            None   None     None            None                 None    None   None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  any      0-65535         0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 True   tcp      0-65535         0-65535              823     394754 syn,ack syn
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    192.168.35.1 <value>         <value>         <value>         <value>     accept azspheresvc     False  any      0-65535         0-65535              15      780    None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------

interfaces de lista de rede

Lista as interfaces de rede para o dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device network list-interfaces
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 InterfaceName InterfaceUp ConnectedToNetwork IpAcquired IpAddresses   ConnectedToInternet IpAssignment HardwareAddress
 ========================================================================================================================
 azspheresvc   True        False              False      <value>       False               None         None
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 eth0          True        True               True       <value>       True                dynamic      <value>
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 lo            True        False              False      <value>       False               None         None
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 wlan0         True        True               True       <value>       True                dynamic      <value>
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------

proxy de rede

Gerencia o uso de endereço proxy para conexão de rede. Para obter mais informações sobre como configurar um dispositivo do Azure Sphere para se conectar à Internet por meio de um servidor proxy, consulte Conectar-se por meio de um servidor proxy.

Observação

Atualmente, apenas proxies HTTP são suportados.

Operação	Descrição
Aplicação de proxy	Configura o proxy de rede no dispositivo conectado.
exclusão de proxy	Exclui a conexão proxy no dispositivo conectado.
Proxy Show	Mostra a conexão proxy no dispositivo conectado.

Aplicação de proxy

Configura o proxy de rede no dispositivo conectado.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
-a, --endereço	String	Especifica o endereço de rede do proxy a ser usado.
-t, --autenticação	String	Especifica o tipo de autenticação a ser usado. Valores permitidos: anonymous ou basic. Se o proxy exigir um nome de usuário e senha, defina-o como basic, caso contrário, use anonymous.
-r, --port	Inteiro	Especifica a porta no endereço de rede a ser usado. O valor deve ser igual ou menor que 65535.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
--habilitar	String	Especifica se o proxy deve ser habilitado. Você deve definir ou --enable --disable.
--desabilitar	String	Especifica se o proxy deve ser desabilitado. Você deve definir ou --enable --disable.
-n, --no-proxy-addresses	String	Especifica uma matriz de endereços de rede separados por espaço que o dispositivo deve evitar para conexão proxy.
-p, --senha	String	Especifica a senha para autenticação de proxy Usada apenas para autenticação básica. Comprimento máximo: 64 caracteres.
-u, --username	String	Especifica o nome de usuário para autenticação de proxy. Usado apenas para autenticação básica. Comprimento máximo: 64 caracteres.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device network proxy apply --address contoso.com --authentication anonymous --port 8080 --enable
 ----------- ------- ----- ------------------ ----------------
 Address     Enabled Port  AuthenticationType NoProxyAddresses
 =============================================================
 contoso.com True   8080  anonymous
 ----------- ------- ----- ------------------ ----------------

exclusão de proxy

Exclui a conexão proxy no dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device network proxy delete

Proxy Show

Mostra a conexão proxy no dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device network proxy show
 ----------- ------- ----- ------------------ ----------------
 Address     Enabled Port  AuthenticationType NoProxyAddresses
 =============================================================
 contoso.com True   8080  anonymous
 ----------- ------- ----- ------------------ ----------------

Diagnóstico de exibição de rede

Mostra diagnósticos para uma ou todas as redes Wi-Fi no dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-n, --rede	Inteiro	Especifica a ID da rede Wi-Fi para a qual mostrar o diagnóstico.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device network show-diagnostics
 ------------------------- --------- ----- ------------- --------------- --------
 Timestamp                 NetworkId Ssid  ConfigState   ConnectionState Error
 ================================================================================
 2021-06-16T20:51:29+00:00 0         <value> temp-disabled disconnected    WrongKey
 ------------------------- --------- ----- ------------- --------------- --------

status de exibição de rede

Mostra o status da rede do dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device network show-status
 --------------------------- --------------- -----
 DeviceAuthenticationIsReady NetworkTimeSync Proxy
 =================================================
 True                        complete        ready
 --------------------------- --------------- -----

interface de atualização de rede

Atualiza a interface de rede Ethernet do dispositivo. Para obter mais informações sobre como definir o endereço MAC do dispositivo, consulte Configurar o dispositivo para Ethernet.

Observação

Esse comando é suportado para configurar conexões Ethernet eth0 . Um erro será retornado se você configurar loo , azspheresvc ou wlan0.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
--hardware-address	String	Especifica o endereço de hardware a ser definido para o dispositivo em um dos seguintes formatos: AA:BB:33:DD:EE:FF ou aa:bb:33:dd:ee:ff.
--interface ou --interface-name [Descontinuando]	String	Especifica o nome da interface a ser configurada. Execute azsphere device network list-interfaces para exibir detalhes dos adaptadores de rede para o dispositivo anexado. O --interface-name argumento será desativado e será removido em uma versão futura. Para obter mais informações, consulte Alterações importantes (desativando recursos) na CLI do Azure Sphere.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device network update-interface --interface eth0 --hardware-address ba:98:76:54:32:10

recover

Substitui o software de sistema no dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estiverem conectados. O dispositivo conectado no momento é usado por padrão. Especifique o ID, o endereço IP ou o ID da conexão local do dispositivo.
-c, --capacidade	String	Especifica a imagem de funcionalidade do dispositivo a ser aplicada ao dispositivo durante a recuperação.
-i, --imagens	String	Especifica o caminho para uma pasta que contém os pacotes de imagens a serem gravados no dispositivo. Por padrão, a recuperação usa as imagens no SDK, a menos que um caminho alternativo seja fornecido com esse sinalizador.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

Exemplo 1:

azsphere device recover
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 17 images. (5443272 bytes to send)
Sent 1 of 17 images. (5440896 of 5443272 bytes remaining)
Sent 2 of 17 images. (5414844 of 5443272 bytes remaining)
Sent 3 of 17 images. (5311892 of 5443272 bytes remaining)
Sent 4 of 17 images. (5311500 of 5443272 bytes remaining)
Sent 5 of 17 images. (5041520 of 5443272 bytes remaining)
Sent 6 of 17 images. (5024908 of 5443272 bytes remaining)
Sent 7 of 17 images. (4994856 of 5443272 bytes remaining)
Sent 8 of 17 images. (2397456 of 5443272 bytes remaining)
Sent 9 of 17 images. (885796 of 5443272 bytes remaining)
Sent 10 of 17 images. (861220 of 5443272 bytes remaining)
Sent 11 of 17 images. (758608 of 5443272 bytes remaining)
Sent 12 of 17 images. (135796 of 5443272 bytes remaining)
Sent 13 of 17 images. (70048 of 5443272 bytes remaining)
Sent 14 of 17 images. (41164 of 5443272 bytes remaining)
Sent 15 of 17 images. (32768 of 5443272 bytes remaining)
Sent 16 of 17 images. (16384 of 5443272 bytes remaining)
Sent 17 of 17 images. (0 of 5443272 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.

Exemplo 2:

azsphere device recover --capability "C:\Users\capability file\capability_352FE1F_5.bin"
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 16 images. (5474668 bytes to send)
Sent 1 of 16 images. (5447384 of 5474668 bytes remaining)
Sent 2 of 16 images. (5343788 of 5474668 bytes remaining)
Sent 3 of 16 images. (5343396 of 5474668 bytes remaining)
Sent 4 of 16 images. (5073416 of 5474668 bytes remaining)
Sent 5 of 16 images. (5056612 of 5474668 bytes remaining)
Sent 6 of 16 images. (5026240 of 5474668 bytes remaining)
Sent 7 of 16 images. (2479376 of 5474668 bytes remaining)
Sent 8 of 16 images. (889892 of 5474668 bytes remaining)
Sent 9 of 16 images. (865316 of 5474668 bytes remaining)
Sent 10 of 16 images. (754512 of 5474668 bytes remaining)
Sent 11 of 16 images. (135796 of 5474668 bytes remaining)
Sent 12 of 16 images. (70048 of 5474668 bytes remaining)
Sent 13 of 16 images. (41164 of 5474668 bytes remaining)
Sent 14 of 16 images. (32768 of 5474668 bytes remaining)
Sent 15 of 16 images. (16384 of 5474668 bytes remaining)
Sent 16 of 16 images. (0 of 5474668 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.

Rescan-attached

Verifica novamente os dispositivos conectados ligando e desligando todas as suas portas FTDI e exibe a contagem total de dispositivos conectados. Use este comando ao solucionar problemas de conexão de dispositivos no Windows. Este comando é executado apenas no Windows.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

 azsphere device rescan-attached
 -----------
 Count
 ===========
 2
 -----------

restart

Reinicia o dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device restart
Restarting device.
Device restarted successfully.

show

Exibe detalhes de um dispositivo anexado em seu locatário do Azure Sphere.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando. Esse parâmetro é necessário quando vários dispositivos estão conectados ou quando nenhum dispositivo está conectado. O dispositivo conectado no momento é usado por padrão. Você pode fornecer uma ID de dispositivo para um dispositivo não anexado ou pode especificar o endereço IP ou a ID de conexão local de um dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-t, --inquilino	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device show
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                                                         TenantId                             ChipSku  ProductId                            DeviceGroupId
 ========================================================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------

Você pode usar o --query parâmetro para personalizar a saída exibida para este comando. Para obter mais informações, consulte Consultar saída do comando da CLI.

O exemplo a seguir mostra como selecionar apenas a ID do dispositivo e a ID do produto:

azsphere device show --device 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968  --query '{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

show-attached

Exibe informações sobre o dispositivo conectado no dispositivo propriamente dito. Esses detalhes são diferentes daqueles que o Serviço de Segurança do Azure Sphere armazena para o dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device show-attached
Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
IP address: 192.128.48.1
Connection path: 21143

show-deployment-status

Exibe o status de implantação do aplicativo e das atualizações do sistema operacional para o dispositivo.

Use este comando para descobrir qual versão do sistema operacional do Azure Sphere seu dispositivo está executando ou se a atualização da implantação atual foi concluída.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-t, --inquilino	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device show-deployment-status
Your device is running Azure Sphere OS version <version-number>.
The Azure Sphere Security Service is targeting this device with Azure Sphere OS version <version-number>.
Your device has the expected version of the Azure Sphere OS: <version-number>.

Neste exemplo, <version-number> representa a versão atual do sistema operacional.

show-count

Exibe o número de dispositivos no locatário atual.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-t, --inquilino	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

 azsphere device show-count
 ------
 Result
 ======
 2
 ------

show-os-version

Exibe a versão atual do sistema operacional no dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device show-os-version
Your device is running Azure Sphere OS version <version-number>

Neste exemplo, <version-number> representa a versão atual do sistema operacional.

carregamento lateral

Gerencia o aplicativo no dispositivo.

Algumas opções de sideload exigem recursos adicionais quando o dispositivo está no estado de fabricação DeviceComplete. O recurso fieldServicing permite implantar e excluir imagens temporárias assinadas pela produção e implantar imagens permanentes assinadas pela produção. O recurso appDevelopment permite implantar e excluir imagens assinadas pela produção e pelo SDK.

Operação	Descrição
excluir	Exclui o aplicativo atual do dispositivo.
deploy	Carrega um aplicativo no dispositivo.
definir tempo limite de implantação	Define o período de tempo limite de implantação em segundos.
mostrar tempo limite de implantação	Mostra o período de tempo limite de implantação em segundos.

Observe que os parâmetros para start, stop, show-status, e show-quota foram movidos para o comando azsphere device app .

sideload delete

Exclui aplicativos do dispositivo.

Esse comando só estará disponível se a funcionalidade do dispositivo appDevelopment estiver configurada.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-i, --id do componente	GUID	Especifica a ID do aplicativo a ser excluído do dispositivo. Se omitido, exclui todos os aplicativos.
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device sideload delete
Component '54acba7c-7719-461a-89db-49c807e0fa4d' deleted.

sideload deploy

Carrega um aplicativo para o dispositivo conectado e inicia o aplicativo.

Este comando falha se o manifesto do aplicativo solicita um recurso que está sendo usado por um aplicativo que já está no dispositivo. Nesse caso, use azsphere device sideload delete para excluir o aplicativo existente e, em seguida, tente novamente realizar o sideload. O comando azsphere device sideload delete exclui aplicativos de alto nível e aplicativos em tempo real. Para excluir um aplicativo e deixar o outro, especifique a ID do componente do aplicativo a ser excluído.

O mesmo comando é usado para implantar aplicativos de alto nível e aplicativos com capacidade para tempo real.

Observação

Uma reinicialização do dispositivo é acionada quando um novo aplicativo que usa periféricos é instalado e as seguintes condições são atendidas:

• O estado de fabricação do dispositivo é definido como DeviceComplete.
• O recurso appDevelopment não está presente no dispositivo. Para obter mais informações, consulte Bloqueio de configuração de periféricos.

Se uma reinicialização do dispositivo for iniciada, aguarde até que a reinicialização seja concluída e o dispositivo responda.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
-p, --pacote-de-imagem	String	Especifica o caminho e o nome do arquivo do pacote de imagens a carregar no dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-m, --início-manual	Booliano	Especifica para não iniciar automaticamente o aplicativo após carregá-lo.
--force	Booliano	Força a implantação de uma imagem que usa uma API Beta que pode não ter mais suporte.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device sideload deploy --image-package C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage
Deploying 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' to the attached device.
Image package 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' has been deployed to the attached device.

sideload set-deployment-timeout

Define o valor de tempo limite de implantação em segundos para sideload de imagens no dispositivo.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
-v, --valor	Inteiro	Especifica a duração em segundos antes que um comando de sideload atinja o tempo limite. O valor deve ser um inteiro positivo.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device sideload set-deployment-timeout --value 60
 ------------------
 Deployment timeout
 ==================
 60
 ------------------

sideload show-deployment-timeout

Exibe o valor de tempo limite de implantação atual em segundos para sideload de imagens no dispositivo.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device sideload show-deployment-timeout
 ------------------
 Deployment timeout
 ==================
 60
 ------------------

update

Move o dispositivo para um grupo de dispositivos diferente em seu locatário do Azure Sphere.

Além dos grupos de dispositivos que você cria em um produto, cinco grupos de dispositivos padrão são adicionados quando um produto é criado:

• Desenvolvimento: Aceita apenas atualizações de software do sistema. Não aceita atualizações de aplicativos.
• Teste de campo: aceita todas as atualizações do Serviço de Segurança do Azure Sphere.
• Produção: aceita todas as atualizações do Serviço de Segurança do Azure Sphere.
• Avaliação do sistema operacional de produção: aceita todas as atualizações do Serviço de Segurança do Azure Sphere.
• Avaliação do sistema operacional de teste de campo: aceita todas as atualizações do Serviço de Segurança do Azure Sphere.

Para obter mais informações sobre os elementos fundamentais envolvidos na implantação, consulte Noções básicas de implantação.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-g, --grupo-de-dispositivos	GUID ou nome	Especifica o grupo de dispositivos no qual mover o dispositivo. Você pode especificar a ID do grupo de dispositivos ou o nome do grupo de dispositivos. Para usar o nome do grupo de dispositivos, você deve fornecer o nome do produto e o nome do grupo de dispositivos no <product-name/device-group-name> formato.
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando. Esse parâmetro é necessário quando vários dispositivos estão conectados ou quando nenhum dispositivo está conectado. O dispositivo conectado no momento é usado por padrão. Você pode fornecer uma ID de dispositivo para um dispositivo não anexado ou pode especificar o endereço IP ou a ID de conexão local de um dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-t, --inquilino	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device update --device-group AW100/Marketing
 ------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                               TenantId                             ChipSku  ProductId                            DeviceGroupId
 ==============================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
 427D205E46A166B7E41135EB968
 ------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------

Você pode usar o --query parâmetro para personalizar a saída exibida para este comando. Para obter mais informações, consulte Consultar saída do comando da CLI.

O exemplo a seguir mostra como selecionar apenas a ID do dispositivo e a ID do produto:

azsphere device update --device-group AW100/Marketing  --query '{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

wifi

Gerencia as configurações de Wi-Fi para o dispositivo conectado.

Para usar o dispositivo em uma rede Wi-Fi, você deve adicionar informações sobre a rede e ativá-la no dispositivo. Embora você possa inserir caracteres não ASCII em SSIDs, azsphere não os exibe corretamente.

Se o aplicativo usar a API de configuração de Wi-Fi, você também deverá incluir o recurso WifiConfig no arquivo app_manifest.json do aplicativo.

Operação	Descrição
add	Adiciona os detalhes de uma rede sem fio ao dispositivo.
disable	Desabilita uma rede sem fio no dispositivo.
enable	Habilita uma rede sem fio no dispositivo.
forget	Remove os detalhes de uma rede sem fio do dispositivo.
lista	Lista a configuração de Wi-Fi atual para o dispositivo.
reload-config	Recarrega a configuração de Wi-Fi do dispositivo.
scan	Examina em busca de redes disponíveis.
show	Exibe os detalhes de uma configuração de Wi-Fi.
show-status	Exibe o status da interface sem fio.

wifi add

Adiciona detalhes de uma rede Wi-Fi ao dispositivo conectado.

Um dispositivo pode ter várias conexões Wi-Fi. Embora você possa inserir caracteres não ASCII em SSIDs, azsphere não os exibe corretamente. Você pode incluir o --targeted-scan parâmetro para se conectar a SSIDs ocultos. Para obter mais informações, consulte Conectar o Azure Sphere ao Wi-Fi.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
-s, --ssid	String	Especifica o SSID da rede. Os SSIDs de rede diferenciam maiúsculas de minúsculas.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
--client-cert-id	String	[EAP-TLS] Especifica o identificador (até 16 caracteres) que identifica o certificado do cliente (contendo a chave pública e privada). Obrigatório para configurar uma rede EAP-TLS.
--client-id <user@domain>	String	[EAP-TLS] Especifica a ID reconhecida para autenticação pelo servidor RADIUS da rede. Obrigatório para algumas redes EAP-TLS.
--config-nome	String	Especifica uma cadeia de caracteres (até 16 caracteres) que especifica o nome da configuração de rede.
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
--root-ca-cert-id	String	[EAP-tLS] Especifica o identificador (até 16 caracteres) que identifica o certificado CA raiz do servidor para redes EAP-TLS em que o dispositivo autentica o servidor.
--varredura direcionada	Booliano	Tentará se conectar a uma rede mesmo quando ela não estiver difundindo ou estiver oculta por congestionamento de rede.
-p, --psk	String	Especifica a chave WPA/WPA2 para a nova rede. Omita esta opção para adicionar o SSID como uma rede aberta. Se sua chave contém um e comercial (&), coloque-a entre aspas.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device wifi add --ssid MyNetwork --psk MyPassword
Successfully added network:
 ----- -------- ------------------ --------------- ------------- ------------
 ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
 ============================================================================
 1     MyNetwork enabled            unknown         psk           False
 ----- -------- ------------------ --------------- ------------- ------------

Se o SSID ou a chave de rede tiver espaços incorporados ou um E comercial, coloque o SSID ou a chave entre aspas simples. Se o SSID ou a chave contiver aspas, use uma barra invertida como escape das aspas. As barras invertidas não precisam ser escapadas se fizerem parte de um valor. Para obter mais informações, consulte Aspas e caracteres de escape. Por exemplo:

azsphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"

wifi disable

Desativa uma rede Wi-Fi no dispositivo conectado.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
-i, --id	Inteiro	Especifica a ID da rede a desabilitar.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device wifi disable --id 0
Successfully disabled network:
----- -------- ------------------ --------------- ------------- ------------
ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0     MyNetwork disabled           disconnected    psk           False
----- -------- ------------------ --------------- ------------- ------------

wifi enable

Habilita uma rede Wi-Fi no dispositivo conectado.

Para alterar de uma rede para outra se ambas estiverem dentro do alcance, desabilite a rede atualmente conectada antes de habilitar a nova rede.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
-i, --id	Inteiro	Especifica a ID da rede a habilitar.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device wifi enable --id 0
Successfully enabled network:
 ----- -------- ------------------ --------------- ------------- ------------
 ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
 ============================================================================
 0     MyNetwork enabled            disconnected    psk           False
 ----- -------- ------------------ --------------- ------------- ------------

wifi forget

Remove detalhes de uma rede Wi-Fi do dispositivo conectado.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
-i, --id	Inteiro	Especifica a ID da rede a excluir.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device wifi forget --id 0
Successfully forgotten network.

wifi list

Lista a configuração atual de Wi-Fi para o dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device wifi list
 ----- --------- ------------------ --------------- ------------- ------------
 ID    SSID      ConfigurationState ConnectionState SecurityState TargetedScan
 =============================================================================
 0     MyNetwork1 enabled            connected       psk           False
 ----- ---------  ------------------ --------------- ------------- ------------
 1     MyNetwork2 enabled            disconnected    psk           False
 ----- ---------  ------------------ --------------- ------------- ------------
 2     MyNetwork3 enabled            disconnected    eaptls        False
 ----- ---------  ------------------ --------------- ------------- ------------

wifi reload-config

Recarrega a configuração de rede Wi-Fi no dispositivo conectado. Use esse comando depois de adicionar ou remover um certificado (certificado de dispositivo azsphere) para garantir que as redes EAP-TLS usem o conteúdo mais recente do repositório de certificados.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device wifi reload-config
Wi-Fi configuration was successfully reloaded.

wifi scan

Procure redes Wi-Fi disponíveis visíveis para o dispositivo conectado. O comando retorna até 64 redes Wi-Fi, mas o número de redes Wi-Fi exibidas pode ser limitado por fatores ambientais, como a densidade dos pontos de acesso no alcance.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device wifi scan
----------------- ------------- ----------------- ----------- ---------
SSID              SecurityState BSSID             SignalLevel Frequency
=======================================================================
MyNetwork0        psk           <value>           -66         2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork1        psk           <value>           -75         2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork2        psk           <value>           -86         2412
----------------- ------------- ----------------- ----------- ---------

wifi show

Mostra detalhes de uma rede Wi-Fi no dispositivo conectado.

Parâmetros obrigatórios

Parâmetro	Tipo	Descrição
-i, --id	Inteiro	Especifica a ID da configuração de rede a ser mostrada.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device wifi show --id 0
 ----- --------- ------------------ --------------- ------------- ------------
 ID    SSID      ConfigurationState ConnectionState SecurityState TargetedScan
 =============================================================================
 0     MyNetwork enabled            disconnected    psk           False
 ----- --------- ------------------ --------------- ------------- ------------

wifi show-status

Mostra o status da interface Wi-Fi no dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos estão conectados. Esse parâmetro é necessário quando vários dispositivos estão conectados. O dispositivo conectado no momento é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID da conexão local do dispositivo conectado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro	Descrição
--debug	Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query	Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

 azsphere device wifi show-status
 ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
 SSID  ConfigurationState ConnectionState SecurityState Frequency Mode    KeyManagement WpaState  IpAddress     MacAddress
 ================================================================================================================================
<value> enabled            connected       psk           2412      station WPA2-PSK      COMPLETED <value>      <value>
 ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------