Introducción a la extensión de Azure Sphere para la CLI de Azure

La herramienta de línea de comandos para administrar dispositivos conectados y implementaciones en la nube de Azure Sphere se distribuye como una extensión de la CLI de Azure.

Instalación de la CLI de Azure y la extensión de Azure Sphere

Para adquirir la extensión de Azure Sphere para la CLI de Azure:

1. Instale la CLI de Azure si aún no lo ha hecho.

2. Para agregar la extensión de Azure Sphere, ejecute el siguiente comando:

   az extension add --name azure-sphere
   

Debe iniciar sesión con la CLI de Azure para iniciar sesión en la suscripción de Azure que desea usar para administrar dispositivos de Azure Sphere.

Una vez instalada una extensión, su ubicación se encuentra bajo el valor de la $AZURE_EXTENSION_DIR variable de shell. Si esta variable no está establecida, el valor predeterminado es $HOME/.azure/cliextensions en Linux y macOS y %USERPROFILE%\.azure\cliextensions en Windows.

Sugerencia

Después de iniciar sesión, verá una lista de suscripciones asociadas a su cuenta de Azure. Asegúrese de seleccionar la suscripción con los permisos necesarios mediante el az account set comando para que la extensión de Azure Sphere funcione correctamente. Para más información sobre la selección de suscripción, consulte Uso de varias suscripciones de Azure.

Administración de la extensión de Azure Sphere

Para ver las versiones instaladas de las extensiones de la CLI de Azure, use el comando :

az version

Para actualizar la extensión de Azure Sphere a la versión más reciente, use:

az extension update --name azure-sphere

Para desinstalar la extensión de Azure Sphere, use:

az extension remove --name azure-sphere

Comandos comunes de la CLI de Azure Sphere

Puede usar comandos de Azure Sphere escribiendo az sphere desde el símbolo del sistema de Windows o PowerShell. En Linux, puede usar cualquier interfaz de línea de comandos (CLI). La CLI dispone de la función de autocompletar con el tabulador para los comandos en el shell de bash.

En esta tabla se enumeran algunos comandos comunes de Azure Sphere y vínculos a su documentación de referencia.

Comando	Descripción
az sphere catalog	Administrar el catálogo.
az sphere ca-certificate	Administrar certificados en el catálogo.
az sphere deployment	Administrar implementaciones en el catálogo.
az sphere device	Administrar dispositivos de Azure Sphere.
az sphere device-group	Administrar grupos de dispositivos en el catálogo.
az sphere image	Administrar imágenes en el catálogo.
az sphere product	Administrar productos en el catálogo.
az sphere get-support-data	Recopile datos de diagnóstico sobre las configuraciones del sistema, la nube y el dispositivo.

La CLI de Azure permite configurar opciones de configuración que simplifican el uso de comandos de la CLI de Azure Sphere proporcionando los valores predeterminados para los parámetros como --resource-group, --subscriptiono --catalog.

Comandos dependientes del dispositivo

El comando funciona con un dispositivo de Azure Sphere conectado localmente. Si intenta el comando sin un dispositivo conectado, se producirá un error. Para obtener más información sobre los comandos de dispositivo, consulte az sphere device

• az sphere device claim
• az sphere device recover
• az sphere device restart
• az sphere device show-attached
• az sphere device show-os-version
• az sphere device app show-memory-status
• az sphere device app show-quota
• az sphere device app show-status
• az sphere device app start
• az sphere device app stop
• az sphere device capability show-attached
• az sphere device capability update
• az sphere device certificate add
• az sphere device certificate delete
• az sphere device certificate list
• az sphere device certificate show
• az sphere device certificate show-quota
• az sphere device image list-installed
• az sphere image-package show
• az sphere device manufacturing-state show
• az sphere device manufacturing-state update
• az sphere device network proxy apply
• az sphere device network proxy delete
• az sphere device network proxy show
• az sphere device network disable
• az sphere device network enable
• az sphere device network list-firewall-rules
• az sphere device network list-interfaces
• az sphere device network show-diagnostics
• az sphere device network show-status
• az sphere device network update-interface
• az sphere device sideload delete
• az sphere device sideload deploy
• az sphere device wifi add
• az sphere device wifi disable
• az sphere device wifi enable
• az sphere device wifi forget
• az sphere device wifi list
• az sphere device wifi reload-config
• az sphere device wifi scan
• az sphere device wifi show
• az sphere device wifi show-status

Argumentos disponibles globalmente

Los siguientes parámetros globales están disponibles para la extensión de Azure Sphere:

Parámetro	Descripción
--debug	Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
--help -h	Muestra el mensaje de ayuda.
--only-show-errors	Solo muestra errores, supresión de advertencias.
--output -o	Formato de salida. Valores permitidos: json, jsonc, none, tsvtable, , yaml, . yamlc Predeterminado: json.
--query	Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
--subscription	: nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
--verbose	Aumente el nivel de detalle de registro. Use --debug para los registros de depuración completos.