Modo interativo da CLI do Azure Sphere (versão prévia)

Artigo
09/27/2024

Importante

Esta é a documentação do Azure Sphere (herdado). O Azure Sphere (herdado) 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 dá suporte ao modo interativo, que fornece um ambiente interativo para executar comandos da CLI do Azure Sphere, o que é ideal para novos usuários que aprendem os recursos, as estruturas de comando e os formatos de saída da CLI. Você pode iniciar o modo interativo usando o comando azsphere interactive em uma interface de linha de comando usando o PowerShell, o Prompt de Comando do Windows ou o shell Bash. O prompt de comando muda para azsphere>> indicar que agora você está executando comandos no shell interativo.

Modo interativo do Azure Sphere

Importante

Este recurso está em versão preliminar. Ele pode ser alterado ou removido em uma versão futura.

Configurar

Opcionalmente, o modo interativo exibe descrições de comando, descrições de parâmetro e exemplos de comando.

Opção	Descrição
F1	Ativa ou desativa descrições e exemplos.
F2	Ativa ou desativa a exibição de padrões de parâmetro.
F3	Alterna a exibição de alguns gestos de tecla.
[Ctrl+D]	Sai do modo interativo.

Modo interativo F1 do Azure Sphere

Escopo de conjunto

O modo interativo permite definir o escopo de comandos para um grupo específico de comandos. Se você quiser trabalhar apenas com device certificate comandos, poderá usar o seguinte para definir o escopo correto para que não precise digitar device certificate com todos os comandos subsequentes.

Por exemplo, quando você define o escopo como %%device certificate:

azsphere>> %%device certificate
defaulting: device
defaulting: certificate
azsphere device certificate>>

Para remover o escopo, $ %% .. insira e para remover todos os escopos, %%insira .

Exemplos

O modo interativo lista exemplos de alguns comandos contextualmente à medida que você digita os comandos. Se o comando tiver muitos exemplos para caber na janela do terminal, você poderá examinar todos os exemplos rolando pelo painel de exemplo com CTRL+Y e CTRL+N para 'para cima' e 'para baixo', respectivamente.

O modo interativo fornece várias maneiras de criar e executar o comando. O número de exemplo é indicado no painel de exemplo. Você pode selecionar um específico para exibir no painel de exemplo. Por exemplo:

Modo interativo do Azure Sphere: várias maneiras

Preenchimento automático

O modo interativo exibe o resultado do comando inserido. Ele fornece uma caixa de listagem suspensa de preenchimento automático, sugestões de cache automático e documentação dinâmica, incluindo exemplos de como cada comando é usado. A conclusão do valor do parâmetro é suportada para os --application-updateparâmetros , --debug-mode, --device, --none--tenant--manual-start--os-feed--full--product--force--role--state--enable-rt-core-debugging--device-group--targeted-scan--temporary--style--typee .--user

Modo interativo do Azure Sphere: preenchimento automático

Comandos usados com frequência

O modo interativo controla os comandos digitados anteriormente e os comandos usados com mais frequência. O comando é exibido quando os caracteres iniciais são digitados na interface do prompt de comando.

Código de saída

A $ opção permite que você veja o código de saída do último comando executado para verificar se ele foi executado corretamente. Por exemplo:

azsphere>> $
Success: 0

Comandos fora do modo interativo

O modo interativo da CLI do Azure Sphere permite que um usuário execute comandos fora da CLI do Azure Sphere sem sair do modo interativo usando #[command] a interface de linha de comando. Por exemplo:

azsphere>> #git --version
git version 2.28.0.windows.1

Consultar Comando Anterior

Você pode executar uma consulta JMESPath nos resultados do último comando que você executou usando ?? seguido por uma consulta JMESPath. Por exemplo, depois de listar todos os produtos, você pode executar a consulta para listar apenas os nomes dos produtos.

azsphere>> azsphere product list
 ------------------------------------ ------------------------------------ --------------- --------------------
 Id                                   TenantId                             Name            Description
 ==============================================================================================================
 a2cd64be-adc2-4bfd-8f34-7d8c90293893 143adbc9-1bf0-4be2-84a2-084a331d81cb MyFridgeProduct None
 ------------------------------------ ------------------------------------ --------------- --------------------
 e5fe65f7-0df5-481e-9f4c-44b1a00d2d60 143adbc9-1bf0-4be2-84a2-084a331d81cb CoffeeMaker     None
 ------------------------------------ ------------------------------------ --------------- --------------------

A saída para a consulta jmespath será:

azsphere>> ??"[].{Productname:name}"
[
  {
    "Productname": "MyFridgeProduct"
  },
  {
    "Productname": "CoffeeMaker"
  }
]

Compartilhar via