device-group
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).
Crea y administra grupos de dispositivos.
Los grupos de dispositivos se direccionan por identificador (id.) o por un par de nombre de producto y nombre de grupo de dispositivos.
| Operación | Descripción |
|---|---|
| create | Crea un nuevo grupo de dispositivos. |
| list | Enumere todos los grupos de dispositivos del inquilino de Azure Sphere. |
| eliminación | Elimina un grupo de dispositivos existente. |
| implementación | Administra las implementaciones dentro de un grupo de dispositivos. |
| device | Enumera los dispositivos de un grupo de dispositivos. |
| show | Muestra información sobre un grupo de dispositivos. |
| update | Modifica un grupo de dispositivos existente. |
create
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 obligatorios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -p, --product | GUID o nombre | Especifica el producto al que agregar este grupo de dispositivos. Puede especificar el identificador o el nombre del producto de Azure Sphere. |
| -n,--name | Cadena | Especifica un nombre para el grupo de dispositivos. El nombre solo puede incluir caracteres alfanuméricos. Si el nombre tiene 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 dentro del producto. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -a, --application-update | Enum | Especifica la directiva de actualización de aplicaciones que se va a aplicar a este grupo de dispositivos. Valores aceptados: No3rdPartyAppUpdates, UpdateAlly NoUpdates. El valor predeterminado es UpdateAll. La NoUpdates directiva solo está reservada para uso interno. |
| -f, --os-feed | Enum | Especifica el tipo de fuente del sistema operativo que se va a usar para las actualizaciones del sistema operativo. Valores aceptados: Retail, RetailEval. |
| -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. |
| -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 tiene espacios, escríbala 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 más información, consulte Configuración de volcados de memoria: consideraciones de Pivacy |
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-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
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
list
Enumere todos los grupos de dispositivos del inquilino de Azure Sphere.
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-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
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
delete
Elimina el grupo de dispositivos especificado en el inquilino 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 en él. 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 otro grupo de dispositivos.
Parámetros obligatorios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -g, --device-group | Cadena | Especifica el grupo de dispositivos que se va a eliminar. 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 . |
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-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
implementación
Administra las implementaciones de un grupo de dispositivos.
| Operación | Descripción |
|---|---|
| create | Crea una implementación para el grupo de dispositivos especificado. |
| list | Muestra las implementaciones de un grupo de dispositivos. |
deployment create …
Crea una nueva implementación para un grupo de dispositivos con las imágenes proporcionadas.
Puede identificar el grupo de dispositivos por identificador (id.) o por un par de nombre de producto y nombre de grupo de dispositivos.
Parámetros obligatorios
| 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 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 . |
| -i, --images | Cadena | Especifica los identificadores de imagen de una o varias imágenes que se van a incluir en la implementación. Puede agregar varias imágenes agregando parámetros adicionales o se pueden combinar varios identificadores de imagen en un único parámetro de una lista separada por espacios. Ejecute el comando azsphere image add para obtener el identificador de imagen. |
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
El --device-group parámetro identifica el grupo de dispositivos. El identificador del grupo de dispositivos proporciona un GUID que identifica de forma única el grupo de dispositivos en todos los productos. Como alternativa, puede usar el nombre del producto y el par nombre del grupo de dispositivos en el <formato product-name>/<device-group-name> . Este par de nombres identifica de manera ú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
La salida debería ser parecida a la que se muestra a continuación:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
deployment list
Muestra el historial de implementación de un grupo de dispositivos. Devuelve el identificador de implementación, la marca de tiempo y la lista de imágenes incluidas. La lista está ordenada por las implementaciones más recientes.
Parámetros obligatorios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -g, --device-group | Cadena | Especifica el grupo de dispositivos para el que se va a mostrar la lista del historial de implementación. 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 . |
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
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
La salida debería ser parecida a la que se muestra a continuación:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
device
Administra los dispositivos de un grupo de dispositivos.
| Operación | Descripción |
|---|---|
| list | Muestra los dispositivos de un grupo de dispositivos. |
| show-count | Muestra el número de dispositivos de un grupo de dispositivos. |
device list
Muestra los dispositivos de un grupo de dispositivos.
Parámetros obligatorios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -g, --device-group | Cadena | Especifica el grupo de dispositivos para el que se va a mostrar la lista de dispositivos. 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 . |
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
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
La salida debería ser parecida a la que se muestra a continuación:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
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 obligatorios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -g, --device-group | Cadena | Especifica el grupo de dispositivos para el que se va a mostrar el recuento de dispositivos. 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 . |
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
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 device-group por nombre:
azsphere device-group device show-count --device-group DW100/Marketing
La salida debería ser parecida a la que se muestra a continuación:
------
Result
======
1
------
mostrar
Devuelve información sobre un grupo de dispositivos.
Parámetros obligatorios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -g, --device-group | Cadena | Especifica el grupo de dispositivos para el que se van a mostrar los detalles. 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 . |
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
Ejemplo para especificar el grupo de dispositivos por identificador:
azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Ejemplo para especificar device-group por nombre:
azsphere device-group show --device-group DW100/Marketing
La salida debería ser parecida a la que se muestra a continuación:
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
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
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
update
Actualiza un grupo de dispositivos existente, identificado por el identificador o por el par de nombre de producto y nombre de grupo de dispositivos.
Parámetros obligatorios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -g, --device-group | Cadena | Especifica el grupo de dispositivos para el que se van a actualizar los detalles. 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 . |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -c, --allow-crash-dumps-collection | Cadena | Establezca el consentimiento para la recopilación de volcados de memoria de Microsoft para el grupo de dispositivos. El valor predeterminado es Off. Valores permitidos: Off y On. Use el --regional-data-boundary parámetro para especificar dónde se deben almacenar los archivos de volcado de memoria. Para más información, consulte Configuración de 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 solo está reservada 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 nuevo nombre para el grupo de dispositivos. El nombre solo puede incluir caracteres alfanuméricos. Si el nombre tiene 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 dentro del 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 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. |
| -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 más información, consulte Configuración de volcados de memoria: consideraciones de Pivacy |
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 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 device-group por nombre:
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
La salida debería ser parecida a la que se muestra a continuación:
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------