Compartir a través de

Introducción a la CLI de Azure Sphere

  • Artículo

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:

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:

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.