device

Importante

Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) 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.

Operation	Description
aplicativo	Altera o status de aplicativos em um dispositivo.
capacidade	Gerencia os recursos do dispositivo.
certificado	Gerencia o armazenamento de certificados de dispositivo.
reivindicação	Declara um dispositivo não reivindicado anteriormente para o locatário do Azure Sphere.
enable-cloud-test	Configura um dispositivo para desativar a depuração e receber atualizações.
capacitar-desenvolvimento	Configura um dispositivo para depuração local.
imagem	Gerencia imagens para um dispositivo.
list	Exibe todos os dispositivos no locatário.
lista anexada	Lista os dispositivos anexados.
Estado-Fabricação	Gerencia o estado de fabricação do dispositivo conectado.
rede	Fornece informações sobre o status das interfaces de rede no dispositivo.
recuperar	Usa o modo de recuperação especial para carregar o novo firmware no dispositivo.
rescan-anexado	Verifica novamente os dispositivos conectados como uma ajuda de solução de problemas (somente Windows).
reiniciar	Reinicia o dispositivo ligado.
programa	Exibe detalhes sobre a configuração de atualização do dispositivo.
show-anexado	Exibe detalhes sobre o dispositivo conectado do próprio dispositivo.
contagem-espetáculo	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-versão	Exibe a versão do sistema operacional do dispositivo local.
carga lateral	Carrega uma imagem no dispositivo conectado.
atualizar	Atualiza um dispositivo colocando-o em um grupo de dispositivos específico.
Wi-Fi	Gerencia a configuração Wi-Fi do dispositivo.

Aplicação

Gerencia aplicativos no dispositivo.

Muitas das opções do aplicativo exigem o recurso appDevelopment, que pode ser adquirido usando azsphere device enable-development. Para iniciar, parar ou depurar um aplicativo assinado por SDK ou um aplicativo assinado em produção, o dispositivo deve ter o recurso appDevelopment .

Você pode usar azsphere device app stop e azsphere device app start para reiniciar um aplicativo capaz de executar em tempo real para determinar em qual núcleo em tempo real ele está sendo executado.

Operation	Description
show-memory-stats	Exibe as estatísticas de memória para aplicativos no dispositivo conectado.
show-quota	Exibe a quantidade de armazenamento usada pelo aplicativo atual no dispositivo.
show-status	Retorna o status do aplicativo atual no dispositivo.
start	Inicia o aplicativo que é carregado no dispositivo.
parar	Para o aplicativo que está sendo executado no dispositivo.

app show-memory-stats

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 Azure Sphere impõe cotas quando aloca setores para o arquivo. Como resultado, se você diminuir o MutableStorage valor, a quantidade de armazenamento em uso não será alterada, mas o valor alocado relatado será diferente. Por exemplo, se o aplicativo já usou 16 KB e você alterar o MutableStorage valor para 8 KB, o comando informa que o aplicativo usa 16 KB de 8 KB alocados. Os dados permanecem no dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Description
-i, --componente-id	GUID	Especifica a ID do componente para o qual obter informações de cota. Se omitido, mostra as informações de cota para todos os componentes.
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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.

status de exibição do aplicativo

Exibe o status atual dos aplicativos no dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Description
-i, --componente-id	GUID	Especifica a ID do componente para o qual o status será exibido. Se omitido, mostra o status de todos os componentes.
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

Início do aplicativo

Inicia aplicativos no dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Description
--modo de depuração	Boolean	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 são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-i, --componente-id	GUID	Especifica a ID do componente a ser iniciado. 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

Paragem da aplicação

Para os aplicativos no dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Description
-i, --componente-id	GUID	Especifica a ID do componente a ser interrompido. Se omitido, para todos os aplicativos.
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

capacidade

Gerencia os recursos do dispositivo. Os recursos do dispositivo determinam as operações que podem ser executadas em um dispositivo individual do Azure Sphere.

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 capacidade do dispositivo ao dispositivo Azure Sphere conectado 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 do dispositivo e comunicação.

Operation	Description
download	Baixa uma configuração de capacidade de dispositivo do Serviço de Segurança do Azure Sphere.
selecione	Seleciona um arquivo de capacidade baixado para usar em uma sessão de manutenção.
show-anexado	Exibe a configuração de capacidade para o dispositivo conectado.
atualizar	Aplica uma configuração de capacidade do dispositivo ao dispositivo conectado.

Download de recursos

Baixa um recurso de dispositivo do Serviço de Segurança do Azure Sphere.

O recurso appDevelopment permite fazer sideload de aplicativos assinados pelo SDK e iniciar, parar, depurar ou excluir qualquer aplicativo no dispositivo. Sem o recurso appDevelopment , apenas aplicativos carregados na nuvem podem ser carregados e iniciar, parar, depurar e excluir são proibidos. O recurso appDevelopment é aplicado como parte do comando azsphere device enable-development .

O download do recurso fieldServicing resulta em um arquivo que contém a capacidade para um único dispositivo Azure Sphere. O arquivo de capacidade fieldServicing é baixado para o computador local e pode ser usado em conjunto com o comando azsphere device capability select .

Parâmetros obrigatórios

Parâmetro	Tipo	Description
--tipo	Tipo de capacidade	Especifica o tipo de recurso do dispositivo para download. Os valores são appDevelopment, fieldServicing, ou nenhum. Use nenhum para remover o recurso appDevelopment ou o recurso fieldServicing .

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando. Este parâmetro é necessário quando vários dispositivos estão conectados ou quando nenhum dispositivo está conectado. O dispositivo atualmente conectado é usado por padrão. Você pode fornecer uma ID de dispositivo para um dispositivo não conectado 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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 de capacidade. Inclua um caminho absoluto ou relativo. Se você não fornecer um caminho, o comando armazenará o arquivo no diretório local usando a capacidade de convenção de nomenclatura tipo-primeiros<> oito caracteres do dispositivo ID.cap>.<
-t, --inquilino	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar o 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

Seleção de capacidade

Seleciona um arquivo de capacidade para usar com o dispositivo Azure Sphere conectado.

O comando azsphere device capability select pode ser usado com qualquer capacidade, mas é usado com mais frequência com o recurso 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 o recurso fieldServicing , a comunicação é habilitada entre o dispositivo Azure Sphere e o computador local que contém o arquivo de capacidade. O arquivo de capacidade fieldServicing é usado para uma sessão entre o computador local e o dispositivo Azure Sphere, e cada comando na sessão é precedido de uma mensagem indicando o arquivo de capacidade em uso.

Para encerrar uma sessão de manutenção, use a capacidade do dispositivo azsphere selecione --none.

Parâmetros opcionais

Parâmetro	Tipo	Description
--arquivo de capacidade	String	Especifica o caminho e o nome do arquivo de configuração da capacidade do dispositivo a ser selecionado. Você pode fornecer um caminho relativo ou absoluto.
-n, --nenhuma	-	Limpa qualquer configuração de capacidade de dispositivo selecionada anteriormente.

Parâmetros globais

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

Parâmetro	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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.

capacidade show-attached

Exibe a configuração de capacidade armazenada no dispositivo conectado.

Nota

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

Atualização de capacidade

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

Parâmetros obrigatórios

Parâmetro	Tipo	Description
--arquivo de capacidade	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	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando. Este parâmetro é necessário quando vários dispositivos estão conectados ou quando nenhum dispositivo está conectado. O dispositivo atualmente conectado é usado por padrão. Você pode fornecer uma ID de dispositivo para um dispositivo não conectado 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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.

certificado

Gerencia certificados no dispositivo conectado.

Operation	Description
adicionar	Adiciona um certificado ao armazenamento de certificados no dispositivo anexado.
eliminar	Exclui um certificado do armazenamento de certificados do dispositivo anexado.
list	Lista as IDs de certificado disponíveis no armazenamento de certificados do dispositivo anexado.
programa	Exibe detalhes de um certificado no armazenamento de certificados do dispositivo anexado.
show-quota	Exibe o espaço livre disponível no armazenamento de certificados do dispositivo anexado.

Certificado Adicionar

Adiciona um certificado ao armazenamento de certificados do dispositivo anexado.

A autoridade de certificação raiz e os certificados de 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 o seu dispositivo. Cada certificado deve ser gerado e assinado pelo servidor apropriado em sua rede EAP-TLS. Seu administrador de rede ou equipe de segurança pode fornecer os detalhes necessários para obter os certificados. Para obter mais informações sobre como adquirir o certificado de autoridade de certificação raiz, consulte Adquirir e implantar certificados para redes EAP-TLS.

Atenção

Como os IDs de certificado são de todo o sistema para certificados de CA de cliente e raiz, 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 chamada de função anterior, potencialmente causando falhas de conexão de rede. É altamente recomendável que você desenvolva procedimentos claros de atualização de certificado e escolha cuidadosamente os IDs de certificado.

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

Parâmetros obrigatórios

Parâmetro	Tipo	Description
-i, --cert-id	String	Especifica o identificador do certificado a ser adicionado. Um identificador de cadeia de caracteres (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 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	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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. Obrigató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 de certificado de cliente criptografada.

Parâmetros globais

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

Parâmetro	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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.

Exclusão de certificado

Exclui um certificado do armazenamento de certificados do dispositivo anexado.

Parâmetros obrigatórios

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

Lista de certificados

Lista os certificados disponíveis no armazenamento de certificados do dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

show de certificado

Mostra detalhes de um certificado individual no armazenamento de certificados do dispositivo.

Parâmetros obrigatórios

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

certificado show-quota

Exibe o espaço livre disponível no armazenamento de certificados do dispositivo anexado.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

reivindicação

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

Importante

Antes de reivindicar o dispositivo, verifique se você está conectado ao locatário correto do Azure Sphere. Um dispositivo só pode ser reivindicado uma vez. Uma vez reivindicado, um dispositivo não pode ser movido para um locatário diferente.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando. Este parâmetro é necessário quando vários dispositivos estão conectados ou quando nenhum dispositivo está conectado. O dispositivo atualmente conectado é usado por padrão. Você pode fornecer uma ID de dispositivo para um dispositivo não conectado 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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 selecionado padrão. Você pode especificar o ID do locatário ou o nome do locatário.
--força	Boolean	Força um dispositivo a ser reivindicado no locatário selecionado do Azure Sphere do usuário atual.

Parâmetros globais

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

Parâmetro	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 anexado para testar o carregamento na nuvem desativando o desenvolvimento de aplicativos, excluindo quaisquer aplicativos existentes e habilitando atualizações de aplicativos carregados na nuvem.

Requer um dispositivo para ser conectado ao PC e opera apenas no dispositivo conectado.

Especificamente, enable-cloud-test:

• Remove o recurso appDevelopment para o dispositivo conectado.
• Atribui o dispositivo a um grupo de dispositivos que permite atualizações de aplicativos carregados na nuvem.
• Reinicia o dispositivo.

As tarefas específicas que o enable-cloud-test executa dependem se um produto e um grupo de dispositivos já foram atribuídos para este dispositivo.

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

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	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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 Azure Sphere.
-t, --inquilino	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar o ID do locatário ou o nome do locatário.
-g, --grupo-dispositivo	GUID ou nome	Especifica o grupo de dispositivos para o qual o dispositivo será movido. Você pode especificar o 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 pelo seu ID

Este exemplo atribui o dispositivo anexado a um produto e grupo de dispositivos existente.

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 outro grupo de dispositivos

Este exemplo é semelhante ao exemplo anterior, mas manté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 o recurso appDevelopment. Este comando é útil para mover um dispositivo de um ambiente de desenvolvimento que não permite atualizações de aplicativos para um ambiente de produção que o faz.

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

Exemplo 3. Atribuir dispositivo por nome de produto

Este exemplo habilita o carregamento na nuvem e atribui o dispositivo a um produto pelo nome.

azsphere device enable-cloud-test --product DW100

capacitar-desenvolvimento

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 utilizar em cenários de fabrico. Consulte Fabricação de dispositivos conectados para obter mais informações.

Especificamente, capacitar o desenvolvimento:

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

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

• Se o dispositivo ainda não tiver um produto ou grupo de dispositivos, o comando baixa e aplica o recurso appDevelopment para o dispositivo conectado e reinicializa o dispositivo. Todos os aplicativos existentes permanecem no dispositivo e o sistema operacional é atualizado. O processo de instalação para reivindicar seu dispositivo e o Guia de início rápido para criar um aplicativo de alto nível não é afetado.
• 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 é especificado. O grupo de dispositivos de destino não deve habilitar atualizações de aplicativos ou um erro é retornado.

Em alguns casos, azsphere device enable-development relata um erro e sugere que você reivindique o dispositivo. Se você já reivindicou o dispositivo, use azsphere tenant show-selected para garantir que você esteja conectado ao locatário no qual reivindicou o dispositivo. Caso contrário, use azsphere login para fazer login 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	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-g, --grupo-dispositivo	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 o 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	Boolean	Instala os drivers necessários para depurar aplicativos em execução em um núcleo em tempo real. Esta opção requer 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 Azure Sphere.

Parâmetros globais

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

Parâmetro	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

image

Retorna informações sobre as imagens instaladas ou direcionadas ao dispositivo conectado.

Operation	Description
lista-instalada	Fornece detalhes sobre as imagens que estão atualmente instaladas no dispositivo conectado.
segmentada por lista	Fornece detalhes sobre as imagens que são direcionadas para o dispositivo anexado.

lista de imagens instaladas

Lista as imagens instaladas no dispositivo conectado. A lista de informações inclui os IDs do componente e da imagem.

Nota

Nomes de imagens longas são truncados em 31 caracteres.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-f, --cheio	Boolean	Lista todas as imagens de software instaladas no dispositivo. Por padrão, lista apenas imagens de aplicativos, depuradores e imagens de configuração da placa.

Parâmetros globais

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

Parâmetro	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

Lista de imagens direcionada

Lista as imagens que foram carregadas para o 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 Azure Sphere esteja pronto para aceitar atualizações de aplicativos baseados em nuvem, consulte Habilitar implantação baseada em nuvem para seu dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando. Este parâmetro é necessário quando vários dispositivos estão conectados ou quando nenhum dispositivo está conectado. O dispositivo atualmente conectado é usado por padrão. Você pode fornecer uma ID de dispositivo para um dispositivo não conectado 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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 selecionado padrão. Você pode especificar o ID do locatário ou o nome do locatário.
-f, --cheio	Boolean	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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

list

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-t, --inquilino	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar o 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 Query CLI command output.

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

Gorjeta

Execute o azsphere product 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.

lista anexada

Lista os dispositivos conectados ao PC local.

Parâmetros globais

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

Parâmetro	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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-Fabricação

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

Operation	Description
programa	Exibe o estado de fabricação do dispositivo conectado.
atualizar	Atualiza o estado de fabricação do dispositivo conectado.

Atenção

As mudanças no estado de produção são permanentes e irreversíveis.

show de estado de fabricação

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

Atualização do estado de fabricação

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

Atenção

As mudanças no estado de produção são permanentes e irreversíveis.

Parâmetros obrigatórios

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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.

Operation	Description
ativar	Permite uma interface de rede no dispositivo conectado.
desativar	Desativa uma interface de rede no dispositivo conectado.
list-firewall-rules	Lista as regras de firewall para o dispositivo conectado.
interfaces-lista	Lista as interfaces de rede para o dispositivo conectado.
procuração	Gerencia as configurações de proxy de rede.
show-diagnostics	Mostra o diagnóstico de rede para uma ou todas as redes sem fio no dispositivo conectado.
show-status	Mostra o status da rede para o dispositivo conectado.
interface-atualização	Atualiza uma configuração de interface de rede para o dispositivo.

habilitação de rede

Permite uma interface de rede no dispositivo conectado.

Nota

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	Description
--interface	string	Especifica a interface a ser habilitada.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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.

desativação da rede

Desativa uma interface de rede no dispositivo conectado.

Nota

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	Description
--interface	string	Especifica a interface a ser habilitada.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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.

lista de rede-firewall-regras

Lista as regras de firewall para o dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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 de firewall: Exibe o nome do bloco do conjunto de regras de 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, aplica-se a todos.
  • Ação: Exibe a ação a ser executada. Os valores podem ser aceitos ou descartados.
  • Interface IN name: Exibe o nome da interface de entrada. Por exemplo, wlan0.
  • Nome de saída da interface: Exibe o nome da interface de saída. Por exemplo, wlan0.
  • Estado: Exibe o estado da conexão. Os valores são nenhum, 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 da seguinte forma:

• URG: Campo de ponteiro urgente significativo
• ACK: Campo de reconhecimento significativo
• PSH: Função Push
• 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 do endereço proxy para conexão de rede. Para obter mais informações sobre como configurar um dispositivo Azure Sphere para se conectar à Internet por meio de um servidor proxy, consulte Conectar-se por meio de um servidor proxy.

Nota

Atualmente, apenas proxies HTTP são suportados.

Operation	Description
Proxy aplicar	Configura o proxy de rede no dispositivo conectado.
Exclusão de proxy	Exclui a conexão proxy no dispositivo conectado.
show de proxy	Mostra a conexão proxy no dispositivo conectado.

Proxy aplicar

Configura o proxy de rede no dispositivo conectado.

Parâmetros obrigatórios

Parâmetro	Tipo	Description
-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 isso como basic, caso contrário, use anonymous.
-r, --porta	Número inteiro	Especifica a porta no endereço de rede a ser usado. O valor deve ser igual ou inferior a 65535.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
--ativar	String	Especifica se o proxy deve ser habilitado. Você deve definir um ou --enable --disable.
--desativar	String	Especifica se o proxy deve ser desabilitado. Você deve definir um ou --enable --disable.
-n, --no-proxy-endereços	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 somente para autenticação básica. Comprimento máximo: 64 caracteres.
-u, --nome de utilizador	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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

show de proxy

Mostra a conexão proxy no dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

show-diagnostics de rede

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-n, --rede	Número 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 da rede

Mostra o status da rede para o dispositivo conectado.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 para o dispositivo. Para obter mais informações sobre como definir o endereço MAC para o dispositivo, consulte Configurar o dispositivo para Ethernet.

Nota

Este 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	Description
--hardware-endereço	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 [Desativando]	String	Especifica o nome da interface a ser configurada. Execute azsphere device network list-interfaces para visualizar detalhes das interfaces de rede para o dispositivo conectado. O --interface-name argumento será aposentado e será removido em uma versão futura. Para obter mais informações, consulte Alterações importantes (desativação de recursos) na CLI do Azure Sphere.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

recuperar

Substitui o software do sistema no dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Especifique o ID, o endereço IP ou o ID de conexão local do dispositivo.
-c, --capacidade	String	Especifica a imagem de capacidade 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 imagem 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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-anexado

Verifica novamente os dispositivos conectados por power-cycling todas as suas portas FTDI e exibe a contagem total de dispositivos conectados. Use este comando ao solucionar problemas de conexão de dispositivo 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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.

mostrar

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando. Este parâmetro é necessário quando vários dispositivos estão conectados ou quando nenhum dispositivo está conectado. O dispositivo atualmente conectado é usado por padrão. Você pode fornecer uma ID de dispositivo para um dispositivo não conectado 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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 selecionado padrão. Você pode especificar o 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 Query CLI command output.

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-anexado

Exibe informações sobre o dispositivo conectado do próprio dispositivo. Esses detalhes diferem daqueles que o Serviço de Segurança do Azure Sphere armazena para o dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 das atualizações do aplicativo e do sistema operacional para o dispositivo.

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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 selecionado padrão. Você pode especificar o 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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, <o número> da versão representa a versão atual do sistema operacional.

contagem-espetáculo

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-t, --inquilino	GUID ou nome	Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar o 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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-versão

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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, <o número> da versão representa a versão atual do sistema operacional.

carga lateral

Gerencia o aplicativo no dispositivo.

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

Operation	Description
eliminar	Exclui o aplicativo atual do dispositivo.
implantar	Carrega um aplicativo no dispositivo.
set-deployment-timeout	Define o período de tempo limite de implantação em segundos.
show-deployment-timeout	Mostra o período de tempo limite de implantação em segundos.

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

Exclusão de sideload

Exclui aplicativos do dispositivo.

Este comando só estará disponível se o recurso do dispositivo appDevelopment estiver configurado.

Parâmetros opcionais

Parâmetro	Tipo	Description
-i, --componente-id	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 são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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.

implantação de sideload

Carrega um aplicativo no dispositivo conectado e inicia o aplicativo.

Este comando falhará se o manifesto do aplicativo solicitar 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 sideload novamente. 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 o ID do componente do aplicativo a ser excluído.

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

Nota

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 de dispositivo for iniciada, aguarde até que a reinicialização seja concluída e o dispositivo se torne responsivo.

Parâmetros obrigatórios

Parâmetro	Tipo	Description
-p, --pacote de imagem	String	Especifica o caminho e o nome do arquivo do pacote de imagem a ser carregado no dispositivo.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-m, --arranque manual	Boolean	Especifica não iniciar automaticamente o aplicativo depois de carregá-lo.
--força	Boolean	Força a implantação de uma imagem que usa uma API Beta que pode não ser mais suportada.

Parâmetros globais

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

Parâmetro	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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	Description
-v, --valor	Número inteiro	Especifica a duração em segundos antes que um comando sideload atinja o tempo limite. O valor deve ser um número inteiro positivo.

Parâmetros globais

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

Parâmetro	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 criados 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 SO de Produção: Aceita todas as atualizações do Serviço de Segurança do Azure Sphere.
• Avaliação do SO 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	Description
-g, --grupo-dispositivo	GUID ou nome	Especifica o grupo de dispositivos no qual o dispositivo deve ser movido. Você pode especificar o 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. Este parâmetro é necessário quando vários dispositivos estão conectados ou quando nenhum dispositivo está conectado. O dispositivo atualmente conectado é usado por padrão. Você pode fornecer uma ID de dispositivo para um dispositivo não conectado 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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 selecionado padrão. Você pode especificar o 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 Query CLI command output.

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

Wi-Fi

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 habilitá-la no dispositivo. Embora você possa inserir caracteres não-ASCII em SSIDs, azsphere não os exibe corretamente.

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

Operation	Description
adicionar	Adiciona os detalhes de uma rede sem fio ao dispositivo.
desativar	Desativa uma rede sem fios no dispositivo.
ativar	Ativa uma rede sem fio no dispositivo.
esquecer	Remove os detalhes de uma rede sem fio do dispositivo.
list	Lista a configuração Wi-Fi atual do dispositivo.
reload-config	Recarrega a configuração Wi-Fi do dispositivo.
varredura	Verifica redes disponíveis.
programa	Exibe detalhes de uma configuração de Wi-Fi.
show-status	Exibe o status da interface sem fio.

wifi adicionar

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

Um dispositivo pode ter várias ligaçõ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	Description
-s, --ssid	String	Especifica o SSID da rede. Os SSIDs de rede diferenciam maiúsculas de minúsculas.

Parâmetros opcionais

Parâmetro	Tipo	Description
--cliente-cert-id	String	[EAP-TLS] Especifica o identificador (até 16 caracteres) que identifica o certificado do cliente (contendo as chaves pública e privada). Necessário para configurar uma rede EAP-TLS.
--ID <do cliente user@domain>	String	[EAP-TLS] Especifica a ID reconhecida para autenticação pelo servidor RADIUS da rede. Necessário para algumas redes EAP-TLS.
--config-name	String	Especifica uma cadeia de caracteres (até 16 caracteres) que especifica o nome para a configuração de rede.
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
--raiz-ca-cert-id	String	[EAP-tLS] Especifica o identificador (até 16 caracteres) que identifica o certificado de autoridade de certificação raiz do servidor para redes EAP-TLS nas quais o dispositivo autentica o servidor.
--varredura direcionada	Boolean	Tenta se conectar a uma rede mesmo quando ela não está transmitindo ou está oculta pelo congestionamento da rede.
-p, --psk	String	Especifica a chave WPA/WPA2 para a nova rede. Omita a adição do SSID como uma rede aberta. Se a sua chave contiver 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 incluir aspas, use uma barra invertida para escapar 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 desativar

Desativa uma rede Wi-Fi no dispositivo ligado.

Parâmetros obrigatórios

Parâmetro	Tipo	Description
-i, --id	Número inteiro	Especifica a ID da rede a ser desabilitada.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 ativar

Ativa uma rede Wi-Fi no dispositivo conectado.

Para mudar de uma rede para outra se ambas estiverem dentro do alcance, desative a rede atualmente conectada antes de ativar a nova rede.

Parâmetros obrigatórios

Parâmetro	Tipo	Description
-i, --id	Número inteiro	Especifica a ID da rede a ser habilitada.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 esquecer

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

Parâmetros obrigatórios

Parâmetro	Tipo	Description
-i, --id	Número inteiro	Especifica a ID da rede a ser excluída.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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.

lista wifi

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

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 da rede Wi-Fi no dispositivo ligado. Use este 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 armazenamento de certificados.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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.

Verificação WiFi

Procure redes Wi-Fi disponíveis visíveis para o dispositivo ligado. 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 de pontos de acesso no alcance.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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

show wifi

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

Parâmetros obrigatórios

Parâmetro	Tipo	Description
-i, --id	Número inteiro	Especifica a ID da configuração de rede a ser exibida.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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 estado da interface Wi-Fi no dispositivo ligado.

Parâmetros opcionais

Parâmetro	Tipo	Description
-d, --dispositivo	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são conectados. Este parâmetro é necessário quando vários dispositivos são conectados. O dispositivo atualmente conectado é usado por padrão. Você pode especificar o ID do dispositivo, o endereço IP ou o ID de 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 de cada vez no Linux. Por esse motivo, esse parâmetro é suportado 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	Description
--depuração	Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros.
-h, --ajuda	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, --saída	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--consulta	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 Query Azure CLI para obter mais informações e exemplos.
--verborrágico	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos.

Nota

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