Compartir a través de


Administrar grupos de dispositivos

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

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

Enumeración de grupos de dispositivos

Enumere todos los grupos de dispositivos del inquilino de Azure Sphere mediante el comando azsphere device-group list o mediante device Group - List API.

Para enumerar todos los grupos de dispositivos:

azsphere device-group list

Enumere los grupos de dispositivos de un producto específico mediante el comando azsphere product device-group list o mediante product - List Groups API.

azsphere product device-group list --product <product-name>
  1. Abra el Explorador de Azure Sphere.

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

  1. Abra el Explorador de Azure Sphere.

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

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

  1. Abra el Explorador de Azure Sphere.

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

Si no aparece ningún producto, cree un producto.

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

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

  1. Abra el Explorador de Azure Sphere.

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

Si no aparece ningún producto, cree un producto.

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

Creación de un grupo de dispositivos

Cree un grupo de dispositivos mediante el comando azsphere device-group create o mediante 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 y espacios alfanuméricos. 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 va a usar para las actualizaciones del sistema operativo.
  • --application-update establece la directiva de actualizaciones de aplicaciones para este grupo de dispositivos.
  1. Abra el Explorador de Azure Sphere.

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

  3. Para el producto que le interesa, haga clic con el botón derecho y seleccione 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 y espacios alfanuméricos. 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 Code, pero no eliminarlo. Para eliminar un grupo de dispositivos, use el comando azsphere device-group delete o la API pública de Azure Sphere.

  1. Abra el Explorador de Azure Sphere.

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

  3. Para el producto que le interesa, haga clic con el botón derecho y seleccione 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 y espacios alfanuméricos. 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, use el comando azsphere device-group delete o la API pública de Azure Sphere.

Actualización del 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 device Group - Patch API.

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 parámetros y mediante el comando azsphere device-group update.application-update os-feed

  1. Abra el Explorador de Azure Sphere.

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

  3. Para el producto que le interesa, expanda el nodo del producto para mostrar sus grupos de dispositivos incluidos. Puede 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, haga clic con el botón derecho en el nombre del grupo de dispositivos y seleccione Cambiar nombre, escriba un nombre nuevo y presione Entrar. Los nombres de los grupos de dispositivos solo pueden contener caracteres y espacios alfanuméricos. 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 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 sistema operativo, seleccione Actualizar y, a continuación, 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 Actualizar directiva, seleccione Actualizar y, a continuación, elija No3rdPartyAppUpdates o UpdateAll en el menú. (La tercera opción, NoUpdates está reservado actualmente para uso interno. Si elige esta opción, se notifica un error en la ventana Salida ).

Mueva un dispositivo a otro grupo de dispositivos mediante el comando azsphere device update o mediante devices - Move API.

  1. Abra el Explorador de Azure Sphere.

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

  3. Para el producto que le interesa, expanda el nodo del producto para mostrar sus grupos de dispositivos incluidos. Puede 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, seleccione el nombre del grupo de dispositivos y presione F2 o haga clic con el botón derecho en el nombre del grupo de dispositivos y seleccione Cambiar nombre, escriba un nombre nuevo y presione Entrar o haga clic en Aplicar. Los nombres de los grupos de dispositivos solo pueden contener caracteres y espacios alfanuméricos. 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 presione Entrar o haga clic en Aplicar.

  • Para actualizar el tipo de fuente del sistema operativo, expanda el grupo de dispositivos, seleccione Tipo de fuente del sistema operativo y presione F2 o haga clic con el botón derecho en Tipo de fuente del sistema operativo y seleccione Modificar, elija Retail o RetailEval en el menú y, a continuación, presione Entrar o haga clic en Aplicar.

  • Para cambiar la directiva de actualización, expanda el grupo de dispositivos, seleccione Actualizar directiva 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, a continuación, presione Entrar o haga clic en Aplicar. (La tercera opción, NoUpdates está reservado actualmente para uso interno. Si elige esta opción, se notifica un error en la ventana Salida .

Mueva un dispositivo a otro grupo de dispositivos mediante el comando azsphere device update o mediante devices - Move API.

Mover un dispositivo a otro grupo de dispositivos

Mueva un dispositivo a otro grupo de dispositivos mediante el comando azsphere device update o mediante devices - Move API.

Especifique el identificador del 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>

Eliminación de un grupo de dispositivos

Elimine un grupo de dispositivos especificado en el inquilino de Azure Sphere mediante el comando azsphere device-group delete o mediante la API Device Group - Delete.

Un grupo de dispositivos solo se puede eliminar cuando:

Especifique el identificador del 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>