Modo interativo da CLI do Azure

O que é o modo interativo da CLI do Azure?

O Modo Interativo da CLI do Azure (az interativo) fornece aos usuários um ambiente interativo para executar comandos da CLI do Azure. O modo interativo torna mais fácil para você aprender os recursos, a sintaxe de comando e os formatos de saída da CLI do Azure. Ele fornece menus suspensos de preenchimento automático, sugestões armazenadas automaticamente em cache combinadas com a documentação de tempo de execução e inclui exemplos de como cada comando é usado. O Modo Interativo da CLI do Azure visa fornecer uma experiência ideal para os usuários aprenderem a usar comandos da CLI do Azure.

Pré-requisitos

Use um ambiente Bash ou PowerShell no Azure Cloud Shell ou execute a CLI do Azure localmente no PowerShell 7.

.

Executar o modo interativo da CLI do Azure

Use a CLI do Azure no modo interativo executando o seguinte comando:

az interactive

O modo interativo da CLI do Azure coloca você em um shell interativo com preenchimento automático, descrições de comando e exemplos.

Configurar suas opções no modo interativo

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

Ativar ou desativar descrições e exemplos usando F1 .

Você pode ativar ou desativar a exibição de padrões de parâmetro usando F2 .

Você pode alternar a exibição de alguns gestos principais usando F3 .

Escopo

No modo interativo, você pode editar o escopo para um grupo de comandos específico para ter todos os comandos interpretados nesse escopo. Esse método fornece uma maneira eficiente de inserir seus comandos, demonstrado nos exemplos a seguir usando o grupo vmde comandos.

Em vez de digitar estes comandos:

az>> vm create -n <myVirtualMachine> -g <myResourceGroup> --image Ubuntu2204
az>> vm list -o table

Você pode definir o escopo para o grupo de comandos da VM e digitar estes comandos:

az>> %%vm
az vm>> create -n <myVirtualMachine> -g <myResourceGroup> --image Ubuntu2204
az vm>>list -o table

É possível editar o escopo para grupos de comandos de nível inferior, como vm image, usando %%vm image. Nesse caso, como já estamos no escopo vm, deveríamos usar %%image.

az vm>> %%image
az vm image>>

Nesse ponto, podemos editar o escopo para retornar a vm usando %%.., ou podemos editar o escopo para a raiz apenas com %%.

az vm image>> %%
az>>

Consulta no modo interativo

Você pode executar uma consulta JMESPath nos resultados do último comando que você executou usando ?? seguida de uma consulta JMESPath. Por exemplo, depois de criar um grupo, você pode recuperar o grupo id novo.

az>> group create -n <myResourceGroup> -l westEurope
az>> "?? id"

Você também pode usar essa sintaxe para usar o resultado do comando anterior como um argumento para o próximo comando.* Por exemplo, depois de ter listado todos os grupos, você pode consultar resultados mais específicos usando a lista que acabou de gerar.

az>> vm create --name <myVirtualMachine> --resource-group <myResourceGroup> --image Ubuntu2204 --no-wait -o json
az>> group list -o json

# List all the resources of type `virtualMachine`on the first group whose location is westeurope. 
az>> resource list -g "?? [?location=='westeurope'].name | [0]" --query "[?type=='Microsoft.Compute/virtualMachines'].name

Para saber mais sobre como consultar os resultados de seus comandos, consulte os resultados do comando Query com a CLI do Azure.

Executar comandos do Bash e do PowerShell no modo interativo

Você pode executar os comandos Bash e PowerShell sem sair do modo interativo.

Para scripts de Bash, use a sintaxe #[cmd]:

az>> #dir

Para scripts do PowerShell, use a sintaxe padrão do PowerShell:

az>> $PSVersionTable

Exibir exemplos de seus comandos no modo interativo

Você pode rolar até a próxima página de exemplos usando CTRL + N e a página anterior usando CTRL + Y .

Você também pode examinar um exemplo específico usando ::#.

az>> webapp create ::2

Funcionalidades de IA (inteligência artificial)

A equipe da CLI do Azure combinou a IA com o modo interativo da CLI do Azure para fornecer aos usuários uma experiência interativa mais amigável para iniciantes. Essas funcionalidades de IA permitem que os usuários aprendam sobre como utilizar o modo interativo da CLI do Azure com mais facilidade e eficiência.

Os novos recursos de IA consistem em:

• Conclusão inteligente: o sistema de recomendação alimentado por IA usa a análise de telemetria para prever e analisar o comportamento do cliente. Esses resultados levam à priorização das opções de conteúdo mais usadas e necessárias.
• Recomendação de comando: a IA oferece comandos subsequentes com base nos comandos mais usados em outras sessões semelhantes.
• Identificação do cenário: a IA identifica os cenários possíveis atuais e recomenda um conjunto de combinações de comandos relacionadas para seu cenário de ponta a ponta específico.
• Pesquisa de conhecimento utilizável: a IA permite que você insira linguagem natural para procurar comandos para cenários de uso específicos.

Como usar funcionalidades de IA com o modo interativo da CLI do Azure

Ao usar o modo interativo na CLI do Azure, atualize para a versão mais recente para usar os novos recursos.

az extension add --name interactive --upgrade

Para usar a recomendação de comando, execute um comando e clique no espaço ou em seguida.

Para usar a recomendação de cenário, execute um comando primeiro. Depois que o comando for executado com êxito, insira um espaço. Vários conjuntos de comandos são listados e você verá que qualquer conjunto de comandos selecionado, um ::[num] será adicionado após o espaço inserido.

Observação

Para identificação de cenário, se você inserir ::[num] sem espaço antes dele, ele retornará um erro. Insira um único espaço para poder exibir a lista de conjuntos de comandos.

Para usar a pesquisa de conhecimento utilizável, execute / [keyword] para pesquisar comandos e cenários.

Para desabilitar os novos recursos de IA para o modo interativo da CLI do Azure, insira o seguinte comando:

az config set interactive.enable_recommender=False