Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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, --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 claimaz sphere device recoveraz sphere device restartaz sphere device show-attachedaz sphere device show-os-versionaz sphere device app show-memory-statusaz sphere device app show-quotaaz sphere device app show-statusaz sphere device app startaz sphere device app stopaz sphere device capability show-attachedaz sphere device capability updateaz sphere device certificate addaz sphere device certificate deleteaz sphere device certificate listaz sphere device certificate showaz sphere device certificate show-quotaaz sphere device image list-installedaz sphere image-package showaz sphere device manufacturing-state showaz sphere device manufacturing-state updateaz sphere device network proxy applyaz sphere device network proxy deleteaz sphere device network proxy showaz sphere device network disableaz sphere device network enableaz sphere device network list-firewall-rulesaz sphere device network list-interfacesaz sphere device network show-diagnosticsaz sphere device network show-statusaz sphere device network update-interfaceaz sphere device sideload deleteaz sphere device sideload deployaz sphere device wifi addaz sphere device wifi disableaz sphere device wifi enableaz sphere device wifi forgetaz sphere device wifi listaz sphere device wifi reload-configaz sphere device wifi scanaz sphere device wifi showaz 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. |