Administración de inquilinos
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 inquilino de Azure Sphere ofrece una forma segura de que la organización administre de forma remota sus dispositivos de Azure Sphere aisladamente de los dispositivos de otros clientes. La organización debe crear un inquilino de Azure Sphere y, después, reclamar cada uno de sus dispositivos en ese inquilino, de forma que pueda administrarlos de forma remota y segura.
Requisitos previos
- Instale el SDK de Azure Sphere para Windows o para Linux.
- Debe tener un dispositivo no reclamado que no se haya usado anteriormente para crear un inquilino.
Crear un inquilino de Azure Sphere
Un inquilino de Azure Sphere aísla los dispositivos de Azure Sphere y proporciona una manera de organizar e implementar aplicaciones. A la cuenta que crea el inquilino se le asigna automáticamente el rol de administrador para el inquilino.
Sugerencia
- Una vez creado un inquilino, no se puede eliminar y los dispositivos no se pueden migrar entre inquilinos. Si su equipo u organización ya tiene un inquilino de Azure Sphere, considere la posibilidad de solicitar acceso a él en lugar de crear un inquilino adicional.
Para crear un inquilino de Azure Sphere:
Conecte el dispositivo de Azure Sphere al equipo mediante USB.
Abra una CLI de Azure Sphere mediante PowerShell, el símbolo del sistema de Windows o el shell de comandos de Linux.
Inicie sesión en la CLI siguiendo las instrucciones que se indican aquí.
Para crear el inquilino, escriba el siguiente comando:
azsphere tenant create --name <tenant-name or tenant-ID>Reemplace <tenant-name> por un nombre que otros usuarios puedan reconocer, como "Contoso Ltd" o "Contoso Lavavajillas Division". Al asignar un nombre al inquilino, use solo caracteres alfanuméricos y espacios. Si incluye espacios, escriba el nombre entre comillas. El nombre no debe comenzar con un espacio ni superar los 50 caracteres. No se aceptan caracteres especiales. Los nombres distinguen mayúsculas de minúsculas.
Cuando se crea un inquilino, Azure Sphere Security Service registra el identificador del dispositivo conectado. Cada identificador de dispositivo puede usarse para crear solo un inquilino de Azure Sphere.
Si la cuenta ya tiene acceso a un inquilino de Azure Sphere, se producirá un error en el comando, lo que le aconsejará que use el inquilino existente. Si está seguro de que desea crear un nuevo inquilino, puede usar el --force-additional parámetro para forzar la creación de un nuevo inquilino de Azure Sphere.
El comando azsphere tenant create crea un inquilino, pero no reclama el dispositivo en el inquilino. Para obtener más información, consulte Notificación del dispositivo.
Para crear un inquilino mediante la API, use la operación Tenants - Create .
Mostrar y seleccionar el inquilino predeterminado
Ejecute azsphere tenant show-selected para comprobar que el inquilino seleccionado debe usarse como valor predeterminado en este equipo.
Para modificar o seleccionar el inquilino predeterminado, ejecute azsphere tenant select.
Sugerencia
Si cierra sesión e inicia sesión de nuevo en el servicio de seguridad de Azure Sphere, es posible que se le pida que seleccione el inquilino predeterminado. Asegúrese de iniciar sesión con la cuenta que desea usar para administrar los dispositivos de Azure Sphere.
Enumera los inquilinos.
Puede enumerar los inquilinos de Azure Sphere disponibles mediante las siguientes opciones:
Ejecute el siguiente comando para enumerar los inquilinos de Azure Sphere disponibles.
azsphere tenant list
Para enumerar un inquilino mediante la API, use la operación Tenants - Get .
Actualización de un inquilino existente
Puede usar la CLI de Azure Sphere o la API pública de Azure Sphere para cambiar el nombre de un inquilino de Azure Sphere existente. Al asignar un nombre a su inquilino, utilice caracteres alfanuméricos. No se aceptan caracteres especiales. El nombre no debe superar los 50 caracteres y distingue mayúsculas de minúsculas.
Para actualizar un inquilino mediante la CLI, ejecute el comando :
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
Sugerencia
Se puede mostrar un mensaje si el inquilino predeterminado no está seleccionado. Seleccione el inquilino necesario en la lista y vuelva a intentarlo.
Para actualizar un inquilino mediante la API, use la operación Tenants - Patch .
Descarga del informe de errores para el inquilino
Para obtener informes de errores para todos los dispositivos de un inquilino, use el comando azsphere tenant download-error-report.