Dispositivo

Gerencia dispositivos do Azure Sphere.

Operação	Descrição
App	Altera o status de aplicativos em um dispositivo.
Capacidade	Gerencia os recursos do dispositivo.
Certificado	Gerencia o repositório de certificados do dispositivo.
Reivindicar	Declara um dispositivo não reclamado anteriormente para o locatário do Azure Sphere.
enable-cloud-test	Configura um dispositivo para desabilitar a depuração e receber atualizações.
enable-development	Configura um dispositivo para depuração local.
Imagem	Gerencia imagens de um dispositivo.
Lista	Exibe todos os dispositivos no locatário.
list-attached	Listas os dispositivos anexados.
manufacturing-state	Gerencia o estado de fabricação do dispositivo anexado.
Rede	Fornece informações sobre o status de interfaces de rede no dispositivo.
Recuperar	Usa o modo de recuperação especial para carregar um novo firmware no dispositivo.
rescan-attached	Reposiciona dispositivos anexados como um auxílio de solução de problemas (somente Windows).
Reiniciar	Reinicia o dispositivo anexado.
programa	Exibe detalhes sobre a configuração de atualização do dispositivo.
show-attached	Exibe detalhes sobre o dispositivo anexado do próprio dispositivo.
show-count	Mostra o número total de dispositivos em um locatário.
show-deployment-status	Exibe o status da atualização de implantação mais recente.
show-os-version	Exibe a versão do sistema operacional do dispositivo local.
sideload	Carrega uma imagem no dispositivo anexado.
Atualização	Atualizações um dispositivo colocando-o em um grupo de dispositivos específico.
Wifi	Gerencia a configuração de Wi-Fi para o dispositivo.

App

Gerencia aplicativos no dispositivo.

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

Você pode usar azsphere device app stop e azsphere device app start to restart a running real-time capable application to determine which real-time core it is running on.

Operação	Descrição
show-memory-stats	Exibe as estatísticas de memória para aplicativos no dispositivo anexado.
show-quota	Exibe a quantidade de armazenamento usada pelo aplicativo atual no dispositivo.
show-status	Retorna o status do aplicativo atual no dispositivo.
Começar	Inicia o aplicativo carregado no dispositivo.
Parar	Interrompe o aplicativo que está em execução no dispositivo.

app show-memory-stats

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

Você define a cota de armazenamento mutável no manifesto do aplicativo e o sistema operacional do Azure Sphere impõe cotas quando aloca setores para o arquivo. Como resultado, se você diminuir o 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ê altera 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	Descrição
-i, --component-id	GUID	Especifica a ID do componente para o qual obter informações de cota. Se omitido, mostra informações de cota para todos os componentes.
-d, --device	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são anexados. Esse parâmetro é necessário quando vários dispositivos são anexados. O dispositivo atualmente anexado é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID de conexão local do dispositivo anexado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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.

aplicativo show-status

Exibe o status atual dos aplicativos no dispositivo.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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	Descrição
--debug-mode	Boolean	Inicia o aplicativo para depuração. O --component-id deve ser fornecido.
-d, --device	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são anexados. Esse parâmetro é necessário quando vários dispositivos são anexados. O dispositivo atualmente anexado é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID de conexão local do dispositivo anexado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-i, --component-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	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

parada do aplicativo

Interrompe os aplicativos no dispositivo.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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 de download de recursos do dispositivo do azsphere . Você pode aplicar a configuração de funcionalidade do dispositivo ao dispositivo anexado do Azure Sphere usando o comando de atualização de funcionalidade do dispositivo do azsphere e pode criar uma sessão de manutenção usando o comando selecionar recursos do dispositivo do azsphere . Para obter mais informações sobre os recursos do dispositivo, consulte Recursos de dispositivo e comunicação.

Operação	Descrição
Download	Baixa uma configuração de funcionalidade do dispositivo do Serviço de Segurança do Azure Sphere.
Selecione	Seleciona um arquivo de funcionalidade baixado a ser usado para uma sessão de manutenção.
show-attached	Exibe a configuração de funcionalidade do dispositivo anexado.
Atualização	Aplica uma configuração de capacidade do dispositivo ao dispositivo anexado.

download de recursos

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

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

Baixar o recurso fieldServicing resulta em um arquivo que contém a funcionalidade de um único dispositivo do Azure Sphere. O arquivo de funcionalidade fieldServicing é baixado no computador local e pode ser usado em conjunto com o comando selecionar recursos do dispositivo do azsphere .

Parâmetros necessários

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

recurso selecione

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

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

Quando você usa o recurso fieldServicing , a comunicação é habilitada entre o dispositivo do Azure Sphere e o computador local que contém o arquivo de funcionalidade. O arquivo de funcionalidade fieldServicing é usado para uma sessão entre o computador local e o dispositivo Azure Sphere, e cada comando na sessão é pré-configurado com uma mensagem indicando o arquivo de funcionalidade em uso.

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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.

recurso show-attached

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

Nota

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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 funcionalidade

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

Parâmetros necessários

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

Operação	Descrição
Adicionar	Adiciona um certificado ao repositório de certificados no dispositivo anexado.
Excluir	Exclui um certificado do repositório de certificados do dispositivo anexado.
Lista	Listas as IDs de certificado disponíveis no repositório de certificados do dispositivo anexado.
programa	Exibe detalhes de um certificado no repositório de certificados do dispositivo anexado.
show-quota	Exibe o espaço gratuito disponível no repositório de certificados do dispositivo anexado.

adição de certificado

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

A AC raiz e os certificados de cliente devem estar no formato .pem para serem carregados no dispositivo do Azure Sphere. Você precisa adquirir o certificado de AC Raiz do servidor apropriado, juntamente com o certificado do cliente e a chave privada (e, opcionalmente, uma senha para sua chave privada) para seu dispositivo. Cada certificado deve ser gerado e assinado pelo servidor apropriado em sua rede EAP-TLS. 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 AC raiz, consulte Adquirir e implantar certificados para redes EAP-TLS.

Cuidado

Como as IDs de certificado são em todo o sistema para certificados de ca raiz e cliente, um comando azsphere ou uma chamada de função que adiciona um novo certificado pode substituir um certificado que foi adicionado por um comando ou chamada de função anterior, potencialmente causando falhas de conexão de rede. Recomendamos que você desenvolva procedimentos claros de atualização de certificado e escolha as IDs de certificado cuidadosamente.

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

Parâmetros necessários

Parâmetro	Tipo	Descrição
-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 (_), período (.) e hífen (-). Esse identificador também é usado em configurações de Wi-Fi para redes EAP-TLS.
--cert-type	String	Especifica o tipo de certificado a ser adicionado, cliente ou rootca.
-p, --public-key-file	String	Especifica o caminho para um arquivo .pem de certificado de chave pública. Você pode fornecer um caminho relativo ou absoluto.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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 repositório de certificados do dispositivo anexado.

Parâmetros necessários

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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 certificados

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

Parâmetros necessários

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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 gratuito disponível no repositório de certificados do dispositivo anexado.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

Reivindicar

Declara um dispositivo não reclamado 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 pode ser reivindicado apenas uma vez. Depois de reivindicado, um dispositivo não pode ser movido para um locatário diferente.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

Lê o dispositivo anexado para testar o carregamento de nuvem desabilitando o desenvolvimento do aplicativo, excluindo todos os aplicativos existentes e habilitando atualizações de aplicativos carregadas na nuvem.

Ele requer que um dispositivo seja anexado ao computador e opera apenas no dispositivo anexado.

Especificamente, enable-cloud-test:

• Remove o recurso appDevelopment para o dispositivo anexado.
• Atribui o dispositivo a um grupo de dispositivos que habilita atualizações de aplicativos carregadas na nuvem.
• Reinicializa 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 o dispositivo azsphere enable-cloud-test for executado sem parâmetros, o dispositivo será colocado no grupo de dispositivos teste de campo do produto atual do dispositivo. Esse é 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 um grupo de dispositivos de Teste de Campo não existir dentro dele.

Se um produto for especificado, o dispositivo será colocado no grupo de dispositivos 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 aplicativo.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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 ao grupo de dispositivos existente por sua ID

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

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

Exemplo 2. Atribuir dispositivo a um grupo de dispositivos diferente

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

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

Exemplo 3. Atribuir dispositivo por nome do produto

Este exemplo permite o carregamento na nuvem e atribui o dispositivo a um produto por nome.

azsphere device enable-cloud-test --product DW100

enable-development

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

Especificamente, habilitação-desenvolvimento:

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

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

• Se o dispositivo ainda não tiver um produto ou grupo de dispositivos, o comando baixará e aplicará a funcionalidade appDevelopment para o dispositivo anexado e reiniciará 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 Início Rápido para criar um aplicativo de alto nível não foi 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 aplicativo são desabilitadas para esse grupo, garantindo que os aplicativos sideload não sejam substituídos.

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

• Places o dispositivo no grupo de dispositivos de desenvolvimento para o 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:

• Places o dispositivo no grupo de dispositivos especificado é especificado. O grupo de dispositivos de destino não deve habilitar atualizações de aplicativo ou um erro é retornado.

Em alguns casos, o dispositivo azsphere enable-development relata um erro e sugere que você reclame o dispositivo. Se você já reivindicou o dispositivo, use azsphere tenant show-selected para garantir que você esteja conectado ao locatário no qual você reivindicou o dispositivo. Caso contrário, use o logon do azsphere para fazer logon no locatário correto. Quando tiver certeza de que está conectado ao locatário apropriado, use azsphere device claim para reivindicar o dispositivo.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

Imagem

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

Operação	Descrição
list-installed	Fornece detalhes sobre as imagens instaladas no dispositivo anexado no momento.
list-targeted	Fornece detalhes sobre as imagens direcionadas ao dispositivo anexado.

lista de imagens instalada

Listas as imagens instaladas no dispositivo anexado. A lista de informações inclui o componente e as IDs de imagem.

Nota

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

destino da lista de imagens

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

Lista

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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, confira Saída de comando da CLI de consulta.

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

Ponta

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

list-attached

Listas os dispositivos anexados ao computador local.

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

manufacturing-state

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

Operação	Descrição
programa	Exibe o estado de fabricação do dispositivo anexado.
Atualização	Atualizações o estado de fabricação do dispositivo anexado.

Cuidado

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

manufacturing-state show

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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 de estado de fabricação

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

Cuidado

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

Parâmetros necessários

Parâmetro	Tipo	Descrição
-s, --state	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	Descrição
-d, --device	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são anexados. Esse parâmetro é necessário quando vários dispositivos são anexados. O dispositivo atualmente anexado é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID de conexão local do dispositivo anexado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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.

Rede

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

Operação	Descrição
Permitir	Habilita uma interface de rede no dispositivo anexado.
Desativar	Desabilita uma interface de rede no dispositivo anexado.
list-firewall-rules	Listas as regras de firewall para o dispositivo anexado.
list-interfaces	Listas as interfaces de rede do dispositivo anexado.
Proxy	Gerencia as configurações de proxy de rede.
show-diagnóstico	Mostra diagnóstico de rede para uma ou todas as redes sem fio no dispositivo anexado.
show-status	Mostra o status de rede do dispositivo anexado.
update-interface	Atualizações uma configuração de interface de rede para o dispositivo.

habilitação de rede

Habilita uma interface de rede no dispositivo anexado.

Nota

Esse comando tem suporte para configurar a Ethernet eth0 e wlan0 as conexões. Um erro será retornado se você configurar lo ou azspheresvc.

Parâmetros necessários

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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.

desabilitar a rede

Desabilita uma interface de rede no dispositivo anexado.

Nota

Esse comando tem suporte para configurar a Ethernet eth0 e wlan0 as conexões. Um erro será retornado se você configurar lo ou azspheresvc.

Parâmetros necessários

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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.

rede list-firewall-rules

Listas as regras de firewall para o dispositivo anexado.

Parâmetros opcionais

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

As seguintes regras são exibidas:

• Nome do conjunto de regras do firewall: exibe o nome do bloco de regras do firewall.
  • Os valores são PREROUTING, POSTROUTING, INPUT, FORWARD e OUTPUT.
• É o Ruleset Valid: 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 do computador de envio.
  • Máscara de origem: exibe a máscara de rede do computador de envio.
  • IP de destino: exibe o endereço IP do computador de destino.
  • Máscara de Destino: exibe a máscara de rede do computador de dessetomação.
  • UID: exibe a identificação do usuário aplicada à regra. 4294967295 (0xFFFFFFFF) significa que nenhuma UID foi aplicada e, portanto, se aplica a todos.
  • Ação: exibe a ação a ser tomada. Os valores podem ser aceitos ou suspensos.
  • Nome in da interface: exibe o nome da interface de entrada. Por exemplo, wlan0.
  • Nome OUT da interface: exibe o nome da interface de saída. Por exemplo, wlan0.
  • Estado: exibe o estado de conexão. Os valores não são nenhum, estabelecido ou relacionado.
  • Máscara TCP: exibe a matriz de máscaras TCP. Os valores são fin, syn, rst, psh, ack e urg.
  • Cmp TCP: exibe a matriz de sinalizadores TCP. Os valores são urg, ack, psh, rst, syb e fin.
  • TCP Inv: Boolean indica que a sensação dos sinalizadores TCP deve ser invertida. 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 porta de origem: exibe o intervalo de portas da origem que envia o tráfego. O valor pode estar entre 0 e 65535.
  • Intervalo de Porta 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 dos sinalizadores é listado da seguinte maneira:

• URG: campo 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	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

rede list-interfaces

Listas as interfaces de rede do dispositivo anexado.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

Nota

Atualmente, há suporte apenas para proxies HTTP.

Operação	Descrição
proxy aplicar	Configura o proxy de rede no dispositivo anexado.
exclusão de proxy	Exclui a conexão proxy no dispositivo anexado.
proxy show	Mostra a conexão de proxy no dispositivo anexado.

proxy aplicar

Configura o proxy de rede no dispositivo anexado.

Parâmetros necessários

Parâmetro	Tipo	Descrição
-a, --address	String	Especifica o endereço de rede do proxy a ser usado.
-t, --authentication	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 uma senha, defina-o como basic, caso contrário, use anonymous.
-r, --port	Inteiro	Especifica a porta no endereço de rede a ser usado. O valor deve ser igual ou menor que 65535.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

proxy show

Mostra a conexão de proxy no dispositivo anexado.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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-diagnóstico de rede

Mostra diagnóstico para uma ou todas as redes de Wi-Fi no dispositivo anexado.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

show-status de rede

Mostra o status de rede do dispositivo anexado.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

rede update-interface

Atualizações 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

Esse comando tem suporte para configurar conexões Ethernet eth0 . Um erro será retornado se você configurar lo, azspheresvc ou wlan0.

Parâmetros necessários

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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	Descrição
-d, --device	String	Especifica o dispositivo para executar o comando quando vários dispositivos são anexados. O dispositivo atualmente anexado é usado por padrão. Especifique a ID, o endereço IP ou a ID de conexão local do dispositivo.
-c, --capability	String	Especifica a imagem de funcionalidade do dispositivo a ser aplicada ao dispositivo durante a recuperação.
-i, --images	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	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

Reposiciona os dispositivos anexados por meio do power-cycling de todas as portas FTDI e exibe a contagem total de dispositivos anexados. Use esse comando ao solucionar problemas de conexão de dispositivo no Windows. Esse comando é executado somente no Windows.

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

Reiniciar

Reinicia o dispositivo anexado.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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.

programa

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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, confira Saída de comando da CLI de consulta.

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

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

show-attached

Exibe informações sobre o dispositivo anexado 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	Descrição
-d, --device	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são anexados. Esse parâmetro é necessário quando vários dispositivos são anexados. O dispositivo atualmente anexado é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID de conexão local do dispositivo anexado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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 do Azure Sphere seu dispositivo está em execução ou se a atualização de implantação atual foi concluída.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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> de versão representa a versão atual do sistema operacional.

show-count

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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> de versão representa a versão atual do sistema operacional.

sideload

Gerencia o aplicativo no dispositivo.

Algumas opções de sideload exigem recursos adicionais depois que o dispositivo estiver no estado de fabricação DeviceComplete. A funcionalidade fieldServicing permite implantar e excluir imagens temporárias assinadas pela produção e implantar imagens permanentes assinadas pela produção. A funcionalidade appDevelopment permite implantar e excluir imagens assinadas pela produção e assinadas pelo SDK.

Operação	Descrição
Excluir	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 do aplicativo de dispositivo do azsphere .

sideload delete

Exclui aplicativos do dispositivo.

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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 anexado e inicia o aplicativo.

Esse 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 a ID do componente do aplicativo a ser excluído.

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

Nota

Uma reinicialização de dispositivo é disparada 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.
• A funcionalidade appDevelopment não está presente no dispositivo. Para obter mais informações, confira Bloqueio de configuração periférico.

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

Parâmetros necessários

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

Parâmetros opcionais

Parâmetro	Tipo	Descrição
-d, --device	String	Especifica o dispositivo no qual executar o comando quando vários dispositivos são anexados. Esse parâmetro é necessário quando vários dispositivos são anexados. O dispositivo atualmente anexado é usado por padrão. Você pode especificar a ID do dispositivo, o endereço IP ou a ID de conexão local do dispositivo anexado. A CLI do Azure Sphere dá suporte a vários dispositivos MT3620 no Windows, mas você pode conectar apenas um dispositivo por vez no Linux. Por esse motivo, esse parâmetro tem suporte para Windows, mas não para Linux. Um erro será retornado se você usar esse parâmetro com o comando no Linux.
-m, --manual-start	Boolean	Especifica para 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 ter mais suporte.

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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 necessários

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

Atualização

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

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

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

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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, confira Saída de comando da CLI de consulta.

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

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

Wifi

Gerencia Wi-Fi configurações para o dispositivo anexado.

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

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

Operação	Descrição
Adicionar	Adiciona os detalhes de uma rede sem fio ao dispositivo.
Desativar	Desabilita uma rede sem fio no dispositivo.
Permitir	Habilita uma rede sem fio no dispositivo.
Esquecer	Remove os detalhes de uma rede sem fio do dispositivo.
Lista	Listas a configuração de Wi-Fi atual para o dispositivo.
reload-config	Recarrega a configuração do dispositivo Wi-Fi.
Varredura	Verifica se há redes disponíveis.
programa	Exibe detalhes de uma configuração de Wi-Fi.
show-status	Exibe o status da interface sem fio.

wi-fi add

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

Um dispositivo pode ter várias conexões Wi-Fi. Embora você possa inserir caracteres não ASCII em SSIDs, o 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, confira Conectar o Azure Sphere ao Wi-Fi.

Parâmetros necessários

Parâmetro	Tipo	Descrição
-s, --ssid	String	Especifica o SSID da rede. Os SSIDs de rede são sensíveis a casos.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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 inseridos ou um ampersand, inclua o SSID ou a chave em aspas individuais. Se o SSID ou a chave incluir uma marca de cotação, use um backslash para escapar da marca de cotação. Os backslashes não precisam ser escapados se fizerem parte de um valor. Para obter mais informações, consulte Aspas e os caracteres de escape. Por exemplo:

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

wifi desabilitar

Desabilita uma rede de Wi-Fi no dispositivo anexado.

Parâmetros necessários

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

habilitar wi-fi

Habilita uma rede de Wi-Fi no dispositivo anexado.

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

Parâmetros necessários

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

wi-fi esquecer

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

Parâmetros necessários

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

Listas a configuração de Wi-Fi atual para o dispositivo anexado.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

configuração de recarga de wi-fi

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

Verifique se há redes de Wi-Fi disponíveis visíveis no dispositivo anexado. O comando retorna até 64 Wi-Fi redes, mas o número de redes Wi-Fi exibidas pode ser limitado por fatores ambientais, como a densidade de pontos de acesso no intervalo.

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

wi-fi show

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

Parâmetros necessários

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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

wi-fi show-status

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

Parâmetros opcionais

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

Parâmetros globais

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

Parâmetro	Descrição
--Depurar	Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado ao enviar um relatório de bugs.
-h, --help	Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors	Mostra apenas erros, suprimindo avisos.
-o, --output	Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Valores Separados por Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da CLI do Azure para obter mais informações e exemplos.
--Verbose	Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

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