Compartir vía

Administrar grupos de dispositivos

  • Artículo

En este tema se explica cómo administrar los grupos de dispositivos con la CLI o Azure Sphere Explorer. En los pasos de este tema se supone que está familiarizado con los conceptos de inquilinos, productos y grupos de dispositivos de Azure Sphere.

Lista de grupos de dispositivos

List all device groups in your Azure Sphere tenant using the azsphere device-group list command or by using the Device Group - List API.

Para enumerar todos los grupos de dispositivos:

azsphere device-group list

List the device groups in a specific product using the azsphere product device-group list command or by using the Product - List Groups API.

azsphere product device-group list --product <product-name>

  1. Abre Azure Sphere Explorer.

  2. Expanda el nodo Inquilino para el inquilino que le interesa.

  1. Abre Azure Sphere Explorer.

  2. Expanda el nodo Inquilino para el inquilino que le interesa.

Para ver los productos y grupos de dispositivos de un inquilino:

  1. Abre Azure Sphere Explorer.

  2. Expanda el nodo Inquilino para el inquilino que le interesa.

Si no hay ningún producto en la lista, crea un producto.

Si el dispositivo ya está asociado a un producto y está asignado a un grupo, puedes actualizar su grupo de dispositivos en cualquier momento.

Para ver los productos y grupos de dispositivos de un inquilino:

  1. Abre Azure Sphere Explorer.

  2. Expanda el nodo Inquilino para el inquilino que le interesa.

Si no hay ningún producto en la lista, crea un producto.

Si el dispositivo ya está asociado a un producto y está asignado a un grupo, puedes actualizar su grupo de dispositivos en cualquier momento.

Crear un grupo de dispositivos

Cree un grupo de dispositivos mediante el comando azsphere device-group create o utilizando device group - Create API.

Para crear un grupo de dispositivos:

azsphere device-group create --product <product-name> --name <device-group-name> --description <device-group-description>

Los nombres de los grupos de dispositivos solo pueden contener caracteres alfanuméricos y espacios. No pueden superar los 50 caracteres. Si el nombre o la descripción incluyen espacios, escríbalo entre comillas.

Puede incluir los siguientes parámetros opcionales:

  • --os-feed especifica el tipo de fuente del sistema operativo que se usará para las actualizaciones del sistema operativo.
  • --application-update establece la directiva de actualizaciones de aplicaciones para este grupo de dispositivos.

  1. Abre Azure Sphere Explorer.

  2. Para el inquilino que le interesa, expanda el nodo Producto.

  3. Para el producto que te interesa, haz clic con el botón derecho y selecciona Nuevo grupo de dispositivos.

  4. Especifique un nombre para el grupo de dispositivos y presione Entrar. Los nombres de los grupos de dispositivos solo pueden contener caracteres alfanuméricos y espacios. No pueden superar los 50 caracteres. Si especifica un nombre no válido, se notifica un error en la ventana salida .

Puedes crear un grupo de dispositivos en Visual Studio Code, pero no eliminarlo. Para eliminar un grupo de dispositivos, utilice el comando azsphere device-group delete o la API pública de Azure Sphere.

  1. Abre Azure Sphere Explorer.

  2. Para el inquilino que le interesa, expanda el nodo Producto.

  3. Para el producto que te interesa, haz clic con el botón derecho y selecciona Nuevo grupo de dispositivos.

  4. Especifique un nombre para el grupo de dispositivos y presione Entrar o haga clic en Aplicar. Los nombres de los grupos de dispositivos solo pueden contener caracteres alfanuméricos y espacios. No pueden superar los 50 caracteres. Si especifica un nombre no válido, se notifica un error en la ventana salida .

Puede crear un grupo de dispositivos en Visual Studio, pero no eliminarlo. Para eliminar productos, utilice el comando azsphere device-group delete o la API pública de Azure Sphere.

Actualizar el grupo de dispositivos

Puede modificar el nombre o la descripción de un grupo de dispositivos mediante el comando azsphere device-group update o mediante la API Device Group - Patch .

Para actualizar el nombre y la descripción de un grupo de dispositivos:

azsphere device-group update --device-group <device group ID or product-name/device-group-name> --new-name <new-device-group-name> --new-description <new-device-group-description>

También puede actualizar los os-feed parámetros y application-update mediante el comando azsphere device-group update .

  1. Abre Azure Sphere Explorer.

  2. Para el inquilino que le interesa, expanda el nodo Producto.

  3. Para el producto que te interesa, expande el nodo de producto para mostrar los grupos de dispositivos incluidos. Puedes cambiar el nombre del grupo de dispositivos o actualizar su descripción, el tipo de fuente del sistema operativo o la directiva de actualización:

  • Para cambiar el nombre de un grupo de dispositivos, haz clic con el botón derecho en el nombre del grupo de dispositivos y selecciona Cambiar nombre, escribe un nombre nuevo y, a continuación, presiona Entrar. Los nombres de los grupos de dispositivos solo pueden contener caracteres alfanuméricos y espacios. No pueden superar los 50 caracteres. Si especifica un nombre no válido, se notifica un error en la ventana salida .

  • Para actualizar la descripción del grupo de dispositivos, haga clic con el botón derecho en el nombre del grupo de dispositivos y seleccione Actualizar descripción, escriba una nueva descripción y, después, presione Entrar.

  • Para actualizar el tipo de fuente del sistema operativo, expanda el grupo de dispositivos, haga clic con el botón derecho en Tipo de fuente del SO, seleccione Actualizar y, después, elija Retail o RetailEval en el menú.

  • Para cambiar la directiva de actualización, expanda el grupo de dispositivos, haga clic con el botón derecho en Directiva de actualización, seleccione Actualizar y, después, elija No3rdPartyAppUpdates o UpdateAll en el menú. (La tercera opción, NoUpdates, está reservada actualmente para uso interno. Si elige esta opción, se notificará un error en la ventana Salida ).

Mueva un dispositivo a un grupo de dispositivos diferente mediante el comando azsphere device update o mediante la API Devices - Move .

  1. Abre Azure Sphere Explorer.

  2. Para el inquilino que le interesa, expanda el nodo Producto.

  3. Para el producto que te interesa, expande el nodo de producto para mostrar los grupos de dispositivos incluidos. Puedes cambiar el nombre del grupo de dispositivos o actualizar su descripción, el tipo de fuente del sistema operativo o la directiva de actualización:

  • Para cambiar el nombre de un grupo de dispositivos, selecciona el nombre del grupo de dispositivos y presiona F2 o haz clic con el botón derecho en el nombre del grupo de dispositivos y selecciona Cambiar nombre, escribe un nombre nuevo y, a continuación, presiona Entrar o haz clic en Aplicar. Los nombres de los grupos de dispositivos solo pueden contener caracteres alfanuméricos y espacios. No pueden superar los 50 caracteres. Si especifica un nombre no válido, se notifica un error en la ventana salida .

  • Para actualizar la descripción del grupo de dispositivos, expanda el grupo de dispositivos, seleccione Descripción y presione F2 o haga clic con el botón derecho en Descripción y seleccione Modificar, escriba una nueva descripción y, después, presione Entrar o haga clic en Aplicar.

  • Para actualizar el tipo de fuente del sistema operativo, expande el grupo de dispositivos, selecciona Tipo de fuente del SO y presiona F2 o haz clic con el botón derecho en Tipo de fuente de SO y selecciona Modificar, elige Retail o RetailEval en el menú y, a continuación, presiona Entrar o haz clic en Aplicar.

  • Para cambiar la directiva de actualización, expanda el grupo de dispositivos, seleccione Directiva de actualización y presione F2 o haga clic con el botón derecho en Actualizar directiva y seleccione Modificar, elija No3rdPartyAppUpdates o UpdateAll en el menú y, después, presione Entrar o haga clic en Aplicar. (La tercera opción, NoUpdates, está reservada actualmente para uso interno. Si elige esta opción, se notifica un error en la ventana salida ).

Mueva un dispositivo a un grupo de dispositivos diferente mediante el comando azsphere device update o mediante la API Devices - Move .

Mover un dispositivo a un grupo de dispositivos diferente

Mueva un dispositivo a un grupo de dispositivos diferente mediante el comando azsphere device update o mediante la API Devices - Move .

Especifique el id. de grupo de dispositivos o una combinación del nombre del producto y el nombre del grupo de dispositivos en el <formato product-name>/<device-group-name> :

azsphere device update --device-group <device-group-id>

azsphere device update --device-group <product-name/device-group-name>

Eliminar un grupo de dispositivos

Elimine un grupo de dispositivos especificado en su espacio empresarial de Azure Sphere mediante el comando azsphere device-group delete o mediante device group - Delete API.

Un grupo de dispositivos solo se puede eliminar cuando:

Especifique el id. de grupo de dispositivos o una combinación del nombre del producto y el nombre del grupo de dispositivos en el <formato product-name>/<device-group-name> :

azsphere device-group delete --device-group <device-group-id>

azsphere device-group delete --device-group <product-name/device-group-name>