grupo de dispositivos
Crea y administra grupos de dispositivos.
Los grupos de dispositivos se dirigen mediante identificador (ID) o mediante un nombre de producto y un par de nombres de grupo de dispositivos.
| Operación | Descripción |
|---|---|
| Crear | Crea un nuevo grupo de dispositivos. |
| Lista | Enumérese todos los grupos de dispositivos de su inquilino de Azure Sphere. |
| Eliminar | Elimina un grupo de dispositivos existente. |
| despliegue | Administra las implementaciones dentro de un grupo de dispositivos. |
| Dispositivo | Enumera los dispositivos de un grupo de dispositivos. |
| Mostrar | Muestra información sobre un grupo de dispositivos. |
| actualizar | Modifica un grupo de dispositivos existente. |
Crear
Crea un grupo de dispositivos con el nombre especificado para el producto especificado. El grupo de dispositivos organiza los dispositivos que tienen el mismo producto y reciben las mismas aplicaciones de la nube.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -p, --product | GUID o nombre | Especifica el producto al que se agregará este grupo de dispositivos. Puede especificar el id. o el nombre del producto Azure Sphere. |
| -n, --name | Cadena | Especifica un nombre para el grupo de dispositivos. El nombre solo puede incluir caracteres alfanuméricos. Si el nombre incluye espacios, escríbalo entre comillas. El nombre del grupo de dispositivos no puede superar los 50 caracteres, no distingue mayúsculas de minúsculas, debe ser único en el producto. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -a, --application-update | Enum | Especifica la directiva de actualización de aplicaciones que se aplicará a este grupo de dispositivos. Valores aceptados: No3rdPartyAppUpdates, UpdateAll, y NoUpdates. El valor predeterminado es UpdateAll. La NoUpdates directiva está reservada actualmente solo para uso interno. |
| -f, --os-feed | Enum | Especifica el tipo de fuente del sistema operativo que se usará para las actualizaciones del sistema operativo. Valores aceptados: Retail, RetailEval. |
| -t, --tenant | GUID o nombre | Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. de inquilino o el nombre del inquilino. |
| -d, --description | Cadena | Especifica el texto opcional para describir el grupo de dispositivos. La longitud máxima es de 100 caracteres. Si la descripción incluye espacios, escríbalo entre comillas. |
| -r, --regional-data-boundary | Cadena | Límite de datos regionales para esta imagen. Valores permitidos: EU, None. El valor predeterminado es None. Si no se especifica ningún valor, se usará el valor predeterminado. Para obtener más información, consulte Configurar volcados de memoria: consideraciones sobre pivacy |
Parámetros globales
Los siguientes parámetros globales están disponibles para la CLI de Azure Sphere:
| Parámetro | Descripción |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
azsphere device-group create --name Marketing --product DW100
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- ---------------------
Id TenantId OsFeedType ProductId Name UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
===================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Lista
Enumérese todos los grupos de dispositivos de su inquilino de Azure Sphere.
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -t, --tenant | GUID o nombre | Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. 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 |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
azsphere device-group list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- ---------------------
Id Name Description ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
=====================================================================================================================================================================================================================================================================================
a3a49688-4601-4422-8b51-a0838ea84627 Development Default development device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept only system software updates. Don't accept application updates. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
7cb46b96-8c17-4afd-bd3f-614acad9d264 Field Test Default test device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
30c39bae-f525-4094-8008-d03705429ef0 Production Default production device group 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
cb5c9685-5dbe-470c-91a9-91dc129884d6 Production OS Evaluation Default Production OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
63e72035-3fcf-4fdc-b88a-05e30d1ba224 Field Test OS Evaluation Default Field Test OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
Eliminar
Elimina el grupo de dispositivos especificado en el espacio empresarial de Azure Sphere.
Un grupo de dispositivos solo se puede eliminar cuando:
- El usuario tiene permisos de administrador para el inquilino.
- El grupo de dispositivos está vacío y no tiene ningún dispositivo. El comando azsphere device-group device list enumera todos los dispositivos de un grupo de dispositivos. Ejecute azsphere device update --device-group para mover el dispositivo a un grupo de dispositivos diferente.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -g, --device-group | Cadena | Especifica el grupo de dispositivos que se va a eliminar. Puede especificar el id. de grupo de dispositivos o el nombre del grupo de dispositivos. Para usar el nombre del grupo de dispositivos, debes proporcionar el nombre del producto y el nombre del grupo de dispositivos en el <product-name/device-group-name> formato. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -t, --tenant | GUID o nombre | Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. 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 |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
azsphere device-group delete --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Successfully deleted the device group
azsphere device-group delete --device-group DW100/Development
Successfully deleted the device group
despliegue
Administra las implementaciones de un grupo de dispositivos.
| Operación | Descripción |
|---|---|
| Crear | Crea una nueva implementación para el grupo de dispositivos especificado. |
| Lista | Muestra las implementaciones de un grupo de dispositivos. |
creación de implementación
Crea una nueva implementación para un grupo de dispositivos con las imágenes suministradas.
Puedes identificar el grupo de dispositivos por identificador (ID) o por un nombre de producto y un par de nombres de grupo de dispositivos.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -g, --device-group | Cadena | Especifica el grupo de dispositivos en el que se va a crear la implementación. Puede especificar el id. de grupo de dispositivos o el nombre del grupo de dispositivos. Para usar el nombre del grupo de dispositivos, debes proporcionar el nombre del producto y el nombre del grupo de dispositivos en el <product-name/device-group-name> formato. |
| -i, --images | Cadena | Especifica los identificadores de imagen de una o más imágenes que se incluirán en la implementación. Puede agregar varias imágenes agregando parámetros adicionales o se pueden combinar varios identificadores de imagen en un solo parámetro de una lista separada por espacios. Ejecute el comando azsphere image add para obtener el id. de imagen. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -t, --tenant | GUID o nombre | Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. 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 |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
El --device-group parámetro identifica el grupo de dispositivos. El id. de grupo de dispositivos proporciona un GUID, que identifica de forma única el grupo de dispositivos en todos los productos. Como alternativa, puedes usar el nombre del producto y el par de nombres de grupo de dispositivos en el <formato product-name>/<device-group-name> . Este par de nombres identifica de forma única un grupo de dispositivos para un producto determinado.
Ejemplo para especificar el grupo de dispositivos por identificador:
azsphere device-group deployment create --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Ejemplo para especificar el grupo de dispositivos por nombre:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Ejemplo para especificar varios identificadores de imagen proporcionando una lista de valores separados por espacios:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1 3bbd2d2a-2870-4dde-9db8-ae50548ea7b4
Debería ver resultados como este:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb 5572509b-43a4-45b0-88c5-365cbf9732c1 2021-04-01T18:48:41.721662+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
lista de implementación
Muestra el historial de implementación de un grupo de dispositivos. Devuelve el id. de implementación, la marca de tiempo y la lista de imágenes incluidas. La lista la ordenan las implementaciones más recientes.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -g, --device-group | Cadena | Especifica el grupo de dispositivos para el que se mostrará la lista del historial de implementación. Puede especificar el id. de grupo de dispositivos o el nombre del grupo de dispositivos. Para usar el nombre del grupo de dispositivos, debes proporcionar el nombre del producto y el nombre del grupo de dispositivos en el <product-name/device-group-name> formato. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -t, --tenant | GUID o nombre | Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. 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 |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
Ejemplo para especificar el grupo de dispositivos por identificador:
azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Ejemplo para especificar el grupo de dispositivos por nombre:
azsphere device-group deployment list --device-group DW100/Development
Debería ver resultados como este:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id TenantId DeployedImages DeploymentDateUtc
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb e3769536-dc4b-48d9-afd4-22ed321ba4bc 2020-11-18T19:46:50.514429+00:00
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Dispositivo
Administra los dispositivos de un grupo de dispositivos.
| Operación | Descripción |
|---|---|
| Lista | Muestra los dispositivos de un grupo de dispositivos. |
| show-count | Muestra el número de dispositivos de un grupo de dispositivos. |
lista de dispositivos
Muestra los dispositivos de un grupo de dispositivos.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -g, --device-group | Cadena | Especifica el grupo de dispositivos para el que se mostrará la lista de dispositivos. Puede especificar el id. de grupo de dispositivos o el nombre del grupo de dispositivos. Para usar el nombre del grupo de dispositivos, debes proporcionar el nombre del producto y el nombre del grupo de dispositivos en el <product-name/device-group-name> formato. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -t, --tenant | GUID o nombre | Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. 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 |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
Ejemplo para especificar el grupo de dispositivos por identificador:
azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Ejemplo para especificar el grupo de dispositivos por nombre:
azsphere device-group device list --device-group DW100/Marketing
Debería ver resultados como este:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
device show-count
Muestra el número de dispositivos de un grupo de dispositivos.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -g, --device-group | Cadena | Especifica el grupo de dispositivos para el que mostrar el recuento de dispositivos. Puede especificar el id. de grupo de dispositivos o el nombre del grupo de dispositivos. Para usar el nombre del grupo de dispositivos, debes proporcionar el nombre del producto y el nombre del grupo de dispositivos en el <product-name/device-group-name> formato. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -t, --tenant | GUID o nombre | Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. 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 |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
Ejemplo para especificar el grupo de dispositivos por identificador:
azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Ejemplo para especificar el grupo de dispositivos por nombre:
azsphere device-group device show-count --device-group DW100/Marketing
Debería ver resultados como este:
------
Result
======
1
------
Mostrar
Devuelve información sobre un grupo de dispositivos.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -g, --device-group | Cadena | Especifica el grupo de dispositivos para el que se mostrarán los detalles. Puede especificar el id. de grupo de dispositivos o el nombre del grupo de dispositivos. Para usar el nombre del grupo de dispositivos, debes proporcionar el nombre del producto y el nombre del grupo de dispositivos en el <product-name/device-group-name> formato. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -t, --tenant | GUID o nombre | Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. 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 |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
Ejemplo para especificar el grupo de dispositivos por identificador:
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Ejemplo para especificar el grupo de dispositivos por nombre:
azsphere device-group show --device-group DW100/Marketing
Debería ver resultados como este:
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Id Name Description TenantId ProductId OsFeedType UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd Marketing Marketing device group 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e Retail Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
actualizar
Novedades un grupo de dispositivos existente, identificado por id. o por nombre de producto y par de nombres de grupo de dispositivos.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -g, --device-group | Cadena | Especifica el grupo de dispositivos para el que se actualizarán los detalles. Puede especificar el id. de grupo de dispositivos o el nombre del grupo de dispositivos. Para usar el nombre del grupo de dispositivos, debes proporcionar el nombre del producto y el nombre del grupo de dispositivos en el <product-name/device-group-name> formato. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -c, --allow-crash-dumps-collection | Cadena | Establece el consentimiento para la recopilación de volcados de memoria por parte de Microsoft para el grupo de dispositivos. El valor predeterminado es Off. Valores permitidos: Off y On. Usa el --regional-data-boundary parámetro para especificar dónde deben almacenarse los archivos de volcado de memoria. Para obtener más información, consulta Configurar volcados de memoria. |
| -a, --application-update | ApplicationUpdatePolicyType | Especifica la directiva de actualización de aplicaciones para el grupo de dispositivos. Valores permitidos: No3rdPartyAppUpdates, UpdateAll, y NoUpdates. El valor predeterminado es UpdateAll. La NoUpdates directiva está reservada actualmente solo para uso interno. |
| -d, --new-description | Cadena | Especifica texto opcional para describir el grupo de dispositivos. La longitud máxima es de 100 caracteres. |
| -n, --new-name | Cadena | Especifica un nombre nuevo para el grupo de dispositivos. El nombre solo puede incluir caracteres alfanuméricos. Si el nombre incluye espacios, escríbalo entre comillas. El nombre del grupo de dispositivos no puede superar los 50 caracteres, no distingue mayúsculas de minúsculas y debe ser único en el producto. |
| -f, --os-feed | Cadena | Especifica la fuente del sistema operativo para el grupo de dispositivos. Los valores posibles son Retail y RetailEval. |
| -t, --tenant | GUID o nombre | Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. de inquilino o el nombre del inquilino. |
| -r, --regional-data-boundary | Cadena | Límite de datos regionales para esta imagen. Valores permitidos: EU, None. El valor predeterminado es None. Si no se especifica ningún valor, se usará el valor predeterminado. Para obtener más información, consulte Configurar volcados de memoria: consideraciones sobre pivacy |
Parámetros globales
Los siguientes parámetros globales están disponibles para la CLI de Azure Sphere:
| Parámetro | Descripción |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
Ejemplo para especificar el grupo de dispositivos por identificador:
azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"
Ejemplo para especificar el grupo de dispositivos por nombre:
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
Debería ver resultados como este:
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
Id TenantId OsFeedType ProductId Name Description UpdatePolicy AllowCrashDumpsCollection RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail 6f52bead-700d-4289-bdc2-2f11f774270e Marketing Marketing device group Accept all updates from the Azure Sphere Security Service. False None
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------