Modo interactivo de la CLI de Azure Sphere (versión preliminar)
Importante
Esta es la documentación de Azure Sphere (heredado). Azure Sphere (heredado) se retira el 27 de septiembre de 2027 y los usuarios deben migrar a Azure Sphere (integrado) en este momento. Use el selector de versiones situado encima de la TOC para ver la documentación de Azure Sphere (integrado).
La CLI de Azure Sphere admite el modo interactivo que proporciona un entorno interactivo para ejecutar comandos de la CLI de Azure Sphere, que es ideal para los nuevos usuarios que aprenden las funcionalidades, las estructuras de comandos y los formatos de salida de la CLI. Puede iniciar el modo interactivo mediante el comando azsphere interactive en una interfaz de línea de comandos mediante PowerShell, el símbolo del sistema de Windows o el shell de Bash. El símbolo del sistema cambia a azsphere>> para indicar que ahora está ejecutando comandos en el shell interactivo.
Importante
Esta característica está en versión preliminar. Esto se puede cambiar o eliminar en una versión futura.
Configurar
El modo interactivo muestra de manera opcional descripciones de comandos, descripciones de parámetros y ejemplos de comandos.
| Opción | Descripción |
|---|---|
| F1 | Activa o desactiva las descripciones y los ejemplos. |
| F2 | Activa o desactiva la presentación de los valores predeterminados del parámetro. |
| F3 | Alterna la visualización de algunos gestos clave. |
| [Ctrl+D] | Sale del modo interactivo. |
Ámbito de conjunto
El modo interactivo permite definir el ámbito de los comandos a un grupo específico de comandos. Si solo desea trabajar con device certificate comandos, puede usar lo siguiente para establecer el ámbito correcto para que no tenga que escribir device certificate con todos los comandos posteriores.
Por ejemplo, al establecer el ámbito como %%device certificate:
azsphere>> %%device certificate
defaulting: device
defaulting: certificate
azsphere device certificate>>
Para quitar la entrada de ámbito y $ %% .. para quitar todo el ámbito, escriba . %%
Ejemplos
El modo interactivo muestra ejemplos de algunos comandos contextualmente a medida que escribe los comandos. Si el comando tiene demasiados ejemplos que caben en la ventana del terminal, puede examinar todos los ejemplos si se desplaza por el panel de ejemplo con CTRL+Y y CTRL+N para "arriba" y "abajo", respectivamente.
El modo interactivo proporciona varias maneras de crear y ejecutar el comando. El número de ejemplo se indica en el panel de ejemplo. Puede seleccionar uno específico para verlo en el panel de ejemplo. Por ejemplo:
Autocompletar
El modo interactivo muestra el resultado del comando especificado. Proporciona un cuadro de lista desplegable de autocompletar, sugerencias almacenadas en caché automática y documentación dinámica, incluidos ejemplos de cómo se usa cada comando. Se admite la finalización del valor de parámetro para los --application-updateparámetros , --debug-mode, --manual-start--tenant--none--full--os-feed--force--product--enable-rt-core-debugging--role--state--device-group--device--targeted-scan--temporary--style--typey .--user
Comandos usados con frecuencia
El modo interactivo realiza un seguimiento de los comandos previamente tipados y los comandos usados con más frecuencia. El comando se muestra cuando los caracteres iniciales se escriben en la interfaz del símbolo del sistema.
Código de salida
La $ opción permite ver el código de salida del último comando ejecutado para comprobar que se ejecutó correctamente. Por ejemplo:
azsphere>> $
Success: 0
Comandos fuera del modo interactivo
El modo interactivo de la CLI de Azure Sphere permite a un usuario ejecutar comandos fuera de la CLI de Azure Sphere sin salir del modo interactivo mediante #[command] en la interfaz de la línea de comandos. Por ejemplo:
azsphere>> #git --version
git version 2.28.0.windows.1
Consulta del comando anterior
Puede ejecutar una consulta JMESPath en los resultados del último comando que ejecutó con ?? seguido de una consulta JMESPath. Por ejemplo, después de enumerar todos los productos, puede ejecutar la consulta para enumerar solo los nombres de producto.
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
------------------------------------ ------------------------------------ --------------- --------------------
La salida de la consulta jmespath será:
azsphere>> ??"[].{Productname:name}"
[
{
"Productname": "MyFridgeProduct"
},
{
"Productname": "CoffeeMaker"
}
]