Descrição geral da CLI do Azure Sphere

  • Artigo

A CLI do Azure Sphere é um conjunto de comandos utilizados para gerir os seus recursos do Azure Sphere.

Estão disponíveis os seguintes comandos:

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

A CLI do Azure Sphere está instalada juntamente com a CLI existente no Windows e no Linux, pelo que tem acesso a qualquer uma das interfaces. A CLI clássica do Azure Sphere continua a funcionar como sempre.

Para utilizar a CLI do Azure Sphere:

  • No Windows, utilize o PowerShell ou uma Linha de Comandos padrão do Windows.
  • No Linux, utilize qualquer shell de comandos. Especifique o comando azsphere se definir a CLI do Azure Sphere como a predefinição durante a instalação do SDK ou o comando azsphere_v2 se definir a CLI clássica do Azure Sphere como a predefinição.

Veja CLI do Azure Sphere para obter detalhes sobre as funcionalidades e comandos suportados pela CLI do Azure Sphere.

Importante

  • No Windows, o atalho da Linha de Comandos do Programador Clássico do Azure Sphere descontinuado só pode ser utilizado com a CLI clássica do Azure Sphere.

Formato da linha de comandos

A linha de comandos azsphere tem o seguinte formato:

azsphere [command] [subcommand] operation [parameters]

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

A maioria dos parâmetros tem um nome longo e uma abreviatura. Na linha de comandos, introduza o nome longo com dois hífenes e a abreviatura com um único hífen. Por exemplo, os dois comandos seguintes 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, pode fornecer um único parâmetro seguido de 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 carateres de escape

Quando trabalhar com comandos da CLI do Azure Sphere, tenha em atenção como a shell utiliza aspas e os carateres de escape. Se suportar scripts utilizados em shells diferentes, tem de compreender como diferem.

Por exemplo:

Comandos dependentes da cloud

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

  • ca-certificate
  • device-group
  • get-support-data
  • imagem
  • início de sessão
  • fim de sessão
  • produto
  • register-user
  • função
  • show-user
  • inquilino

Além disso, os seguintes comandos do dispositivo azsphere também requerem uma ligação à cloud:

comando do dispositivo azsphere Comentários
capacidade Requer o Serviço de Segurança do Azure Sphere para a transferência da capacidade do dispositivo
afirmação
enable-cloud-test
enable-development
imagem
lista
recuperar Requer conectividade à Internet, mas não inicia sessão no Serviço de Segurança do Azure Sphere
mostrar
show-count
show-deployment-status
show-os-version Requer conectividade à Internet, mas não inicia sessão no Serviço de Segurança do Azure Sphere
atualizar

Comandos dependentes da capacidade do dispositivo

Os seguintes comandos de dispositivos do azsphere requerem a utilização de uma capacidade de dispositivo para dispositivos no estado de fabrico DeviceComplete:

Operação Descrição
aplicação Gerir aplicações no dispositivo anexado.
capacidade Gerir configurações de capacidade de dispositivos. Necessário para a atualização de capacidade.
certificado Gerir o arquivo de certificados do dispositivo.
imagem Gerir imagens do dispositivo.
estado de fabrico Gerir o estado de fabrico dos dispositivos ligados. Necessário para a atualização do estado de fabrico.
reiniciar Reinicie o dispositivo ligado.
show-deployment-status Mostrar o estado de implementação do sistema operativo e das aplicações no dispositivo anexado.
show-os-version Mostrar a versão do sistema operativo no dispositivo anexado.
sideload Implementar e gerir aplicações no dispositivo anexado. Necessário para implementação de sideload e eliminação de sideload.
wi-fi Faça a gestão Wi-Fi configurações do dispositivo anexado.

Se tentar executar estes comandos sem capacidade, receberá uma mensagem de erro a indicar-lhe para executar azsphere device enable-development ou utilizar azsphere device capability para transferir e selecionar um ficheiro de capacidade para o dispositivo.