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:
Instale la CLI de Azure si aún no lo ha hecho.
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
, --subscription
o --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 , tsv table , , 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. |