Partilhar via

Visão geral da CLI do Azure Sphere

  • Artigo

Importante

Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (Integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).

A CLI do Azure Sphere é um conjunto de comandos usados para gerenciar seus recursos do Azure Sphere.

Os seguintes comandos estão disponíveis:

Nota

O comando register-user foi preterido.

CLI do Azure Sphere e CLI clássica do Azure Sphere

A CLI do Azure Sphere é instalada junto com a CLI existente no Windows e no Linux, para que você tenha acesso a qualquer interface. A CLI clássica do Azure Sphere continua a funcionar como sempre.

Para usar a CLI do Azure Sphere:

  • No Windows, use o PowerShell ou um prompt de comando padrão do Windows.
  • No Linux, use qualquer shell de comando. Especifique o comando azsphere se você definir a CLI do Azure Sphere como padrão durante a instalação do SDK ou o comando azsphere_v2 se definir a CLI clássica do Azure Sphere como padrão.

Consulte CLI do Azure Sphere para obter detalhes sobre os recursos e comandos suportados pela CLI do Azure Sphere.

Importante

  • No Windows, o atalho desativado do Prompt de Comando do Desenvolvedor Clássico do Azure Sphere só pode ser usado com a CLI clássica do Azure Sphere.

Formato de linha de comando

A linha de comando azsphere tem o seguinte formato:

azsphere [command] [subcommand] operation [parameters]

Em geral, comando e subcomando são substantivos e operação é um verbo, de modo que a combinação identifica tanto uma ação quanto o objeto da ação. A maioria dos comandos e operações tem um nome completo e uma abreviatura. Por exemplo, o comando device é abreviado d.

A maioria dos parâmetros tem um nome longo e uma abreviatura. Na linha de comando, introduza o nome longo com dois hífenes e a abreviatura com um único hífen. Por exemplo, os dois comandos a seguir são equivalentes:

azsphere device wifi add --ssid MyNetwork --psk mynetworkkey

azsphere device wifi add -s MyNetwork -p mynetworkkey

Alguns comandos permitem vários valores para um único parâmetro. Na CLI do Azure Sphere, você pode fornecer um único parâmetro seguido por uma lista de valores separados por espaços e, na CLI clássica do Azure Sphere, a lista de valores é separada por vírgulas. Por exemplo:

azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2

Aspas e caracteres de escape

Ao trabalhar com comandos da CLI do Azure Sphere, esteja ciente de como seu shell usa aspas e caracteres de escape. Se você oferece suporte a scripts usados em shells diferentes, precisa entender como eles diferem.

Por exemplo:

Comandos dependentes da nuvem

Os seguintes comandos azsphere requerem uma ligação à nuvem e início de sessão no Serviço de Segurança do Azure Sphere:

  • Certificado CA
  • grupo-dispositivo
  • get-support-data
  • image
  • início de sessão
  • logout
  • produto
  • função
  • show-user
  • tenant

Além disso, os seguintes comandos do dispositivo azsphere também exigem uma conexão com a nuvem:

comando azsphere device Comentários
capacidade Requer o Serviço de Segurança do Azure Sphere para download de recursos do dispositivo
reivindicação
enable-cloud-test
capacitar-desenvolvimento
imagem
list
recuperar Requer conectividade com a Internet, mas não faz logon no Serviço de Segurança do Azure Sphere
programa
contagem-espetáculo
show-deployment-status
show-os-versão Requer conectividade com a Internet, mas não faz logon no Serviço de Segurança do Azure Sphere
atualizar

Comandos dependentes da capacidade do dispositivo

Os seguintes comandos de dispositivo azsphere exigem que um recurso de dispositivo seja usado para dispositivos no estado de fabricação DeviceComplete:

Operation Description
Aplicação Gerencie aplicativos no dispositivo conectado.
capacidade Gerencie as configurações de capacidade do dispositivo. Necessário para a atualização de capacidade.
certificado Gerencie o armazenamento de certificados do dispositivo.
image Gerencie imagens de dispositivos.
Estado-Fabricação Gerencie o estado de fabricação de dispositivos conectados. Necessário para atualização do estado de fabricação.
restart Reinicie o dispositivo conectado.
show-deployment-status Mostrar o status de implantação do sistema operacional e dos aplicativos no dispositivo conectado.
show-os-versão Mostrar a versão do sistema operacional no dispositivo conectado.
carga lateral Implante e gerencie aplicativos no dispositivo conectado. Necessário para implantação de sideload e exclusão de sideload.
Wi-Fi Gerencie as configurações de Wi-Fi para o dispositivo conectado.

Se você tentar executar esses comandos sem um recurso, você receberá uma mensagem de erro informando para executar azsphere device enable-development ou usar azsphere device capability para baixar e selecionar um arquivo de capacidade para o dispositivo.