Migrar de la CLI clásica a la CLI de Azure Sphere

  • Artículo

Si todavía usa la CLI clásica de Azure Sphere, le recomendamos que migre a la nueva CLI de Azure Sphere. Actualmente, ambas versiones de la CLI se pueden instalar y usar en paralelo, pero la CLI clásica ya no se actualiza ni se mantiene y se quitará del SDK en una fecha futura (no antes de finales de 2022). Le recomendamos que se familiarice con estas diferencias y migre sus procesos y scripts antes de finales de 2022 para evitar interrupciones.

Para actualizar al SDK más reciente, consulte Instalar azure Sphere SDK en Linux o Instalar un SDK de Azure Sphere para Windows.

Para usar la CLI de Azure Sphere en Windows, use PowerShell o un símbolo del sistema estándar de Windows. Para Linux, use cualquier shell de comandos. Para obtener más información, consulte Ejecutar la CLI de Azure Sphere.

En Windows, el símbolo del sistema para desarrolladores personalizados de Azure Sphere Classic (disponible como acceso directo en el menú Inicio en Azure Sphere) solo se puede usar con la CLI clásica de Azure Sphere. Para obtener más información, consulte Ejecutar la CLI clásica de Azure Sphere.

Diferencias clave

  • En la CLI clásica de Azure Sphere, se pueden usar varios parámetros para identificar cada tipo de objeto. En la CLI de Azure Sphere, se usa un parámetro único para identificar cada tipo de objeto. Esto significa que puede usar el nombre o id. para especificar el valor del parámetro. Esto se ha implementado para los --deviceparámetros , --tenant, --producty --device-group .

    Tipo de objeto Azure Sphere CLI CLI clásica de Azure Sphere (retirada)
    Dispositivo --device --deviceid, --deviceipo bien --devicelocation
    Grupo de dispositivos --device-group --devicegroupid O --devicegroupname
    Producto --product --productid O --productname
    Inquilino --tenant --tenantid

  • La versión clásica admite un formulario breve para los comandos. En la CLI de Azure Sphere, le recomendamos que use la característica interactiva o finalización de tabulación para ver la lista de comandos disponibles. Por ejemplo, en la CLI clásica, puede usar cualquiera azsphere device enable-development de azsphere dev edv los comandos, mientras que en la nueva CLI de Azure Sphere puede usar autocompletar para escribir rápidamente el azsphere device enable-development comando.

  • Algunos comandos permiten varios valores para un único parámetro. En la CLI de Azure Sphere puede proporcionar un parámetro único seguido de una lista de valores separados por espacios y, en la CLI clásica de Azure Sphere, la lista de valores se separa con comas. Por ejemplo:

    azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2

  • En la nueva CLI, el inquilino predeterminado no se selecciona automáticamente cuando se crea un inquilino. Tiene que ejecutar el comando azsphere tenant select para seleccionar el inquilino predeterminado que se usará para el usuario actual en el equipo. Esto es para garantizar que el espacio empresarial predeterminado sea el correcto al realizar una operación de pago único que no se puede deshacer como reclamar el dispositivo.

    Al usar scripts, puede seleccionar el inquilino predeterminado con el --tenant <tenant ID or tenant name> parámetro.

    Establezca el inquilino predeterminado al principio del script con:

    azsphere tenant select --tenant <tenant ID or tenant name>

    También puede sobrescribir el inquilino predeterminado o especificar el inquilino necesario al ejecutar el comando. Por ejemplo:

    azsphere get-support-data --destination logs.zip --tenant <tenant ID or tenant name>

  • El --device-group parámetro identifica el grupo de dispositivos. El id. de grupo de dispositivos proporciona un GUID, que identifica de forma única el grupo de dispositivos en todos los productos. Como alternativa, puedes usar el nombre del producto y el par de nombres de grupo de dispositivos en el <formato product-name>/<device-group-name> . Este par de nombres identifica de forma única un grupo de dispositivos para un producto determinado.

  • Los siguientes comandos eran comandos compuestos en la CLI clásica. Esto significa que un comando ha realizado varias tareas. En la nueva CLI necesita ejecutar los dos comandos.

  • En la CLI clásica, el -o parámetro o --output se usa para especificar una ruta de acceso y un nombre de archivo en los que guardar un archivo. En la nueva CLI de Azure Sphere, se usan parámetros específicos del contexto como --destination especificar rutas de entrada y salida.

  • En la CLI clásica, el -d parámetro o --debug se utiliza en el comando azsphere device app start para iniciar la aplicación en modo de depuración. En la nueva CLI de Azure Sphere, el --debug-mode parámetro se usa para iniciar la aplicación en modo de depuración y el --debug parámetro se usa como parámetro global para aumentar el nivel de detalle de registro para mostrar todos los registros de depuración.

  • En la CLI clásica no hay ningún control sobre el formato de salida. En la CLI de Azure Sphere, el -o parámetro o --output se usa para especificar el formato de salida en el que se debe dar formato a la salida de la CLI.

  • Desde la versión 21.02 en adelante, los números de versión explícita se han quitado de los nombres de producto de la CLI de Azure Sphere. Este cambio elimina la confusión al hacer referencia a las diferentes versiones del producto.

    • Azure Sphere CLI v2 y versiones posteriores ahora se denominan solo "Azure Sphere CLI".
    • Las versiones anteriores de la CLI de Azure Sphere (CLI v1 e inferior) ahora se denominan "CLI clásica de Azure Sphere".

  • Si usa scripts, es posible que no sean compatibles con la nueva CLI de Azure Sphere debido a las diferencias explicadas anteriormente. Realice las actualizaciones necesarias para que los scripts se ejecuten correctamente en la nueva CLI.

Consulte también