Introducción a la CLI de Azure Sphere
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 es un conjunto de comandos que se usan para administrar los recursos de Azure Sphere.
Los siguientes comandos están disponibles:
- ca-certificate
- device
- device-group
- feedback
- get-support-data
- definición de hardware
- image
- image-package
- interactivo (el comando está en versión preliminar)
- login
- logout
- product
- role
- show-user
- show-version
- setting
- tenant
Nota:
El comando register-user ahora está en desuso.
CLI de Azure Sphere y CLI clásica de Azure Sphere
La CLI de Azure Sphere se instala junto con la CLI existente en Windows y Linux, por lo que tiene acceso a cualquiera de las interfaces. La CLI clásica de Azure Sphere sigue funcionando como siempre.
Para usar la CLI de Azure Sphere:
- En Windows, use PowerShell o un símbolo del sistema estándar de Windows.
- En Linux, use cualquier shell de comandos. Especifique el comando azsphere si establece la CLI de Azure Sphere como valor predeterminado durante la instalación del SDK o el comando azsphere_v2 si establece la CLI clásica de Azure Sphere como valor predeterminado.
Consulte LA CLI de Azure Sphere para más información sobre las características y comandos compatibles con la CLI de Azure Sphere.
Importante
- En Windows, el acceso directo del símbolo del sistema para desarrolladores clásicos de Azure Sphere solo se puede usar con la CLI clásica de Azure Sphere.
Formato de línea de comandos
La línea de comandos azsphere tiene el siguiente formato:
azsphere [command] [subcommand] operation [parameters]
En general, comando y subcomando son sustantivos y operación es un verbo, de modo que la combinación identifica a una acción y al objeto de la acción. La mayoría de los comandos y operaciones tienen un nombre completo y una abreviatura. Por ejemplo, el comando device se abrevia d.
La mayoría de los parámetros tienen un nombre completo y una abreviatura. En la línea de comandos, introduzca el nombre completo con dos guiones y la abreviatura con un solo guión. Por ejemplo, los dos comandos siguientes son equivalentes:
azsphere device wifi add --ssid MyNetwork --psk mynetworkkey
azsphere device wifi add -s MyNetwork -p mynetworkkey
Algunos comandos permiten varios valores para un único parámetro. En la CLI de Azure Sphere, puede proporcionar un único parámetro seguido de una lista de valores separados por espacios y en la CLI clásica de Azure Sphere, la lista de valores está separada por comas. Por ejemplo:
azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2
Comillas y caracteres de escape
Al trabajar con comandos de la CLI de Azure Sphere, tenga en cuenta cómo el shell usa comillas y caracteres de escape. Si admite scripts usados en distintos shells, debe comprender cómo difieren.
Por ejemplo:
- Bash: Comillas
- PowerShell: Acerca de las reglas de comillas
- Símbolo del sistema de Windows: Procedimientos: Escape de caracteres, delimitadores y comillas en la línea de comandos de Windows
Comandos dependientes de la nube
Los siguientes comandos azsphere requieren una conexión a la nube e inicio de sesión en el servicio de seguridad de Azure Sphere:
- ca-certificate
- device-group
- get-support-data
- imagen
- login
- logout
- producto
- rol
- show-user
- tenant
Además, los siguientes comandos azsphere device requieren también una conexión a la nube:
| Comando azsphere device | Comentarios |
|---|---|
| capability | Requiere el servicio de seguridad de Azure Sphere para la descarga de las funcionalidades del dispositivo. |
| claim | |
| enable-cloud-test | |
| enable-development | |
| image | |
| list | |
| recover | Requiere conectividad a Internet, pero no inicio de sesión en el servicio de seguridad de Azure Sphere. |
| show | |
| show-count | |
| show-deployment-status | |
| show-os-version | Requiere conectividad a Internet, pero no inicio de sesión en el servicio de seguridad de Azure Sphere. |
| update |
Comandos dependientes de la funcionalidad del dispositivo
Los siguientes comandos azsphere device requieren que se use una funcionalidad de dispositivo para dispositivos en estado de fabricación DeviceComplete:
| Operación | Descripción |
|---|---|
| app | Administra aplicaciones en el dispositivo conectado. |
| capability | Administra configuraciones de la funcionalidad del dispositivo. Necesario para la actualización de la funcionalidad. |
| certificado | Administra el almacén de certificados del dispositivo. |
| imagen | Administra imágenes de dispositivo. |
| estado de fabricación | Administra el estado de fabricación de los dispositivos conectados. Necesario para la actualización de estado de fabricación. |
| restart | Reinicia el dispositivo conectado. |
| show-deployment-status | Muestra el estado de implementación del sistema operativo y las aplicaciones en el dispositivo conectado. |
| show-os-version | Muestra la versión del sistema operativo en el dispositivo conectado. |
| instalación de prueba | Implementa y administra aplicaciones en el dispositivo conectado. Necesario para la implementación de prueba y la eliminación de transferencia local. |
| wifi | Administra configuraciones de Wi-Fi para el dispositivo conectado. |
Si intenta ejecutar estos comandos sin una funcionalidad, recibirá un mensaje de error que le indica que ejecute azsphere device enable-development o use azsphere device capability para descargar y seleccionar un archivo de funcionalidad para el dispositivo.