Partilhar via

Visão geral da extensão do Azure Sphere para CLI do Azure

  • Artigo

A ferramenta de linha de comando para gerenciar dispositivos conectados ao Azure Sphere e implantações na nuvem é distribuída como uma extensão da CLI do Azure.

Instalar a CLI do Azure e a extensão do Azure Sphere

Para adquirir a extensão do Azure Sphere para a CLI do Azure:

  1. Instale a CLI do Azure se ainda não tiver feito isso.

  2. Para adicionar a extensão Azure Sphere, execute o seguinte comando:

    az extension add --name azure-sphere

Tem de iniciar sessão com a CLI do Azure para iniciar sessão na subscrição do Azure que pretende utilizar para gerir dispositivos do Azure Sphere.

Uma vez que uma extensão é instalada, sua localização é encontrada sob o valor da $AZURE_EXTENSION_DIR variável shell. Se esta variável não estiver definida, então, por predefinição, o valor é $HOME/.azure/cliextensions, no Linux e macOS, e %USERPROFILE%\.azure\cliextensions no Windows.

Gorjeta

Depois de iniciar sessão, verá uma lista de subscrições associadas à sua conta do Azure. Certifique-se de selecionar a assinatura com as permissões necessárias usando o az account set comando para que a extensão do Azure Sphere funcione corretamente. Para obter mais informações sobre a seleção de assinaturas, consulte Usar várias assinaturas do Azure.

Gerenciando a extensão do Azure Sphere

Para ver as versões instaladas das extensões da CLI do Azure, use o comando:

az version

Para atualizar a extensão do Azure Sphere para a versão mais recente, use:

az extension update --name azure-sphere

Para desinstalar a extensão do Azure Sphere, use:

az extension remove --name azure-sphere

Comandos comuns da CLI do Azure Sphere

Você pode usar os comandos do Azure Sphere digitando az sphere no prompt de comando do Windows ou no PowerShell. No Linux, você pode usar qualquer interface de linha de comando (CLI). A CLI tem conclusão de separadores completa para comandos na shell de deteção.

Esta tabela lista alguns comandos comuns do Azure Sphere e links para sua documentação de referência.

Comando Description
az sphere catalog Gerencie seu catálogo.
az sphere ca-certificate Gerencie certificados em seu catálogo.
az sphere deployment Gerencie implantações em seu catálogo.
az sphere device Gerencie dispositivos do Azure Sphere.
az sphere device-group Gerencie grupos de dispositivos em seu catálogo.
az sphere image Gerencie imagens em seu catálogo.
az sphere product Gerencie produtos em seu catálogo.
az sphere get-support-data Reúna dados de diagnóstico sobre o seu sistema, nuvem e configurações de dispositivos.

A CLI do Azure permite que você defina opções de configuração que simplificam o uso dos comandos da CLI do Azure Sphere, fornecendo padrões para parâmetros como , --resource-group--subscriptionou --catalog.

Comandos dependentes do dispositivo

O comando funciona com um dispositivo Azure Sphere conectado localmente. Se você tentar o comando sem um dispositivo conectado, você receberá um erro. Para obter mais informações sobre comandos de dispositivo, consulte, az sphere device

  • az sphere device claim
  • az sphere device recover
  • az sphere device restart
  • az sphere device show-attached
  • az sphere device show-os-version
  • az sphere device app show-memory-status
  • az sphere device app show-quota
  • az sphere device app show-status
  • az sphere device app start
  • az sphere device app stop
  • az sphere device capability show-attached
  • az sphere device capability update
  • az sphere device certificate add
  • az sphere device certificate delete
  • az sphere device certificate list
  • az sphere device certificate show
  • az sphere device certificate show-quota
  • az sphere device image list-installed
  • az sphere image-package show
  • az sphere device manufacturing-state show
  • az sphere device manufacturing-state update
  • az sphere device network proxy apply
  • az sphere device network proxy delete
  • az sphere device network proxy show
  • az sphere device network disable
  • az sphere device network enable
  • az sphere device network list-firewall-rules
  • az sphere device network list-interfaces
  • az sphere device network show-diagnostics
  • az sphere device network show-status
  • az sphere device network update-interface
  • az sphere device sideload delete
  • az sphere device sideload deploy
  • az sphere device wifi add
  • az sphere device wifi disable
  • az sphere device wifi enable
  • az sphere device wifi forget
  • az sphere device wifi list
  • az sphere device wifi reload-config
  • az sphere device wifi scan
  • az sphere device wifi show
  • az sphere device wifi show-status

Argumentos globalmente disponíveis

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

Parâmetro Description
--debug Aumente a verbosidade do log para mostrar todos os logs de depuração.
--help -h Mostra a mensagem de ajuda.
--only-show-errors Só mostra erros, suprimindo avisos.
--output -o Formato de saída. Valores permitidos: json, jsonc, none, table, tsv, yaml, yamlc. Padrão: json.
--query Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
--subscription : Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
--verbose Aumente a verbosidade do registro. Utilize --debug para os registos de depuração completos.