device

Artículo
09/27/2024

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).

Administra los dispositivos de Azure Sphere.

Operación	Descripción
app	Cambia el estado de las aplicaciones de un dispositivo.
capability	Administra las funcionalidades del dispositivo.
certificado	Administra el almacén de certificados de dispositivo.
claim	Reclama un dispositivo previamente no reclamado al inquilino de Azure Sphere.
enable-cloud-test	Configura un dispositivo para deshabilitar la depuración y recibir actualizaciones.
enable-development	Configura un dispositivo para la depuración local.
image	Administra imágenes para un dispositivo.
list	Muestra todos los dispositivos del inquilino.
list-attached	Enumera los dispositivos conectados.
estado de fabricación	Administra el estado de fábrica del dispositivo conectado.
network	Proporciona información sobre el estado de las interfaces de red en el dispositivo.
recover	Usa el modo de recuperación especial para cargar el nuevo firmware en el dispositivo.
volver a examinar la conexión	Vuelve a examinar los dispositivos conectados como ayuda de solución de problemas (solo Windows).
restart	Reinicia el dispositivo conectado.
show	Muestra detalles sobre la configuración de actualización del dispositivo.
show-attached	Muestra detalles sobre el dispositivo conectado desde el propio dispositivo.
show-count	Muestra el número total de dispositivos de un inquilino.
show-deployment-status	Muestra el estado de la actualización de implementación más reciente.
show-os-version	Muestra la versión del sistema operativo del dispositivo local.
instalación de prueba	Carga una imagen en el dispositivo conectado.
update	Actualiza un dispositivo colocándolo en un grupo de dispositivos específico.
wifi	Administra la configuración de Wi-Fi para el dispositivo.

app

Administra las aplicaciones en el dispositivo.

Muchas de las opciones de la aplicación requieren la funcionalidad appDevelopment, que se puede adquirir mediante azsphere device enable-development. Para iniciar, detener o depurar una aplicación firmada por un SDK o una aplicación firmada por producción, el dispositivo debe tener la funcionalidad appDevelopment.

Puede usar azsphere device app stop y azsphere device app start para reiniciar una aplicación con respuesta en tiempo real en ejecución para determinar en qué núcleo en tiempo real se ejecuta.

Operación	Descripción
show-memory-stats	Muestra las estadísticas de memoria de las aplicaciones en el dispositivo conectado.
show-quota	Muestra la cantidad de almacenamiento utilizada por la aplicación actual en el dispositivo.
show-status	Devuelve el estado de la aplicación actual en el dispositivo.
start	Inicia la aplicación que está cargada en el dispositivo.
stop	Detiene la aplicación que está ejecutándose en el dispositivo.

app show-memory-stats

Muestra las estadísticas de memoria de las aplicaciones en el dispositivo conectado. Este comando solo está disponible si la funcionalidad del dispositivo appDevelopment está configurada. Se muestra información adicional si se configura el seguimiento de asignación de memoria del montón.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device app show-memory-stats
 -------------- -------------
 Name           Usage (bytes)
 ============================
 Total          434176
 User Mode      147456
 Peak User Mode 147456
 -------------- -------------

app show-quota

Muestra la cantidad de almacenamiento mutable asignado y en uso en el dispositivo conectado.

La cuota de almacenamiento mutable se establece en el manifiesto de aplicación y el sistema operativo Azure Sphere aplica cuotas cuando asigna sectores para el archivo. Como resultado, si disminuye el valor de MutableStorage, la cantidad de almacenamiento en uso no cambiará, pero el valor asignado notificado será diferente. Por ejemplo, si la aplicación ya ha usado 16 KB y cambia el MutableStorage valor a 8 KB, el comando informa de que la aplicación usa 16 KB de 8 KB asignados. Los datos permanecen en el dispositivo.

Parámetros opcionales

Parámetro	Tipo	Descripción
-i, --component-id	GUID	Especifica el identificador del componente para el que se va a obtener información de cuota. Si se omite, muestra información de cuota para todos los componentes.
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device app show-quota
ae4714aa-03aa-492b-9663-962f966a9cc3: 0KB out of 8KB of mutable storage used.

app show-status

Muestra el estado actual de las aplicaciones en el dispositivo.

Parámetros opcionales

Parámetro	Tipo	Descripción
-i, --component-id	GUID	Especifica el identificador del componente para el que se va a mostrar el estado. Si se omite, se muestra el estado de todos los componentes.
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device app show-status
9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
App state: running

app start

Inicia las aplicaciones en el dispositivo.

Parámetros opcionales

Parámetro	Tipo	Descripción
--debug-mode	Booleano	Inicia la aplicación para su depuración. `--component-id` Debe proporcionarse .
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
-i, --component-id	GUID	Especifica el id. del componente que se iniciará. Si se omite, se inician todas las aplicaciones.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device app start
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: running
Core     : High-level

app stop

Detiene las aplicaciones en el dispositivo.

Parámetros opcionales

Parámetro	Tipo	Descripción
-i, --component-id	GUID	Especifica el id. del componente que se detendrá. Si se omite, se detienen todas las aplicaciones.
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device app stop
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: stopped

capability

Administra las funcionalidades del dispositivo. Las funcionalidades del dispositivo determinan las operaciones que se pueden realizar en un dispositivo de Azure Sphere individual.

Las funcionalidades del dispositivo se descargan como un archivo del servicio de seguridad de Azure Sphere mediante el comando azsphere device capability download. Puede aplicar la configuración de funcionalidad del dispositivo al dispositivo de Azure Sphere conectado mediante el comando azsphere device capability update y puede crear una sesión de mantenimiento mediante el comando azsphere device capability select. Para obtener más información sobre las funcionalidades del dispositivo, consulte Funcionalidades y comunicación del dispositivo.

Operación	Descripción
download	Descarga una configuración de funcionalidad del dispositivo desde el servicio de seguridad de Azure Sphere.
select	Selecciona un archivo de funcionalidad descargado que se usará para una sesión de mantenimiento.
show-attached	Muestra la configuración de funcionalidades del dispositivo conectado.
update	Aplica una configuración de funcionalidad del dispositivo al dispositivo conectado.

capability download

Descarga una funcionalidad del dispositivo desde el servicio de seguridad de Azure Sphere.

La funcionalidad appDevelopment le permite transferir localmente aplicaciones firmadas por el SDK, así como iniciar, detener, depurar o eliminar cualquier aplicación en el dispositivo. Sin la funcionalidad appDevelopment, solo se pueden cargar las aplicaciones cargadas en la nube; está prohibido iniciarlas, detenerlas, depurarlas y eliminarlas. La funcionalidad appDevelopment se aplica como parte del comando azsphere device enable-development.

La descarga de la funcionalidad fieldServicing da como resultado un archivo que contiene la funcionalidad para un único dispositivo de Azure Sphere. El archivo de funcionalidad de fieldServicing se descarga en el equipo local y se puede usar junto con el comando azsphere device capability select.

Parámetros obligatorios

Parámetro	Tipo	Descripción
--type	Tipo de funcionalidad	Especifica el tipo de capacidad del dispositivo que se va a descargar. Los valores son appDevelopment, fieldServicing o none. Use none para quitar las funcionalidades appDevelopment o fieldServicing.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando. Este parámetro es necesario cuando se conectan varios dispositivos o cuando no hay ningún dispositivo conectado. El dispositivo conectado actualmente se usa de forma predeterminada. Puede proporcionar un identificador de dispositivo para un dispositivo no conectado, o bien puede especificar la dirección IP o el identificador de conexión local de un dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
--destino	Cadena	Especifica la ruta de acceso y nombre de archivo en el que se va a guardar la configuración de la funcionalidad. Incluye una ruta de acceso absoluta o relativa. Si no proporciona una ruta de acceso, el comando almacena el archivo en el directorio local mediante la funcionalidad de convención <de nomenclatura escriba<> los ocho primeros caracteres de id.cap> del dispositivo.
-t, --tenant	GUID o nombre	Especifica el inquilino en el que se va a realizar esta operación. Invalida el inquilino seleccionado predeterminado. Puede especificar el identificador de inquilino o el nombre del inquilino.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device capability download --type appDevelopment
The appdevelopment capability was saved as:
 --------------------------------------------
 Result
 ============================================
 C:\capability-file\appdevelopment-<first eight characters of device ID>.cap
 --------------------------------------------

capability select

Selecciona un archivo de funcionalidad para usarlo con el dispositivo de Azure Sphere conectado.

El comando azsphere device capability select se puede usar con cualquier funcionalidad, pero se usa con más frecuencia con la funcionalidad fieldServicing para habilitar una sesión de servicio. Cualquier rol de usuario tiene acceso al comando azsphere device capability select.

Cuando se usa la funcionalidad fieldServicing, se habilita la comunicación entre el dispositivo de Azure Sphere y el equipo local que contiene el archivo de la funcionalidad. El archivo de la funcionalidad fieldServicing se usa para una sesión entre el equipo local y el dispositivo de Azure Sphere; en cada comando de la sesión se antepone un mensaje que indica el archivo de funcionalidad en uso.

Para finalizar una sesión de servicio, use azsphere device capability select --none.

Parámetros opcionales

Parámetro	Tipo	Descripción
--capability-file	Cadena	Especifica la ruta de acceso y el nombre de archivo al archivo de configuración de funcionalidad del dispositivo que se va a seleccionar. Puede proporcionar una ruta de acceso relativa o absoluta.
-n, --none	-	Borra todas las configuraciones de las funcionalidades del dispositivo seleccionadas anteriormente.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device capability select --capability-file appdevcap
The capability session uses C:\capability-file\appdevcap.

capability show-attached

Muestra la configuración de funcionalidad almacenada en el dispositivo conectado.

Nota:

El comando muestra las funcionalidades configuradas mediante un archivo de funcionalidad y algunas funcionalidades, pero no todas, presentes de forma predeterminada en los paneles.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device capability show-attached
 --------------------
 DeviceCapabilities
 ====================
 EnableFieldServicing
 --------------------

azsphere device capability show-attached
 --------------------
 DeviceCapabilities
 ====================
 EnableAppDevelopment
 --------------------

capability update

Aplica una configuración de funcionalidad del dispositivo al dispositivo conectado.

Parámetros obligatorios

Parámetro	Tipo	Descripción
--capability-file	Cadena	Especifica la ruta de acceso y el nombre de archivo del archivo de funcionalidad del dispositivo que se va a aplicar. Puede proporcionar una ruta de acceso relativa o absoluta.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando. Este parámetro es necesario cuando se conectan varios dispositivos o cuando no hay ningún dispositivo conectado. El dispositivo conectado actualmente se usa de forma predeterminada. Puede proporcionar un identificador de dispositivo para un dispositivo no conectado, o bien puede especificar la dirección IP o el identificador de conexión local de un dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device capability update --capability-file appdevcap.bin
Using selected capability file: C:\capability-file\appdevcap.bin
The capability file C:\capability-file\appdevcap.bin was added on the device. The device will restart.

certificado

Administra los certificados del dispositivo conectado.

Operación	Descripción
agregar	Agrega un certificado al almacén de certificados en el dispositivo conectado.
eliminación	Elimina un certificado del almacén de certificados del dispositivo conectado.
list	Enumera los identificadores de certificado que están disponibles en el almacén de certificados del dispositivo conectado.
show	Muestra los detalles de un certificado en el almacén de certificados del dispositivo conectado.
show-quota	Muestra el espacio disponible disponible en el almacén de certificados del dispositivo conectado.

certificate add

Agrega un certificado al almacén de certificados del dispositivo conectado.

Los certificados de CA raíz y de cliente deben tener el formato .pem para cargarse en el dispositivo Azure Sphere. Debe adquirir el certificado de entidad de certificación raíz del servidor adecuado, junto con el certificado de cliente y la clave privada (y, opcionalmente, una contraseña para la clave privada) para el dispositivo. Cada certificado lo debe generar y firmar el servidor adecuado de la red EAP-TLS. El administrador de red o el equipo de seguridad pueden proporcionarle los detalles necesarios para obtener los certificados. Para obtener más información sobre cómo adquirir el certificado de entidad de certificación raíz, consulte Adquisición e implementación de certificados para redes EAP-TLS.

Precaución

Dado que los identificadores de certificado tienen como ámbito todo el sistema, tanto para los certificados de cliente como para los de CA raíz, un comando azsphere o una llamada de función que agrega un certificado nuevo pueden sobrescribir un certificado agregado por un comando o una llamada de función anteriores, lo que podría producir errores de conexión de red. Se recomienda que desarrolle unos procedimientos de actualización de certificados claros y elija cuidadosamente los identificadores de certificado.

Para más información, consulte el apartado sobre identificadores de certificado.

Parámetros obligatorios

Parámetro	Tipo	Descripción
-i, --cert-id	Cadena	Especifica el identificador del certificado que se va a agregar. Identificador de cadena (hasta 16 caracteres). Los caracteres válidos incluyen letras mayúsculas (A-Z), letras minúsculas (a-z), números (0-9), subrayado (_), punto (.) y guion (-). Este identificador también se usa en configuraciones de Wi-Fi para redes EAP-TLS.
--cert-type	Cadena	Especifica el tipo de certificado que se va a agregar, ya sea cliente o rootca.
-p, --public-key-file	Cadena	Especifica la ruta de acceso a un archivo .pem de certificado de clave pública. Puede proporcionar una ruta de acceso relativa o absoluta.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
--private-key-file	Cadena	Especifica la ruta de acceso a un archivo .pem de certificado de clave privada de cliente. Necesario al agregar un certificado de tipo cliente. Puede proporcionar una ruta de acceso relativa o absoluta.
-w, --private-key-password	Cadena	Especifica una contraseña opcional para la clave privada del cliente. La contraseña es necesaria cuando se agrega una clave privada de certificado de cliente que está cifrada.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device certificate add --cert-id certroot --cert-type rootca --public-key-file publiccert.pem
Certificate 'certroot' successfully added.

azsphere device certificate add --cert-id certclient --cert-type client --private-key-file privatekey.pem --private-key-password 1234 --public-key-file publiccert.pem
Certificate 'certclient' successfully added.

certificate delete

Elimina un certificado del almacén de certificados del dispositivo conectado.

Parámetros obligatorios

Parámetro	Tipo	Descripción
-c, --certificate o bien --cert-id [Retirada]	Cadena	Especifica el identificador del certificado que se va a eliminar. El `--cert-id` argumento se retirará y se quitará en una versión futura. Para más información, consulte Cambios importantes (retirada de características) en la CLI de Azure Sphere.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device certificate delete --certificate certclient

certificate list

Enumera los certificados disponibles en el almacén de certificados del dispositivo.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device certificate list
 -----------
 Identifiers
 ===========
 rootCert
 -----------

certificate show

Muestra los detalles de un certificado individual en el almacén de certificados del dispositivo.

Parámetros obligatorios

Parámetro	Tipo	Descripción
-c, --certificate o bien --cert-id [Retirada]	Cadena	Especifica el identificador del certificado para el que se muestran los detalles. El `--cert-id` argumento se retirará y se quitará en una versión futura. Para más información, consulte Cambios importantes (retirada de características) en la CLI de Azure Sphere.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device certificate show --certificate certclient
---------- ------------------- ------------------- ----------------------------------- -----------------------------------
 Id         StartDate           EndDate             SubjectName                         IssuerName
 ==========================================================================================================================
 certclient 06/08/2019 19:15:48 06/08/2069 19:25:44 /DC=local/DC=azsphere/CN=azsphereca /DC=local/DC=azsphere/CN=azsphereca
 ---------- ------------------- ------------------- ----------------------------------- -----------------------------------

certificate show-quota

Muestra el espacio disponible disponible en el almacén de certificados del dispositivo conectado.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device certificate show-quota
--------------
Available space (bytes)
==============
24514
--------------

claim

Reclama un dispositivo que anteriormente no estaba reclamado para el inquilino de Azure Sphere actual.

Importante

Antes de reclamar el dispositivo, asegúrese de que ha iniciado sesión en el inquilino de Azure Sphere correcto. Un dispositivo solo se puede reclamar una vez. Una vez reclamado, un dispositivo no se puede mover a otro inquilino.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando. Este parámetro es necesario cuando se conectan varios dispositivos o cuando no hay ningún dispositivo conectado. El dispositivo conectado actualmente se usa de forma predeterminada. Puede proporcionar un identificador de dispositivo para un dispositivo no conectado, o bien puede especificar la dirección IP o el identificador de conexión local de un dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
-t, --tenant	GUID o nombre	Especifica el inquilino en el que se va a realizar esta operación. Invalida el inquilino seleccionado predeterminado. Puede especificar el identificador de inquilino o el nombre del inquilino.
--force	Booleano	Obliga a reclamar un dispositivo en el inquilino de Azure Sphere seleccionado por el usuario actual.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device claim
warn: You are claiming a device to the following tenant:
warn: a323c263-2aa3-2559-aabb-a3fc32631900 (Tenant1)
warn: Do you want to claim the device ID 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968 to this tenant?
warn: You cannot change the Azure Sphere tenant this device is claimed to once this action has completed.
Enter 'yes' to continue. Enter anything else to exit.
> yes
Claiming device.
Successfully claimed device ID '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968' into tenant 'Tenant1' with ID 'a323c263-2aa3-2559-aabb-a3fc32631900'.

enable-cloud-test

Prepara el dispositivo conectado para la prueba de la carga en la nube; para ello, deshabilita el desarrollo de aplicaciones, elimina las aplicaciones existentes y habilita las actualizaciones de aplicaciones cargadas en la nube.

Requiere que un dispositivo se conecte al equipo y solo funciona en dicho dispositivo conectado.

En concreto, enable-cloud-test:

Quita la funcionalidad appDevelopment del dispositivo conectado.
Asigna el dispositivo a un grupo de dispositivos que habilita las actualizaciones de aplicaciones cargadas en la nube.
Reinicia el dispositivo.

Las tareas concretas que realiza enable-cloud-test dependen de si ya se ha asignado un producto o un grupo de dispositivos a este dispositivo.

Si azsphere device enable-cloud-test se ejecuta sin parámetros, el dispositivo se coloca en el grupo de dispositivos De prueba de campo del producto actual del dispositivo. Este es uno de los grupos de dispositivos predeterminados que se crean automáticamente para cada producto, lo que permite actualizaciones de aplicaciones. Se devuelve un error si el dispositivo no tiene un producto o un grupo de dispositivos de prueba de campo no existe dentro de él.

Si se especifica un producto, el dispositivo se coloca en el grupo de dispositivos De prueba de campo de ese producto. Se devuelve un error si este grupo de dispositivos no existe.

Si se especifica un grupo de dispositivos, el dispositivo se coloca en él. Se devuelve un error si el grupo de dispositivos de destino no habilita las actualizaciones de aplicaciones.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
-p, --product	GUID o nombre	Especifica el producto de destino. Cuando se especifica esto, el dispositivo se mueve al grupo de dispositivos de prueba de campo predeterminado de este producto, a menos que `--device-group` también se especifique. Puede especificar el identificador o el nombre del producto de Azure Sphere.
-t, --tenant	GUID o nombre	Especifica el inquilino en el que se va a realizar esta operación. Invalida el inquilino seleccionado predeterminado. Puede especificar el identificador de inquilino o el nombre del inquilino.
-g, --device-group	GUID o nombre	Especifica el grupo de dispositivos al que se moverá el dispositivo. Puede especificar el identificador del grupo de dispositivos o el nombre del grupo de dispositivos. Para usar el nombre del grupo de dispositivos, debe proporcionar el nombre del producto y el nombre del grupo de dispositivos en el `<product-name/device-group-name>` formato . De forma predeterminada, este es el grupo de dispositivos De prueba de campo del producto.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplos

Ejemplo 1. Asignación de un dispositivo a un grupo de dispositivos existente por su identificador

En este ejemplo se asigna el dispositivo conectado a un producto o a un grupo de dispositivos ya existentes.

azsphere device enable-cloud-test --device-group '3548b179-m16f-4f64-6dme-d3c643662e76'
Your internal capabilities will be retained, including the Enable App development capability. Sideloaded images may be removed by over-the-air application updates.
Getting device group by ID '3548b179-m16f-4f64-6dme-d3c643662e76'.
Leaving any existing applications on the device.
Setting device group to 'Field Test' with ID '3548b179-m16f-4f64-6dme-d3c643662e76')
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: 'ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD')

Ejemplo 2. Asignar el dispositivo a un grupo de dispositivos distinto

Este ejemplo es similar al ejemplo anterior, pero conserva el producto existente del dispositivo. Aquí, la operación enable-cloud-test cambia el grupo de dispositivos al que pertenece el dispositivo y quita la funcionalidad appDevelopment. Este comando es útil para mover un dispositivo de un entorno de desarrollo en el que no se permiten actualizaciones de aplicaciones a un entorno de producción que sí las permite.

azsphere device enable-cloud-test --device-group "Marketing/Field Test"

Ejemplo 3. Asignación de dispositivos por nombre de producto

En este ejemplo se permite la carga en la nube y se asigna el dispositivo a un producto por el nombre.

azsphere device enable-cloud-test --product DW100

enable-development

Habilita un dispositivo para el desarrollo habilitando la instalación de prueba y la depuración en el dispositivo y asignandolo a un grupo de dispositivos que deshabilita las actualizaciones de aplicaciones de la nube. De forma predeterminada, este es el grupo de dispositivos de desarrollo del producto del dispositivo, pero se pueden especificar otros grupos de dispositivos. No use en escenarios de fabricación. Consulte Fabricación de dispositivos conectados para obtener más información.

En concreto, enable-development:

Descarga y aplica la funcionalidad appDevelopment para el dispositivo conectado.
Asigna el dispositivo a un grupo de dispositivos que no habilita las actualizaciones de aplicaciones cargadas en la nube.
Reinicia el dispositivo.

Si ejecuta el comando azsphere device enable-development sin parámetros:

Si el dispositivo no tiene ningún producto o grupo de dispositivos, el comando descarga la funcionalidad appDevelopment, la aplica al dispositivo conectado y reinicia el dispositivo. Las aplicaciones existentes permanecen en el dispositivo y se actualiza el sistema operativo. El proceso de instalación para reclamar el dispositivo y el inicio rápido para compilar una aplicación de alto nivel no se ve afectado.
Si el dispositivo ya tiene un producto, el comando mueve el dispositivo al grupo de dispositivos Development (Desarrollo) del producto. De forma predeterminada, las actualizaciones de aplicaciones están deshabilitadas para este grupo, lo que garantiza que las aplicaciones transferidas localmente no se sobrescriben.

Si ejecuta el comando azsphere device enable-development con el --product parámetro :

Coloca el dispositivo en el grupo de dispositivos desarrollo del producto. Se devuelve un error si este grupo de dispositivos no existe.

Si ejecuta el comando azsphere device enable-development con el --device-group parámetro :

Coloca el dispositivo en el grupo de dispositivos especificado. El grupo de dispositivos de destino no debe habilitar las actualizaciones de la aplicación o se devuelve un error.

En algunos casos, azsphere device enable-development informa de un error y sugiere que se reclame el dispositivo. Si ya ha reclamado el dispositivo, use azsphere tenant show-selected para asegurarse de que ha iniciado sesión en el inquilino en el que ha reclamado el dispositivo. Si no es así, use azsphere login para iniciar sesión en el inquilino correcto. Cuando esté seguro de que ha iniciado sesión en el inquilino adecuado, use azsphere device claim para reclamar el dispositivo.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
-g, --device-group	GUID o nombre	Especifica el grupo de dispositivos al que se moverá el dispositivo. Si se omite, asigna el dispositivo a un grupo predeterminado. Puede especificar el identificador del grupo de dispositivos o el nombre del grupo de dispositivos. Para usar el nombre del grupo de dispositivos, debe proporcionar el nombre del producto y el nombre del grupo de dispositivos en el `<product-name/device-group-name>` formato .
-r, --enable-rt-core-debugging	Booleano	Instala los controladores necesarios para depurar aplicaciones que se ejecutan en un núcleo en tiempo real. Esta opción requiere permisos de administrador.
-p, --product	GUID o nombre	Especifica el producto de destino. Al especificar este valor, el dispositivo se mueve al grupo de dispositivos de desarrollo predeterminado de este producto, a menos `--device-group` que también se especifique. Puede especificar el identificador o el nombre del producto de Azure Sphere.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device enable-development
Capability configuration has been successfully cleared.
PS C:\Users\v-shypr> azsphere device enable-development
Getting device group 'Development' for product 'DW100'.
The device already has the 'Enable App development' capability. No changes will be applied to its existing capabilities.
Setting device group to 'Development' with ID '7f860cc1-4949-4000-a541-9a988ba4c3cd'.
Successfully disabled application updates.
Installing debugging server to device.
Deploying 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' to the attached device.
Image package 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' has been deployed to the attached device.
Previous device capabilities retained. Ensure that you have the correct development capabilities installed before continuing.
Successfully set up device for application development, and disabled application updates.
(Device ID: '352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968')

imagen

Devuelve información sobre las imágenes que se instalan en el dispositivo conectado o que están destinadas al mismo.

Operación	Descripción
list-installed	Proporciona detalles sobre las imágenes que están instaladas actualmente en el dispositivo conectado.
list-targeted	Proporciona detalles sobre las imágenes que están destinadas al dispositivo conectado.

image list-installed

Enumera las imágenes que están instaladas en el dispositivo conectado. La lista de información incluye los identificadores de componente e imagen.

Nota:

Los nombres de imágenes largas se truncan en 31 caracteres.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
-f, --full	Booleano	Enumera todas las imágenes de software instaladas en el dispositivo. De forma predeterminada, se enumeran solo las imágenes de aplicación, los depuradores y las imágenes de configuración de la placa.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device image list-installed
Installed images:
 --> gdbserver
   --> Image type:   Application
   --> Component ID: 8548b129-b16f-4f84-8dbe-d2c847862e78
   --> Image ID:     dc6205bd-4478-4c9b-81ad-5e41ac23ed68
 --> CrashApplicatio
   --> Image type:   Application
   --> Component ID: 9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
   --> Image ID:     cc77124e-6447-4c0f-9f99-fc0ad5ef46ef

image list-targeted

Enumera las imágenes que se han cargado en el servicio de seguridad de Azure Sphere y se instalarán cuando se actualice el dispositivo. Para más información sobre cómo asegurarse de que el dispositivo de Azure Sphere está listo para aceptar actualizaciones de aplicaciones basadas en la nube, consulte Habilitación de la implementación basada en la nube para el dispositivo.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando. Este parámetro es necesario cuando se conectan varios dispositivos o cuando no hay ningún dispositivo conectado. El dispositivo conectado actualmente se usa de forma predeterminada. Puede proporcionar un identificador de dispositivo para un dispositivo no conectado, o bien puede especificar la dirección IP o el identificador de conexión local de un dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
-t, --tenant	GUID o nombre	Especifica el inquilino en el que se va a realizar esta operación. Invalida el inquilino seleccionado predeterminado. Puede especificar el identificador de inquilino o el nombre del inquilino.
-f, --full	Booleano	Enumera todas las imágenes del inquilino de Azure Sphere.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device image list-targeted
 ----------------------- ------------------------------------ ------------------------------------ ---------------- --------------------
 Name                    ComponentId                          ImageId                              ImageType       RegionalDataBoundary 
 =======================================================================================================================================
 HelloWorld_HighLevelApp 1689d8b2-c835-2e27-27ad-e894d6d15fa9 50419cb6-a33b-4cbe-8bd0-425048664b6f Applications    None   
 ----------------------- ------------------------------------ ------------------------------------ -------------------------------------

list

Enumera todos los dispositivos de un inquilino. La lista se trunca después de los primeros 500 dispositivos.

Parámetros opcionales

Parámetro	Tipo	Descripción
-t, --tenant	GUID o nombre	Especifica el inquilino en el que se va a realizar esta operación. Invalida el inquilino seleccionado predeterminado. Puede especificar el identificador de inquilino o el nombre del inquilino.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device list
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                                                         TenantId                             ChipSku  ProductId                            DeviceGroupId
 ========================================================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 4f48d618-09f7-45dc-a5a4-1433cabbee91 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------

Puede usar el --query parámetro para personalizar la salida mostrada para este comando. Para más información, consulte Salida del comando de la CLI de consulta.

En el ejemplo siguiente se muestra cómo seleccionar solo el identificador de dispositivo y el identificador de producto:

azsphere device list --query '[].{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 4f48d618-09f7-45dc-a5a4-1433cabbee91
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABDFAC6466B573A0FF9ABA38BABCD40ABCD 4f48d618-09f7-45dc-a5a4-1433cabbee91
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

Sugerencia

Ejecute azsphere product show --product-ID>< para ver el nombre del producto o azsphere device-group show --device-group <devicegroup-ID> para ver el nombre del grupo de dispositivos.

list-attached

Enumera los dispositivos conectados al equipo local.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device list-attached
1 device attached:
--> Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
  --> Is responsive: yes
  --> IP address: 192.128.48.1
  --> Connection path: 21143

estado de fabricación

Administra el estado de fábrica del dispositivo conectado.

Operación	Descripción
show	Administra el estado de fábrica del dispositivo conectado.
update	Actualiza el estado de fabricación del dispositivo conectado.

Precaución

Los cambios de estado de fabricación son permanentes e irreversibles.

manufacturing-state show

Administra el estado de fábrica del dispositivo conectado.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device manufacturing-state show
------------------
ManufacturingState
==================
Module1Complete
------------------

manufacturing-state update

Actualiza el estado de fabricación del dispositivo conectado. Para obtener más información, consulte Establecimiento del estado de fabricación del dispositivo.

Precaución

Los cambios de estado de fabricación son permanentes e irreversibles.

Parámetros obligatorios

Parámetro	Tipo	Descripción
-s, --state	Estados de fabricación	Especifica el estado de fabricación que se establecerá para el dispositivo. Los estados posibles incluyen `DeviceComplete` y `Module1Complete`.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device manufacturing-state update --state Module1Complete
Updating manufacturing state to Module1Complete.
Restarting device for changes to take effect.
The device was successfully restarted.

red

Proporciona información sobre el estado de las interfaces de red en el dispositivo conectado.

Operación	Descripción
enable	Habilita una interfaz de red en el dispositivo conectado.
disable	Deshabilita una interfaz de red en el dispositivo conectado.
list-firewall-rules	Enumera las reglas de firewall para el dispositivo conectado.
list-interfaces	Enumera las interfaces de red para el dispositivo conectado.
proxy	Administra la configuración del proxy de red.
show-diagnostics	Muestra diagnósticos de red para una o todas las redes inalámbricas en el dispositivo conectado.
show-status	Muestra el estado de red del dispositivo conectado.
update-interface	Actualiza una configuración de interfaz de red para el dispositivo.

habilitación de red

Habilita una interfaz de red en el dispositivo conectado.

Nota:

Este comando es compatible con la configuración de Ethernet eth0 y wlan0 conexiones. Se devuelve un error si configura lo o azspheresvc.

Parámetros obligatorios

Parámetro	Tipo	Descripción
--interfaz	string	Especifica la interfaz que se va a habilitar.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device network enable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.

deshabilitación de red

Deshabilita una interfaz de red en el dispositivo conectado.

Nota:

Este comando es compatible con la configuración de Ethernet eth0 y wlan0 conexiones. Se devuelve un error si configura lo o azspheresvc.

Parámetros obligatorios

Parámetro	Tipo	Descripción
--interfaz	string	Especifica la interfaz que se va a habilitar.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device network disable --interface wlan0
Network interface configuration is successfully applied to the device.
Run the command 'azsphere device network list-interfaces' to view details of the network interfaces for the attached device.

network list-firewall-rules

Enumera las reglas de firewall para el dispositivo conectado.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Se muestran las reglas siguientes:

Nombre del conjunto de reglas de firewall: muestra el nombre del bloque del conjunto de reglas de firewall.
- Los valores son PREROUTING, POSTROUTING, INPUT, FORWARD y OUTPUT.
Is Ruleset Valid: muestra el estado del conjunto de reglas. Los valores son True o False.
Reglas del conjunto de reglas de firewall: muestra los valores de las reglas siguientes:
- IP de origen: muestra la dirección IP de la máquina de envío.
- Máscara de origen: muestra la máscara de red de la máquina de envío.
- IP de destino: muestra la dirección IP de la máquina de destino.
- Máscara de destino: muestra la máscara de red de la máquina de destomación.
- UID: muestra la identificación del usuario aplicada a la regla. 4294967295 (0xFFFFFFFF) significa que no se ha aplicado ningún UID y, por tanto, se aplica a todos los usuarios.
- Acción: muestra la acción que se va a realizar. Los valores se pueden aceptar o quitar.
- Nombre de la interfaz IN: muestra el nombre de la interfaz de entrada. Por ejemplo, wlan0.
- Nombre out de la interfaz: muestra el nombre de la interfaz de salida. Por ejemplo, wlan0.
- Estado: muestra el estado de conexión. Los valores no son ninguno, establecido o relacionado.
- Máscara TCP: muestra la matriz de máscaras TCP. Los valores son fin, syn, rst, psh, ack y urg.
- TCP Cmp: muestra la matriz de marcas TCP. Los valores son urg, ack, psh, rst, syb y fin.
- TCP Inv: booleano indica que el sentido de las marcas TCP debe invertirse. Los valores son True o False.
- Protocolo: muestra el protocolo de la regla de firewall. Los valores son icmp, igmp, tcp, udp.
- Intervalo de puertos de origen: muestra el intervalo de puertos desde el origen que envía el tráfico. El valor puede estar comprendido entre 0 y 65535.
- Intervalo de puertos de destino: muestra el intervalo de puertos en el destino que recibe el tráfico. El valor puede estar comprendido entre 0 y 65535.
- Paquetes: muestra el número de paquetes.
- Bytes: muestra el número de bytes.

A continuación se muestra un breve resumen de las marcas:

URG: campo puntero urgente significativo
ACK: campo de confirmación significativo
PSH: Función push
RST: Restablecimiento de la conexión
SYN: Sincronizar números de secuencia
FIN: No hay más datos del remitente

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device network list-firewall-rules
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 Ruleset     IsValid SourceIp     SourceMask      DestinationIp   DestinationMask UID        Action InterfaceInName TcpInv Protocol SourcePortRange DestinationPortRange Packets Bytes  TcpMask TcpCmp
 =====================================================================================================================================================================================================
 PREROUTING  False   None         None            None            None            None       None   None            None   None     None            None                 None    None   None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  any      0-65535         0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 True   tcp      0-65535         0-65535              823     394754 syn,ack syn
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    192.168.35.1 <value>         <value>         <value>         <value>     accept azspheresvc     False  any      0-65535         0-65535              15      780    None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------
 INPUT       True    <value>      <value>         <value>         <value>         <value>     accept                 False  udp      53-53           0-65535              0       0      None    None
 ----------- ------- ------------ --------------- --------------- --------------- ---------- ------ --------------- ------ -------- --------------- -------------------- ------- ------ ------- ------

interfaces de lista de red

Enumera las interfaces de red para el dispositivo conectado.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device network list-interfaces
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 InterfaceName InterfaceUp ConnectedToNetwork IpAcquired IpAddresses   ConnectedToInternet IpAssignment HardwareAddress
 ========================================================================================================================
 azspheresvc   True        False              False      <value>       False               None         None
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 eth0          True        True               True       <value>       True                dynamic      <value>
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 lo            True        False              False      <value>       False               None         None
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------
 wlan0         True        True               True       <value>       True                dynamic      <value>
 ------------- ----------- ------------------ ---------- ------------- ------------------- ------------ -----------------

proxy de red

Administra el uso de la dirección de proxy para la conexión de red. Para más información sobre cómo configurar un dispositivo de Azure Sphere para conectarse a Internet a través de un servidor proxy, consulte Conexión a través de un servidor proxy.

Nota:

Actualmente solo se admiten servidores proxy HTTP.

Operación	Descripción
aplicación de proxy	Configura el proxy de red en el dispositivo conectado.
eliminación de proxy	Elimina la conexión de proxy en el dispositivo conectado.
proxy show	Muestra la conexión de proxy en el dispositivo conectado.

aplicación de proxy

Configura el proxy de red en el dispositivo conectado.

Parámetros obligatorios

Parámetro	Tipo	Descripción
-a, --address	Cadena	Especifica la dirección de red del proxy que se va a usar.
-t, --authentication	Cadena	Especifica el tipo de autenticación que se va a usar. Valores permitidos: `anonymous` o `basic`. Si el proxy requiere un nombre de usuario y una contraseña, establézcalo `basic`en ; de lo contrario, use `anonymous`.
-r, --port	Entero	Especifica el puerto en la dirección de red que se va a usar. El valor debe ser igual o menor que 65535.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
--habilitar	Cadena	Especifica si se debe habilitar el proxy. Debe establecer o `--enable` `--disable`.
--inutilizar	Cadena	Especifica si se debe deshabilitar el proxy. Debe establecer o `--enable` `--disable`.
-n, --no-proxy-addresses	Cadena	Especifica una matriz de direcciones de red separadas por espacios que el dispositivo debe evitar para la conexión de proxy.
-p, --password	Cadena	Especifica la contraseña para la autenticación de proxy solo usada para la autenticación básica. Longitud máxima: 64 caracteres.
-u, --username	Cadena	Especifica el nombre de usuario para la autenticación de proxy. Solo se usa para la autenticación básica. Longitud máxima: 64 caracteres.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device network proxy apply --address contoso.com --authentication anonymous --port 8080 --enable
 ----------- ------- ----- ------------------ ----------------
 Address     Enabled Port  AuthenticationType NoProxyAddresses
 =============================================================
 contoso.com True   8080  anonymous
 ----------- ------- ----- ------------------ ----------------

eliminación de proxy

Elimina la conexión de proxy en el dispositivo conectado.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device network proxy delete

proxy show

Muestra la conexión de proxy en el dispositivo conectado.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device network proxy show
 ----------- ------- ----- ------------------ ----------------
 Address     Enabled Port  AuthenticationType NoProxyAddresses
 =============================================================
 contoso.com True   8080  anonymous
 ----------- ------- ----- ------------------ ----------------

network show-diagnostics

Muestra diagnósticos para una o todas las redes Wi-Fi en el dispositivo conectado.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
-n, --network	Entero	Especifica el identificador de la red Wi-Fi para la que se mostrarán los diagnósticos.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device network show-diagnostics
 ------------------------- --------- ----- ------------- --------------- --------
 Timestamp                 NetworkId Ssid  ConfigState   ConnectionState Error
 ================================================================================
 2021-06-16T20:51:29+00:00 0         <value> temp-disabled disconnected    WrongKey
 ------------------------- --------- ----- ------------- --------------- --------

network show-status

Muestra el estado de red del dispositivo conectado.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device network show-status
 --------------------------- --------------- -----
 DeviceAuthenticationIsReady NetworkTimeSync Proxy
 =================================================
 True                        complete        ready
 --------------------------- --------------- -----

interfaz de actualización de red

Actualiza la interfaz de red Ethernet del dispositivo. Para obtener más información sobre cómo establecer la dirección MAC para el dispositivo, consulte Configuración del dispositivo para Ethernet.

Nota:

Este comando es compatible con la configuración de conexiones Ethernet eth0 . Se devuelve un error si configura loo azspheresvc wlan0.

Parámetros obligatorios

Parámetro	Tipo	Descripción
--hardware-address	Cadena	Especifica la dirección de hardware que se va a establecer para el dispositivo en cualquiera de los siguientes formatos: `AA:BB:33:DD:EE:FF` o `aa:bb:33:dd:ee:ff`.
--interfaz o bien --interface-name [Retirar]	Cadena	Especifica el nombre de la interfaz que se va a configurar. Ejecute azsphere device network list-interfaces para ver los detalles de las interfaces de red del dispositivo conectado. El `--interface-name` argumento se retirará y se quitará en una versión futura. Para más información, consulte Cambios importantes (retirada de características) en la CLI de Azure Sphere.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device network update-interface --interface eth0 --hardware-address ba:98:76:54:32:10

recover

Reemplaza el software del sistema en el dispositivo.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que ejecutar el comando cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Especifique el identificador, la dirección IP o el identificador de conexión local del dispositivo.
-c, --capability	Cadena	Especifica la imagen de funcionalidad del dispositivo que se va a aplicar al dispositivo durante la recuperación.
-i, --images	Cadena	Especifica la ruta de acceso a una carpeta que contiene los paquetes de imagen que se van a escribir en el dispositivo. De forma predeterminada, la recuperación utiliza las imágenes del SDK a menos que se proporcione una ruta alternativa con esta marca.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

Ejemplo 1:

azsphere device recover
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 17 images. (5443272 bytes to send)
Sent 1 of 17 images. (5440896 of 5443272 bytes remaining)
Sent 2 of 17 images. (5414844 of 5443272 bytes remaining)
Sent 3 of 17 images. (5311892 of 5443272 bytes remaining)
Sent 4 of 17 images. (5311500 of 5443272 bytes remaining)
Sent 5 of 17 images. (5041520 of 5443272 bytes remaining)
Sent 6 of 17 images. (5024908 of 5443272 bytes remaining)
Sent 7 of 17 images. (4994856 of 5443272 bytes remaining)
Sent 8 of 17 images. (2397456 of 5443272 bytes remaining)
Sent 9 of 17 images. (885796 of 5443272 bytes remaining)
Sent 10 of 17 images. (861220 of 5443272 bytes remaining)
Sent 11 of 17 images. (758608 of 5443272 bytes remaining)
Sent 12 of 17 images. (135796 of 5443272 bytes remaining)
Sent 13 of 17 images. (70048 of 5443272 bytes remaining)
Sent 14 of 17 images. (41164 of 5443272 bytes remaining)
Sent 15 of 17 images. (32768 of 5443272 bytes remaining)
Sent 16 of 17 images. (16384 of 5443272 bytes remaining)
Sent 17 of 17 images. (0 of 5443272 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.

Ejemplo 2:

azsphere device recover --capability "C:\Users\capability file\capability_352FE1F_5.bin"
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 16 images. (5474668 bytes to send)
Sent 1 of 16 images. (5447384 of 5474668 bytes remaining)
Sent 2 of 16 images. (5343788 of 5474668 bytes remaining)
Sent 3 of 16 images. (5343396 of 5474668 bytes remaining)
Sent 4 of 16 images. (5073416 of 5474668 bytes remaining)
Sent 5 of 16 images. (5056612 of 5474668 bytes remaining)
Sent 6 of 16 images. (5026240 of 5474668 bytes remaining)
Sent 7 of 16 images. (2479376 of 5474668 bytes remaining)
Sent 8 of 16 images. (889892 of 5474668 bytes remaining)
Sent 9 of 16 images. (865316 of 5474668 bytes remaining)
Sent 10 of 16 images. (754512 of 5474668 bytes remaining)
Sent 11 of 16 images. (135796 of 5474668 bytes remaining)
Sent 12 of 16 images. (70048 of 5474668 bytes remaining)
Sent 13 of 16 images. (41164 of 5474668 bytes remaining)
Sent 14 of 16 images. (32768 of 5474668 bytes remaining)
Sent 15 of 16 images. (16384 of 5474668 bytes remaining)
Sent 16 of 16 images. (0 of 5474668 bytes remaining)
Finished writing images; rebooting board.
Device ID: 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968
Device recovered successfully.

volver a examinar la conexión

Vuelve a examinar los dispositivos conectados mediante el ciclo de energía de todos sus puertos FTDI y muestra el recuento total de dispositivos conectados. Use este comando al solucionar problemas de conexión de dispositivos en Windows. Este comando solo se ejecuta en Windows.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

 azsphere device rescan-attached
 -----------
 Count
 ===========
 2
 -----------

restart

Reinicia el dispositivo conectado.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device restart
Restarting device.
Device restarted successfully.

mostrar

Muestra los detalles de un dispositivo conectado en el inquilino de Azure Sphere.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando. Este parámetro es necesario cuando se conectan varios dispositivos o cuando no hay ningún dispositivo conectado. El dispositivo conectado actualmente se usa de forma predeterminada. Puede proporcionar un identificador de dispositivo para un dispositivo no conectado, o bien puede especificar la dirección IP o el identificador de conexión local de un dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
-t, --tenant	GUID o nombre	Especifica el inquilino en el que se va a realizar esta operación. Invalida el inquilino seleccionado predeterminado. Puede especificar el identificador de inquilino o el nombre del inquilino.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device show
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                                                         TenantId                             ChipSku  ProductId                            DeviceGroupId
 ========================================================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ -------- ------------------------------------ ------------------------------------

Puede usar el --query parámetro para personalizar la salida mostrada para este comando. Para más información, consulte Salida del comando de la CLI de consulta.

En el ejemplo siguiente se muestra cómo seleccionar solo el identificador de dispositivo y el identificador de producto:

azsphere device show --device 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968  --query '{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

show-attached

Muestra la información sobre el dispositivo conectado desde el propio dispositivo. Estos detalles son distintos de los que el servicio de seguridad de Azure Sphere almacena para el dispositivo.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device show-attached
Device ID: 352fe1f59e40ef8a9266415e81af32b5b07d8f2bbd6b5650cef4a70b86c7fcbc70b129a41fbc6d02f8bb4aaabc52cd5740c85427d205e46a166b7e41135eb968
IP address: 192.128.48.1
Connection path: 21143

show-deployment-status

Muestra el estado de implementación de las actualizaciones del sistema operativo y de las aplicaciones en el dispositivo.

Use este comando para averiguar qué versión del sistema operativo de Azure Sphere se ejecuta en el dispositivo o si ha realizado la actualización de la implementación actual.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
-t, --tenant	GUID o nombre	Especifica el inquilino en el que se va a realizar esta operación. Invalida el inquilino seleccionado predeterminado. Puede especificar el identificador de inquilino o el nombre del inquilino.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device show-deployment-status
Your device is running Azure Sphere OS version <version-number>.
The Azure Sphere Security Service is targeting this device with Azure Sphere OS version <version-number>.
Your device has the expected version of the Azure Sphere OS: <version-number>.

En este ejemplo, <el número> de versión representa la versión actual del sistema operativo.

show-count

Muestra el número de dispositivos en el inquilino actual.

Parámetros opcionales

Parámetro	Tipo	Descripción
-t, --tenant	GUID o nombre	Especifica el inquilino en el que se va a realizar esta operación. Invalida el inquilino seleccionado predeterminado. Puede especificar el identificador de inquilino o el nombre del inquilino.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

 azsphere device show-count
 ------
 Result
 ======
 2
 ------

show-os-version

Muestra la versión actual del sistema operativo en el dispositivo conectado.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device show-os-version
Your device is running Azure Sphere OS version <version-number>

En este ejemplo, <el número> de versión representa la versión actual del sistema operativo.

instalación de prueba

Administra la aplicación en el dispositivo.

Algunas opciones de instalación de prueba requieren funcionalidades adicionales una vez que el dispositivo está en estado de fabricación DeviceComplete. La funcionalidad fieldServicing permite implementar y eliminar imágenes firmadas por producción temporales e implementar imágenes firmadas por producción permanentes. La funcionalidad appDevelopment permite implementar y eliminar imágenes firmadas por producción y firmadas por SDK.

Operación	Descripción
eliminación	Elimina la aplicación actual del dispositivo.
deploy	Carga una aplicación en el dispositivo.
set-deployment-timeout	Establece el período de tiempo de espera de implementación en segundos.
show-deployment-timeout	Muestra el período de tiempo de espera de implementación en segundos.

Tenga en cuenta que los parámetros a , , y se han movido al comando azsphere device app.show-quota show-statusstopstart

sideload delete

Elimina las aplicaciones del dispositivo.

Este comando solo está disponible si la funcionalidad del dispositivo appDevelopment está configurada.

Parámetros opcionales

Parámetro	Tipo	Descripción
-i, --component-id	GUID	Especifica el identificador de la aplicación que se va a eliminar del dispositivo. Si se omite, se eliminan todas las aplicaciones.
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device sideload delete
Component '54acba7c-7719-461a-89db-49c807e0fa4d' deleted.

sideload deploy

Carga una aplicación en el dispositivo conectado e inicia la aplicación.

Este comando produce un error si el manifiesto de aplicación solicita algún recurso que esté usando otra aplicación ya presente en el dispositivo. En este caso, utilice azsphere device sideload delete para eliminar la aplicación existente y, a continuación, vuelva a intentar la transferencia local. El comando azsphere device sideload delete elimina las aplicaciones de alto nivel y las aplicaciones en tiempo real. Para eliminar una aplicación y dejar la otra, especifique el identificador de componente de la aplicación que se va a eliminar.

El mismo comando se utiliza para implementar aplicaciones de alto nivel y aplicaciones con respuesta en tiempo real.

Nota:

Se desencadena un reinicio del dispositivo cuando se instala una nueva aplicación que usa periféricos y se cumplen las condiciones siguientes:

El estado de fabricación del dispositivo se establece en DeviceComplete.
La funcionalidad appDevelopment no está presente en el dispositivo. Para obtener más información, consulte Bloqueo de configuración de periféricos.

Si se inicia un reinicio del dispositivo, espere hasta que se complete el reinicio y el dispositivo responda.

Parámetros obligatorios

Parámetro	Tipo	Descripción
-p, --image-package	Cadena	Especifica la ruta de acceso y el nombre del archivo del paquete de imágenes que se cargará al dispositivo.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
-m, --manual-start	Booleano	Especifica que no se inicie automáticamente la aplicación después de cargarla.
--force	Booleano	Fuerza la implementación de una imagen que utiliza una API Beta que ya no se admite.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device sideload deploy --image-package C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage
Deploying 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' to the attached device.
Image package 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' has been deployed to the attached device.

instalación de prueba set-deployment-timeout

Establece el valor de tiempo de espera de implementación en segundos para transferir localmente imágenes en el dispositivo.

Parámetros obligatorios

Parámetro	Tipo	Descripción
-v, --value	Entero	Especifica la duración en segundos antes de que se agote el tiempo de espera de un comando de instalación de prueba. El valor debe ser un entero positivo.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device sideload set-deployment-timeout --value 60
 ------------------
 Deployment timeout
 ==================
 60
 ------------------

transferir localmente show-deployment-timeout

Muestra el valor de tiempo de espera de implementación actual en segundos para transferir localmente imágenes en el dispositivo.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device sideload show-deployment-timeout
 ------------------
 Deployment timeout
 ==================
 60
 ------------------

update

Mueve el dispositivo en un grupo de dispositivos diferentes en el inquilino de Azure Sphere.

Además de los grupos de dispositivos que se crean en un producto, se agregan cinco grupos de dispositivos predeterminados cuando se crea un producto:

Desarrollo: solo acepta actualizaciones de software del sistema. No acepta actualizaciones de aplicaciones.
Prueba de campo: acepta todas las actualizaciones del servicio de seguridad de Azure Sphere.
Producción: acepta todas las actualizaciones del servicio de seguridad de Azure Sphere.
Evaluación del sistema operativo de producción: acepta todas las actualizaciones del servicio de seguridad de Azure Sphere.
Evaluación del sistema operativo de prueba de campo: acepta todas las actualizaciones del servicio de seguridad de Azure Sphere.

Para obtener más información sobre los elementos fundamentales implicados en la implementación, consulte Conceptos básicos de la implementación.

Parámetros opcionales

Parámetro	Tipo	Descripción
-g, --device-group	GUID o nombre	Especifica el grupo de dispositivos en el que se va a mover el dispositivo. Puede especificar el identificador del grupo de dispositivos o el nombre del grupo de dispositivos. Para usar el nombre del grupo de dispositivos, debe proporcionar el nombre del producto y el nombre del grupo de dispositivos en el `<product-name/device-group-name>` formato .
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando. Este parámetro es necesario cuando se conectan varios dispositivos o cuando no hay ningún dispositivo conectado. El dispositivo conectado actualmente se usa de forma predeterminada. Puede proporcionar un identificador de dispositivo para un dispositivo no conectado, o bien puede especificar la dirección IP o el identificador de conexión local de un dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
-t, --tenant	GUID o nombre	Especifica el inquilino en el que se va a realizar esta operación. Invalida el inquilino seleccionado predeterminado. Puede especificar el identificador de inquilino o el nombre del inquilino.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device update --device-group AW100/Marketing
 ------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------
 DeviceId                                                                                               TenantId                             ChipSku  ProductId                            DeviceGroupId
 ==============================================================================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85 a323c263-2aa3-2559-aabb-a3fc32631900 MT3620AN 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
 427D205E46A166B7E41135EB968
 ------------------------------------------------------------------------------------------------------ ------------------------------------ -------- ------------------------------------ ------------------------------------

Puede usar el --query parámetro para personalizar la salida mostrada para este comando. Para más información, consulte Salida del comando de la CLI de consulta.

En el ejemplo siguiente se muestra cómo seleccionar solo el identificador de dispositivo y el identificador de producto:

azsphere device update --device-group AW100/Marketing  --query '{DeviceId:deviceId, ProductId:productId}'
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------
 DeviceId                                                                                                                         ProductId
 =====================================================================================================================================================================
 352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 6f52bead-700d-4289-bdc2-2f11f774270e
 -------------------------------------------------------------------------------------------------------------------------------- ------------------------------------

wifi

Administra las configuraciones de Wi-Fi para el dispositivo conectado.

Para usar el dispositivo en una red Wi-Fi, debe agregar información sobre la red y habilitar la red en el dispositivo. Aunque puede escribir caracteres no ASCII en los SSID, azsphere no los muestra correctamente.

Si la aplicación usa la API de configuración de Wi-Fi, también debe incluir la funcionalidad WifiConfig en el archivo app_manifest.json de la aplicación.

Operación	Descripción
agregar	Agrega los detalles de una red inalámbrica al dispositivo.
disable	Deshabilita una red inalámbrica en el dispositivo.
enable	Habilita una red inalámbrica en el dispositivo.
forget	Elimina los detalles de una red inalámbrica del dispositivo.
list	Muestra la configuración de Wi-Fi actual del dispositivo.
reload-config	Recarga la configuración de Wi-Fi del dispositivo.
scan	Busca las redes disponibles.
show	Muestra los detalles de una configuración de Wi-Fi.
show-status	Muestra el estado de la interfaz inalámbrica.

wifi add

Agrega detalles de una red Wi-Fi al dispositivo conectado.

Un dispositivo puede tener varias conexiones Wi-Fi. Aunque puede escribir caracteres no ASCII en los SSID, azsphere no los muestra correctamente. Puede incluir el --targeted-scan parámetro para conectarse a SSID ocultos. Para más información, consulte Conexión de Azure Sphere a Wi-Fi.

Parámetros obligatorios

Parámetro	Tipo	Descripción
-s, --ssid	Cadena	Especifica el SSID de la red. Los SSID de red distinguen mayúsculas de minúsculas.

Parámetros opcionales

Parámetro	Tipo	Descripción
--client-cert-id	Cadena	[EAP-TLS] Especifica el identificador (hasta 16 caracteres) que identifica el certificado de cliente (que contiene la clave pública y privada). Se requiere para la instalación de una red EAP-TLS.
--client-id <user@domain>	Cadena	[EAP-TLS] Especifica el identificador reconocido para la autenticación por el servidor RADIUS de la red. Es un requisito para algunas redes EAP-TLS.
--config-name	Cadena	Especifica una cadena (hasta 16 caracteres) que especifica el nombre de la configuración de red.
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.
--root-ca-cert-id	Cadena	[EAP-tLS] Especifica el identificador (hasta 16 caracteres) que identifica el certificado de CA raíz del servidor para las redes EAP-TLS donde el dispositivo autentica el servidor.
--targeted-scan	Booleano	Intenta conectarse a una red incluso cuando no está difundiendo o está oculta por la congestión de red.
-p, --psk	Cadena	Especifica la clave WPA o WPA2 para la nueva red. Omítala para agregar este SSID como una red abierta. Si la clave contiene una Y comercial (&), escriba la clave entre comillas.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device wifi add --ssid MyNetwork --psk MyPassword
Successfully added network:
 ----- -------- ------------------ --------------- ------------- ------------
 ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
 ============================================================================
 1     MyNetwork enabled            unknown         psk           False
 ----- -------- ------------------ --------------- ------------- ------------

Si el SSID de red o la clave tiene espacios incrustados o una y comercial, incluya el SSID o la clave entre comillas simples. Si el SSID o la clave incluyen unas comillas, use una barra diagonal inversa para escapar las comillas. No es necesario que las barras diagonales inversas se escapen si forman parte de un valor. Para obtener más información, vea Comillas y caracteres de escape. Por ejemplo:

azsphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"

wifi disable

Deshabilita una red Wi-Fi en el dispositivo conectado.

Parámetros obligatorios

Parámetro	Tipo	Descripción
-i, --id	Entero	Especifica el id. de la red que se deshabilitará.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device wifi disable --id 0
Successfully disabled network:
----- -------- ------------------ --------------- ------------- ------------
ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
============================================================================
0     MyNetwork disabled           disconnected    psk           False
----- -------- ------------------ --------------- ------------- ------------

wifi enable

Habilita una red Wi-Fi en el dispositivo conectado.

Para cambiar de una red a otra si ambas están al alcance, deshabilite la red conectada actualmente antes de habilitar la nueva red.

Parámetros obligatorios

Parámetro	Tipo	Descripción
-i, --id	Entero	Especifica el id. de la red que se habilitará.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device wifi enable --id 0
Successfully enabled network:
 ----- -------- ------------------ --------------- ------------- ------------
 ID    SSID     ConfigurationState ConnectionState SecurityState TargetedScan
 ============================================================================
 0     MyNetwork enabled            disconnected    psk           False
 ----- -------- ------------------ --------------- ------------- ------------

wifi forget

Quita los detalles de una red Wi-Fi del dispositivo conectado.

Parámetros obligatorios

Parámetro	Tipo	Descripción
-i, --id	Entero	Especifica el id. de la red que se eliminará.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device wifi forget --id 0
Successfully forgotten network.

wifi list

Enumera la configuración actual de Wi-Fi para el dispositivo conectado.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device wifi list
 ----- --------- ------------------ --------------- ------------- ------------
 ID    SSID      ConfigurationState ConnectionState SecurityState TargetedScan
 =============================================================================
 0     MyNetwork1 enabled            connected       psk           False
 ----- ---------  ------------------ --------------- ------------- ------------
 1     MyNetwork2 enabled            disconnected    psk           False
 ----- ---------  ------------------ --------------- ------------- ------------
 2     MyNetwork3 enabled            disconnected    eaptls        False
 ----- ---------  ------------------ --------------- ------------- ------------

wifi reload-config

Recarga la configuración de red Wi-Fi en el dispositivo conectado. Use este comando después de agregar o quitar un certificado (azsphere device certificate) para asegurarse de que las redes EAP-TLS usan el contenido más reciente del almacén de certificados.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device wifi reload-config
Wi-Fi configuration was successfully reloaded.

wifi scan

Busque redes Wi-Fi disponibles visibles para el dispositivo conectado. El comando devuelve hasta 64 redes Wi-Fi, pero el número de redes Wi-Fi mostradas puede estar limitada por factores ambientales como la densidad de los puntos de acceso en el intervalo.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device wifi scan
----------------- ------------- ----------------- ----------- ---------
SSID              SecurityState BSSID             SignalLevel Frequency
=======================================================================
MyNetwork0        psk           <value>           -66         2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork1        psk           <value>           -75         2442
----------------- ------------- ----------------- ----------- ---------
MyNetwork2        psk           <value>           -86         2412
----------------- ------------- ----------------- ----------- ---------

wifi show

Muestra los detalles de una red Wi-Fi en el dispositivo conectado.

Parámetros obligatorios

Parámetro	Tipo	Descripción
-i, --id	Entero	Especifica el identificador de la configuración de red que se va a mostrar.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

azsphere device wifi show --id 0
 ----- --------- ------------------ --------------- ------------- ------------
 ID    SSID      ConfigurationState ConnectionState SecurityState TargetedScan
 =============================================================================
 0     MyNetwork enabled            disconnected    psk           False
 ----- --------- ------------------ --------------- ------------- ------------

wifi show-status

Muestra el estado de la interfaz Wi-Fi en el dispositivo conectado.

Parámetros opcionales

Parámetro	Tipo	Descripción
-d, --device	Cadena	Especifica el dispositivo en el que se va a ejecutar el comando cuando se conectan varios dispositivos. Este parámetro es necesario cuando se conectan varios dispositivos. El dispositivo conectado actualmente se usa de forma predeterminada. Puede especificar el identificador de dispositivo, la dirección IP o el identificador de conexión local del dispositivo conectado. La CLI de Azure Sphere admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no para Linux. Se devuelve un error si usa este parámetro con el comando en Linux.

Parámetros globales

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

Parámetro	Descripción
--debug	Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentra un error, proporcione la salida que se genera con la marca `--debug` activada al enviar un informe de errores.
-h, --help	Imprime información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors	Muestra solo errores, supresión de advertencias.
-o, --output	Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON coloreado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles) y yaml. De forma predeterminada, la CLI genera `table`. Para más información sobre los formatos de salida disponibles, consulte Formato de salida para comandos de la CLI de Azure Sphere.
--query	Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta desde Servicios de seguridad de Azure Sphere. Consulte el tutorial de JMESPath y consulta la salida del comando de la CLI de Azure para obtener más información y ejemplos.
--verbose	Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Use `--debug` para los registros de depuración completos.

Nota:

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para más información sobre las opciones disponibles.

Ejemplo

 azsphere device wifi show-status
 ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------
 SSID  ConfigurationState ConnectionState SecurityState Frequency Mode    KeyManagement WpaState  IpAddress     MacAddress
 ================================================================================================================================
<value> enabled            connected       psk           2412      station WPA2-PSK      COMPLETED <value>      <value>
 ----- ------------------ --------------- ------------- --------- ------- ------------- --------- ------------- -----------------

Compartir vía

device

app

app show-memory-stats

Parámetros opcionales

Ejemplo

app show-quota

Parámetros opcionales

Ejemplo

app show-status

Parámetros opcionales

Ejemplo

app start

Parámetros opcionales

Ejemplo

app stop

Parámetros opcionales

Ejemplo

capability

capability download

Parámetros obligatorios

Parámetros opcionales

Ejemplo

capability select

Parámetros opcionales

Ejemplo

capability show-attached

Parámetros opcionales

Ejemplo

capability update

Parámetros obligatorios

Parámetros opcionales

Ejemplo

certificado

certificate add

Parámetros obligatorios

Parámetros opcionales

Ejemplo

certificate delete

Parámetros obligatorios

Parámetros opcionales

Ejemplo

certificate list

Parámetros opcionales

Ejemplo

certificate show

Parámetros obligatorios

Parámetros opcionales

Ejemplo

certificate show-quota

Parámetros opcionales

Ejemplo

claim

Parámetros opcionales

Ejemplo

enable-cloud-test

Parámetros opcionales

Ejemplos

enable-development

Parámetros opcionales

Ejemplo

imagen

image list-installed

Parámetros opcionales

Ejemplo

image list-targeted

Parámetros opcionales

Ejemplo

list

Parámetros opcionales

Ejemplo

list-attached

Ejemplo

estado de fabricación

manufacturing-state show

Parámetros opcionales

Ejemplo

manufacturing-state update

Parámetros obligatorios

Parámetros opcionales