Inquilino
Administra un inquilino de Azure Sphere.
Importante
Los comandos azsphere tenant download-ca-certificate, azsphere tenant download-ca-certificate-chainy azsphere tenant download-validation-certificate están obsoletos. Use azsphere ca-certificate download, azsphere ca-certificate download-chain, azsphere ca-certificate download-proofy azsphere ca-certificate list , en su lugar.
En la CLI de Azure Sphere, el inquilino predeterminado no se selecciona automáticamente cuando se crea un inquilino. Tiene que ejecutar el comando azsphere tenant select para seleccionar el inquilino predeterminado que se usará para el usuario actual en el equipo. De este modo, se garantiza que el espacio empresarial predeterminado sea el correcto al realizar una operación única que no se pueda deshacer, como reclamar el dispositivo.
| Operación | Descripción |
|---|---|
| Crear | Crea un nuevo espacio empresarial. |
| download-error-report | Devuelve información de error para los dispositivos del inquilino actual. |
| Lista | Enumera los inquilinos de Azure Sphere disponibles. |
| Seleccione | Selecciona el inquilino predeterminado de Azure Sphere que se usará en este equipo. |
| Mostrar seleccionado | Muestra el inquilino predeterminado de Azure Sphere para este equipo. |
| actualizar | Novedades los detalles del inquilino, como el nombre del inquilino. |
Crear
Crea un nuevo inquilino de Azure Sphere. Se requiere un dispositivo conectado para ejecutar este comando. Para obtener más información, consulte Crear un inquilino de Azure Sphere.
Si ya tiene un inquilino y está seguro de que desea otro, use el --force-additional parámetro. Actualmente, no puede eliminar un inquilino de Azure Sphere.
Una vez creado el inquilino, ejecute azsphere tenant select para seleccionar el inquilino predeterminado que se usará para el usuario actual en este equipo. Puede agregar roles para los usuarios en el inquilino actual de Azure Sphere mediante el comando azsphere role add .
El comando azsphere tenant create funciona con un dispositivo Azure Sphere conectado localmente. Si intentas el comando sin un dispositivo conectado, recibirás un error. El id. de dispositivo se registra al crear un inquilino y solo se puede crear un inquilino por dispositivo.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -n, --name | Cadena | Especifica un nombre para el espacio empresarial. Al asignar un nombre al inquilino, use caracteres alfanuméricos. No se permiten caracteres especiales. El nombre no debe superar los 50 caracteres y distingue mayúsculas de minúsculas. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -d, --device | Cadena | Especifica el dispositivo en el que ejecutar el comando cuando hay varios dispositivos conectados. Este parámetro es necesario cuando hay varios dispositivos conectados. El dispositivo conectado actualmente se usa de manera predeterminada. Puede especificar el Id. de dispositivo, la dirección IP o el Id. de conexión local del dispositivo adjunto. Azure Sphere CLI admite varios dispositivos MT3620 en Windows, pero solo puede conectar un dispositivo a la vez en Linux. Por este motivo, este parámetro es compatible con Windows, pero no con Linux. Se devuelve un error si utiliza este parámetro con el comando en Linux. |
| --force-additional | Booleana | Fuerza la creación de un nuevo inquilino de Azure Sphere. Use este comando solo si está seguro de que desea usar la cuenta actual para crear un nuevo espacio empresarial de Azure Sphere con el dispositivo adjunto. |
| --disable-confirm-prompt | Booleana | Deshabilita el mensaje de confirmación del usuario. |
Parámetros globales
Los siguientes parámetros globales están disponibles para la CLI de Azure Sphere:
| Parámetro | Descripción |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
azsphere tenant create --name MyTenant
Use los --force-additional parámetros y --disable-confirm-prompt si está seguro de que desea usar esta cuenta para crear un nuevo espacio empresarial de Azure Sphere con el dispositivo adjunto. Un dispositivo que se haya usado anteriormente para crear un inquilino de Azure Sphere no se puede usar para crear un nuevo inquilino.
azsphere tenant create --name MyTenant --force-additional
You have logged in with the following account:
bob@contoso.com
Do you want to use this account to create a new Azure Sphere tenant using the attached device?
You cannot change the tenant name 'MyTenant1' once it has been created.
Enter 'yes' to continue. Enter anything else to exit.
yes
> verbose: TraceId: c761ba73-761e-4df2-94f5-3f87384d71b7
Created a new Azure Sphere tenant:
--> Tenant Name: MyTenant1
--> Tenant ID: 768c2cd6-059a-49ad-9f53-89f5271cea15
Please use 'azsphere tenant select --tenant MyTenant' to select the created tenant.
Propina
Una vez que haya creado un inquilino, asegúrese de ejecutar azsphere tenant seleccione para seleccionar el inquilino predeterminado que se usará para el usuario actual en este equipo.
download-error-report
Devuelve información sobre los errores notificados por los dispositivos dentro del inquilino actual.
Este comando extrae los datos de eventos de la nube de Azure Sphere Security Service y no requiere una conexión física a un determinado dispositivo. El comando azsphere tenant download-error-report funciona en el contexto del inquilino actual y devuelve informes de errores para todos los dispositivos dentro de ese inquilino.
Nota
La descarga de los eventos notificados recientemente puede tardar hasta 24 horas. Para obtener más información, vea Recopilar e interpretar datos de error.
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| --Destino | Cadena | Especifica la ruta de acceso y el nombre de archivo del archivo de salida. |
| -t, --tenant | GUID o nombre | Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. 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 |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
azsphere tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
Lista
Enumera los inquilinos de Azure Sphere.
Parámetros globales
Los siguientes parámetros globales están disponibles para la CLI de Azure Sphere:
| Parámetro | Descripción |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
azsphere tenant list
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
Seleccione
Selecciona el inquilino predeterminado de Azure Sphere que se usará para el usuario actual en este equipo.
Para mostrar el inquilino predeterminado actual, use azsphere tenant show-selected.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -t, --tenant | GUID o nombre | Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. 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 |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
azsphere tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
Mostrar seleccionado
Muestra los detalles del inquilino predeterminado de Azure Sphere para el usuario actual en este equipo.
Este es el inquilino seleccionado con el comando azsphere tenant select .
Parámetros globales
Los siguientes parámetros globales están disponibles para la CLI de Azure Sphere:
| Parámetro | Descripción |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
azsphere tenant show-selected
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
actualizar
Novedades los detalles de un inquilino, como el nombre del inquilino.
Parámetros necesarios
| Parámetro | Tipo | Descripción |
|---|---|---|
| -n, --new-name | Cadena | Especifica un nombre nuevo para el inquilino. Al asignar un nombre al inquilino, use caracteres alfanuméricos. No se permiten caracteres especiales. El nombre no debe superar los 50 caracteres y distingue mayúsculas de minúsculas. |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
| -t, --tenant | GUID o nombre | Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. 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 |
|---|---|
| --Depuración | Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores. |
| -h, --help | Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles. |
| --only-show-errors | Solo muestra errores, suprimiendo las advertencias. |
| -o, --output | Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere. |
| --Consulta | Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos. |
| --Detallado | Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos. |
Nota
Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.
Ejemplo
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2 Administrator
Contributor
------------------------------------ --------------------- -------------
Propina
Si no ha seleccionado un inquilino predeterminado, se mostrará una lista de inquilinos disponibles. Para establecer el inquilino predeterminado, selecciona una de las opciones.