Administración de productos
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).
Un producto identifica una MCU de Azure Sphere que se incorpora a un dispositivo conectado para realizar una función específica. Como fabricante, se crea un producto para cada modelo de un dispositivo conectado, como un lavavajillas o cafetera. Por ejemplo, Contoso crea un producto para su lavavajillas DW100 y asigna este producto a cada lavavajillas DW100 durante la fabricación. Cada producto tiene un GUID que es único dentro del inquilino y no se puede cambiar.
Cada dispositivo conectado tiene un solo producto, pero un solo producto puede asociarse con muchos dispositivos. Cada producto tiene un nombre que debe ser único dentro de su inquilino, junto con una descripción. El nombre y la descripción del producto proporcionan al usuario una manera fácil de distinguir un producto de otro. El nombre y la descripción del producto se pueden modificar tantas veces como se desee.
Enumerar productos
Enumere todos los productos del inquilino de Azure Sphere mediante el comando azsphere product list o mediante la API pública de Azure Sphere.
Para enumerar todos los productos:
azsphere product list
Se puede mostrar un mensaje si el inquilino predeterminado no está seleccionado. Seleccione el inquilino necesario en la lista y vuelva a intentarlo.
Para enumerar todos los productos de un inquilino de Azure Sphere:
Seleccione el icono explorador de Azure Sphere en la barra de actividades de Visual Studio Code para abrir el Explorador de Azure Sphere. Si el panel Inquilino muestra Iniciar sesión para ver inquilinos, inicie sesión en Azure Sphere y seleccione Actualizar para ver los inquilinos disponibles.
Expanda el inquilino que le interesa.
Expanda el nodo del producto.
Seleccione Ver>otro Explorador de Windows>Azure Sphere para abrir el Explorador de Azure Sphere. Si el panel Inquilino muestra Iniciar sesión para ver inquilinos, inicie sesión en Azure Sphere y seleccione Actualizar para ver los inquilinos disponibles.
Expanda el inquilino que le interesa.
Expanda el nodo del producto.
Crear un producto
Cree un producto en el inquilino de Azure Sphere mediante el comando azsphere product create o mediante la API pública de Azure Sphere.
Para crear un producto:
azsphere product create --name <product-name>
Reemplace <product-name> por un nombre legible para el producto, como DW100. Los nombres de los productos 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.
De forma predeterminada, al crear un nuevo producto, Azure Sphere crea automáticamente cinco grupos de dispositivos para su uso en la creación de implementaciones. Los cinco grupos de dispositivos predeterminados son Development, Field Test, Production, Field Test OS Evaluation y Production OS Evaluation. Para crear el producto sin los grupos de dispositivos predeterminados, use el comando :
azsphere product create --name <product-name> --no-default-device-groups
Un inquilino puede contener muchos productos, puede ser útil proporcionar una descripción de cada uno de ellos. Puede agregar una descripción a un producto de la siguiente manera:
azsphere product create --name <product-name> --description <product-description>
Para crear un producto:
Abra el Explorador de Azure Sphere.
Para el inquilino que le interesa, haga clic con el botón derecho en el nodo Producto y seleccione Nuevo producto.
Especifique un nombre para el producto y presione Entrar. Los nombres de los productos 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 .
Al crear un producto en el Explorador de Azure Sphere, se crean automáticamente los cinco grupos de dispositivos predeterminados. Si desea crear un producto sin grupos de dispositivos, use el comando azsphere product create o la API pública de Azure Sphere y especifique --no-default-device-groups.
Puede crear un producto en el Explorador de Azure Sphere, pero no eliminarlo. Para eliminar productos, use el comando azsphere product delete o la API pública de Azure Sphere.
Para crear un producto:
Abra el Explorador de Azure Sphere.
Para el inquilino que le interesa, haga clic con el botón derecho en el nodo Producto y seleccione Nuevo producto.
Especifique un nombre para el producto y presione Entrar o haga clic en Aplicar. Los nombres de los productos 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 .
Al crear un producto en el Explorador de Azure Sphere, se crean automáticamente los cinco grupos de dispositivos predeterminados. Si desea crear un producto sin grupos de dispositivos, use el comando azsphere product create o la API pública de Azure Sphere y especifique --no-default-device-groups.
Puede crear un producto en el Explorador de Azure Sphere, pero no eliminarlo. Para eliminar productos, use el comando azsphere product delete o la API pública de Azure Sphere.
actualización de un producto
Modifique el nombre o la descripción de un producto en cualquier momento mediante el comando azsphere product update o mediante la API pública de Azure Sphere. Para actualizar el nombre y la descripción de un producto:
azsphere product update --product <product-name> --new-name <new-product-name> --new-description <new-product-description>
Eliminar un producto
Elimine un producto en cualquier momento mediante el comando azsphere product delete o mediante la API pública de Azure Sphere.
Un producto solo se puede eliminar cuando:
- El usuario tiene permisos de administrador para el inquilino.
- El producto está vacío y los grupos de dispositivos no tienen ningún dispositivo en él. El comando azsphere product device list enumera todos los dispositivos de un producto. Ejecute azsphere device update --device-group para mover el dispositivo a otro grupo de dispositivos o azsphere device-group delete para eliminar un grupo de dispositivos.
Para eliminar un producto:
azsphere product delete --product <product-name>
Abra el Explorador de Azure Sphere.
Para el inquilino que le interesa, expanda el nodo Producto.
Para cambiar el nombre del producto, haga clic con el botón derecho en el nombre del producto y seleccione Cambiar nombre, especifique un nuevo nombre de producto y presione Entrar.
Para actualizar la descripción, haga clic con el botón derecho en el nombre del producto y seleccione Actualizar descripción, especifique una nueva descripción y presione Entrar.
Abra el Explorador de Azure Sphere.
Para el inquilino que le interesa, expanda el nodo Producto.
Para cambiar el nombre del producto, seleccione el nombre del producto y presione F2 o haga clic con el botón derecho en el nombre del producto y seleccione Cambiar nombre, especifique un nuevo nombre de producto y presione Entrar o haga clic en Aplicar.
Para actualizar la descripción, expanda el producto, seleccione Descripción y presione F2 o haga clic con el botón derecho en Descripción y seleccione Modificar, especifique una nueva descripción y presione Entrar o haga clic en Aplicar.
Mostrar detalles del producto
Vea los detalles de un producto del inquilino mediante el comando azsphere product show o mediante la API pública de Azure Sphere.
azsphere product show --product <product-name>
Para ver los detalles de un producto en el inquilino:
Seleccione el icono explorador de Azure Sphere en la barra de actividades de Visual Studio Code para abrir el Explorador de Azure Sphere. Si el panel Inquilino muestra Iniciar sesión para ver inquilinos, inicie sesión en Azure Sphere y seleccione Actualizar para ver los inquilinos disponibles.
Para el inquilino que le interesa, expanda el nodo Producto.
Expanda el producto que le interesa.
Seleccione Ver>otro Explorador de Windows>Azure Sphere para abrir el Explorador de Azure Sphere. Si el panel Inquilino muestra Iniciar sesión para ver inquilinos, inicie sesión en Azure Sphere y seleccione Actualizar para ver los inquilinos disponibles.
Para el inquilino que le interesa, expanda el nodo Producto.
Expanda el producto que le interesa.