Visão geral da CLI do Azure Sphere

  • Artigo

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

Os seguintes comandos estão disponíveis:

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

A CLI do Azure Sphere está 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 funcionando como sempre funcionou.

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 o padrão durante a instalação do SDK ou o comando azsphere_v2 se você definir a CLI clássica do Azure Sphere como o padrão.

Consulte a CLI do Azure Sphere para obter detalhes sobre os recursos e comandos compatíveis com a CLI do Azure Sphere.

Importante

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

Formato de linha de comando

A linha de comando do azsphere tem o seguinte formato:

azsphere [command] [subcommand] operation [parameters]

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

A maioria dos parâmetros tem um nome longo e uma abreviação. Na linha de comando, introduza o nome longo com dois hifens e a abreviação com um único hifen. 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 os caracteres de escape

Quando você trabalha com comandos da CLI do Azure Sphere, esteja ciente de como seu shell usa aspas e escapa de caracteres. Se você dá suporte a scripts usados em shells diferentes, você precisa entender como eles diferem.

Por exemplo:

Comandos dependentes de nuvem

Os seguintes comandos do azsphere exigem uma conexão de nuvem e logon para o Serviço de Segurança do Azure Sphere:

  • ca-certificate
  • grupo de dispositivos
  • get-support-data
  • Imagem
  • Login
  • Logout
  • Produto
  • register-user
  • Papel
  • show-user
  • Inquilino

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

comando do dispositivo azsphere Comentários
Capacidade Requer o download do Serviço de Segurança do Azure Sphere para download da funcionalidade do dispositivo
Reivindicar
enable-cloud-test
enable-development
Imagem
Lista
Recuperar Requer conectividade com a Internet, mas não logon no Serviço de Segurança do Azure Sphere
programa
show-count
show-deployment-status
show-os-version Requer conectividade com a Internet, mas não logon no Serviço de Segurança do Azure Sphere
Atualização

Comandos dependentes da funcionalidade do dispositivo

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

Operação Descrição
App Gerenciar aplicativos no dispositivo anexado.
Capacidade Gerenciar configurações de funcionalidade do dispositivo. Necessário para a atualização de funcionalidade.
Certificado Gerenciar o repositório de certificados do dispositivo.
Imagem Gerenciar imagens do dispositivo.
manufacturing-state Gerenciar o estado de fabricação de dispositivos anexados. Necessário para a atualização de estado de fabricação.
Reiniciar Reinicie o dispositivo anexado.
show-deployment-status Mostrar o status de implantação do sistema operacional e dos aplicativos no dispositivo anexado.
show-os-version Mostrar a versão do sistema operacional no dispositivo anexado.
sideload Implantar e gerenciar aplicativos no dispositivo anexado. Necessário para implantação de sideload e exclusão de sideload.
Wifi Gerencie Wi-Fi configurações para o dispositivo anexado.

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