Aprenda a usar el modo interactivo de la CLI de Azure

El modo interactivo de la CLI de Azure (az interactive) proporciona a los usuarios un entorno interactivo para ejecutar comandos de la CLI de Azure. El modo interactivo facilita el aprendizaje de las funcionalidades, la sintaxis de comandos y los formatos de salida de la CLI de Azure. Proporciona listas desplegables de autocompletar, sugerencias automáticas almacenadas en caché combinadas con documentación generada en tiempo de ejecución e incluye ejemplos sobre cómo se usa cada comando. El modo interactivo de la CLI de Azure tiene como objetivo proporcionar una experiencia ideal para los usuarios que aprenden a usar comandos de la CLI de Azure.

Prerrequisitos

Use un entorno de Bash o PowerShell en Azure Cloud Shell o ejecute la CLI de Azure localmente en PowerShell 7.

.

Ejecución del modo interactivo de la CLI de Azure

Use la CLI de Azure en modo interactivo mediante la ejecución del comando siguiente:

az interactive

El modo interactivo de la CLI de Azure lo sitúa en un shell interactivo con función de autocompletar, descripciones de comandos y ejemplos.

Configuración de las opciones en modo interactivo

El modo interactivo muestra opcionalmente descripciones de comandos, descripciones de parámetros y ejemplos de comandos.

Active o desactive las descripciones y los ejemplos mediante F1.

Puede activar o desactivar la presentación de los valores predeterminados de los parámetros mediante F2.

Puede alternar la visualización de algunos gestos de tecla mediante F3.

Ámbito

En modo interactivo, puede editar el ámbito en un grupo de comandos específico para que todos los comandos se interpreten en ese ámbito. Este método proporciona una manera eficaz de introducir los comandos, como se muestra en los ejemplos siguientes mediante el grupo vmde comandos .

En lugar de escribir estos comandos:

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

Puede definir el ámbito del grupo de comandos de máquina virtual y escribir estos comandos:

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

También puede editar el ámbito de los grupos de comandos de nivel inferior, como vm image usando %%vm image. En este caso, dado que ya ha delimitado a vm, utilice %%image.

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

En ese momento, puede editar el ámbito de nuevo a vm mediante %%.., o puede editar el ámbito hasta la raíz con solo %%.

az vm image>> %%
az>>

Consulta en modo interactivo

Puede ejecutar una consulta JMESPath en los resultados del último comando que ejecutó con ?? seguido de una consulta JMESPath. Por ejemplo, después de crear un grupo, puede recuperar el id del nuevo grupo.

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

También puede usar esta sintaxis para usar el resultado del comando anterior como argumento para el siguiente comando.* Por ejemplo, después de enumerar todos los grupos, puede consultar los resultados más específicos mediante la lista que generó.

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

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

Para más información sobre cómo consultar los resultados de los comandos, consulte Consulta de los resultados del comando con la CLI de Azure.

Ejecución de comandos de Bash y PowerShell en modo interactivo

Puede ejecutar comandos de Bash y PowerShell sin salir del modo interactivo.

Para los scripts de Bash, use la #[cmd] sintaxis :

az>> #dir

Para los scripts de PowerShell, use la sintaxis normal de PowerShell:

az>> $PSVersionTable

Ver ejemplos de los comandos en modo interactivo

Puede desplazarse a la página siguiente de ejemplos mediante CTRL+N y la página anterior mediante CTRL+Y.

También puede ver un ejemplo específico mediante ::#.

az>> webapp create ::2

Funcionalidades de inteligencia artificial (IA)

El equipo de la CLI de Azure combinó la inteligencia artificial con el modo interactivo de la CLI de Azure para proporcionar a los usuarios una experiencia interactiva más fácil de usar. Estas funcionalidades de IA permiten a los usuarios aprender a usar el modo interactivo de la CLI de Azure con mayor facilidad y eficacia.

Las nuevas características de IA incluyen:

• Finalización inteligente: el sistema de recomendaciones con tecnología de inteligencia artificial usa el análisis de telemetría para predecir y analizar el comportamiento del cliente. Estos resultados conducen a la priorización de las opciones de contenido más usadas y necesarias.
• Recomendación de comandos: la inteligencia artificial proporciona comandos posteriores basados en los comandos usados con más frecuencia en otras sesiones similares.
• Identificación de escenarios: la inteligencia artificial identifica los posibles escenarios actuales y recomienda un conjunto de combinaciones de comandos relacionadas para su escenario específico de un extremo a otro.
• Búsqueda de conocimientos utilizables: la inteligencia artificial permite escribir lenguaje natural para buscar comandos para escenarios de uso específicos.

Uso de funcionalidades de IA con el modo interactivo de la CLI de Azure

Al usar el modo interactivo en la CLI de Azure, actualice a la versión más reciente para usar las nuevas características.

az extension add --name interactive --upgrade

Para usar recomendaciones de comandos, ejecute un comando y presione la barra espaciadora o seleccione siguiente.

Para usar recomendaciones de escenario, ejecute primero un comando. Después de que el comando se ejecute correctamente, presione la barra espaciadora. Se muestran varios conjuntos de comandos, y verá que al seleccionar un conjunto de comandos, se añadirá ::[num] después del espacio que haya ingresado.

Nota:

Para la identificación del escenario, si escribe ::[num] sin espacio antes, devuelve un error. Asegúrese de ingresar un solo espacio para ver la lista de conjuntos de comandos.

Para usar la búsqueda de conocimientos utilizables, ejecute / [keyword] para buscar comandos y escenarios.

Para desactivar las nuevas características de IA para el modo interactivo de la CLI de Azure, escriba el siguiente comando:

az config set interactive.enable_recommender=False