Compartir a través de

Migración de la CLI clásica 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).

Si sigue usando la CLI clásica de Azure Sphere, se recomienda migrar a la nueva CLI de Azure Sphere. Actualmente, ambas versiones de la CLI se pueden instalar y utilizar en paralelo, pero la CLI clásica ya no se actualiza ni se mantiene y se eliminará de SDK en una fecha futura (no antes de finales de 2022). Le recomendamos que se familiarice con estas diferencias y migre los procesos y scripts antes de finales de 2022 para evitar interrupciones.

Para actualizar al SDK más reciente, consulte Instalación del SDK de Azure Sphere en Linux o Instalación de 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, utilice cualquier shell de comandos. Para obtener más información, consulte Ejecutar Azure Sphere CLI.

En Windows el símbolo del sistema para desarrolladores de Azure Sphere Classic personalizado que se retira (disponible como acceso directo en el menú Inicio en Azure Sphere) sólo 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.

Principales diferencias

  • 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 único parámetro para identificar cada tipo de objeto. Esto significa que puede usar el nombre o el identificador para especificar el valor del parámetro. Esto se ha implementado para los --deviceparámetros , --tenant, --producty --device-group .

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

  • El formato corto para los comandos se admite en la versión clásica. En la CLI de Azure Sphere, se recomienda usar la característica de finalización de pestañas o interactiva para ver la lista de comandos disponibles. Por ejemplo, en la CLI clásica, puede usar o azsphere device enable-development azsphere dev edv comando, 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 ú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

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

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

    Establezca el inquilino predeterminado al principio del script mediante:

    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 identificador del grupo de dispositivos proporciona un GUID que identifica de forma única el grupo de dispositivos en todos los productos. Como alternativa, puede usar el nombre del producto y el par nombre del grupo de dispositivos en el <formato product-name>/<device-group-name> . Este par de nombres identifica de manera ú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 realizó varias tareas. En la nueva CLI, debe ejecutar los dos comandos.

    • En la CLI clásica, el comando azsphere device-group deployment create cargó el paquete de imagen y creó una nueva implementación.

      En la nueva CLI, debe:

      1. Cargue el paquete de imágenes en el inquilino de Azure Sphere mediante azsphere image add.
      2. Cree una nueva implementación para un grupo de dispositivos para las imágenes cargadas mediante azsphere device-group deployment create.

    • En la CLI clásica, la funcionalidad azsphere device download --select command downloaded and temporarily selected device capability configuration for the attached device configuration (Descargar el comando azsphere device downloaded y temporalmente seleccionado para el dispositivo conectado).

      En la nueva CLI, debe:

      1. Descargue el archivo de funcionalidad mediante azsphere device capability download.
      2. Seleccione la funcionalidad mediante azsphere device capability select(azsphere device capability).

    • En la CLI clásica, la funcionalidad azsphere device download --apply command downloaded and applied the device capability configuration for the attached device configuration for the attached device.

      En la nueva CLI, debe:

      1. Descargue el archivo de funcionalidad mediante azsphere device capability download.
      2. Aplique la funcionalidad mediante azsphere device capability update.

  • 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 el que guardar un archivo. En la nueva CLI de Azure Sphere, se usan parámetros específicos del contexto, como --destination para especificar rutas de acceso de entrada y salida.

  • En la CLI clásica, el parámetro o --debug se usa en el comando azsphere device app start para iniciar la aplicación en modo de depuración.-d 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 del 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 va a dar formato a la salida de la CLI.

  • A partir de la versión 21.02, los números de versión explícitos se han quitado de los nombres de producto de la CLI de Azure Sphere. Este cambio elimina la confusión en la referencia a las distintas versiones del producto.

    • La CLI de Azure Sphere v2 y versiones posteriores solo se conocen como "CLI de Azure Sphere".
    • Las versiones anteriores de la CLI de Azure Sphere (CLI v1 y versiones anteriores) ahora se conocen como "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 que se han explicado anteriormente. Realice las actualizaciones necesarias para que los scripts se ejecuten correctamente en la nueva CLI.

Consulte también