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

Artigo
07/08/2024

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:

Instale a CLI do Azure se ainda não tiver feito isso.
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_ID`o .
`--verbose`	Aumente a verbosidade do registro. Utilize `--debug` para os registos de depuração completos.

Partilhar via