Compartir vía

device-group

  • Artículo

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:

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