Inquilino
Gestisce un tenant azure sphere.
Importante
I comandi azsphere tenant download-ca-certificate
, azsphere tenant download-ca-certificate-chain
e azsphere tenant download-validation-certificate
sono obsoleti. Usare azsphere ca-certificate download
, azsphere ca-certificate download-chain
, azsphere ca-certificate download-proof
e azsphere ca-certificate list
.
Nell'azure sphere CLI, il tenant predefinito non viene selezionato automaticamente quando viene creato un tenant. È necessario eseguire il comando di selezione tenant azsfera per selezionare il tenant predefinito da usare per l'utente corrente nel PC. Questo per garantire che il tenant predefinito sia quello corretto da usare quando si esegue un'operazione una tantum che non è possibile annullare, come richiedere il dispositivo.
Operazione | Descrizione |
---|---|
Creare | Crea un nuovo tenant. |
download-error-report | Restituisce le informazioni sull'errore per i dispositivi all'interno del tenant corrente. |
Elenco | Elenca i tenant di Azure Sphere disponibili. |
Selezionare | Seleziona il tenant azure sphere predefinito da usare in questo computer. |
mostra-selezionato | Mostra il tenant azure sphere predefinito per questo computer. |
Aggiornamento | Aggiornamenti i dettagli del tenant, ad esempio il nome del tenant. |
Creare
Crea un nuovo tenant azure sphere. Per eseguire questo comando è necessario un dispositivo collegato. Per altre informazioni, vedere Creare un tenant azure sphere.
Se si ha già un tenant e si è certi di averne un altro, usare il --force-additional
parametro. Attualmente, non è possibile eliminare un tenant di Azure Sphere.
Dopo aver creato il tenant, eseguire il tenant azsfera selezionare per selezionare il tenant predefinito da usare per l'utente corrente in questo PC. È possibile aggiungere ruoli per gli utenti nel tenant Azure Sphere corrente usando il comando aggiungi ruolo azsfera .
Il comando di creazione tenant azsfera funziona con un dispositivo Azure Sphere collegato localmente. Se tenti di eseguire il comando senza un dispositivo collegato, riceverai un errore. L'ID dispositivo viene registrato quando crei un tenant e puoi creare un solo tenant per ogni dispositivo.
Parametri obbligatori
Parametro | Digitare | Descrizione |
---|---|---|
-n, --name | Stringa | Specifica un nome per il tenant. Quando si assegna un nome al tenant, usare caratteri alfanumerici. I caratteri speciali non sono consentiti. Il nome non deve superare i 50 caratteri e fa distinzione tra maiuscole e minuscole. |
Parametri facoltativi
Parametro | Digitare | Descrizione |
---|---|---|
-d, --device | Stringa | Specifica il dispositivo su cui eseguire il comando quando sono collegati più dispositivi. Questo parametro è obbligatorio quando sono collegati più dispositivi. Il dispositivo attualmente collegato viene utilizzato per impostazione predefinita. È possibile specificare l'ID dispositivo, l'indirizzo IP o l'ID connessione locale del dispositivo collegato. Azure Sphere CLI supporta più dispositivi MT3620 in Windows, ma puoi connettere un solo dispositivo alla volta su Linux. Per questo motivo, questo parametro è supportato per Windows ma non per Linux. Se si usa questo parametro con il comando su Linux, viene restituito un errore. |
--force-additional | Boolean | Forza la creazione di un nuovo tenant azure sphere. Usare questo comando solo se si è certi di voler usare l'account corrente per creare un nuovo tenant Azure Sphere usando il dispositivo collegato. |
--disable-confirm-prompt | Boolean | Disabilita la richiesta di conferma dell'utente. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
Parametro | Descrizione |
---|---|
--debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
-h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
--only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
-o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
--Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
--Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.
Esempio
azsphere tenant create --name MyTenant
Usa i --force-additional
parametri e --disable-confirm-prompt
se sei certo di voler usare questo account per creare un nuovo tenant Azure Sphere usando il dispositivo collegato. Un dispositivo usato in precedenza per creare un tenant Azure Sphere non può essere usato per creare un nuovo tenant.
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.
Mancia
Dopo aver creato un tenant, assicurarsi di eseguire il tenant azsfera selezionare per selezionare il tenant predefinito da usare per l'utente corrente in questo PC.
download-error-report
Restituisce informazioni sugli errori segnalati dai dispositivi all'interno del tenant corrente.
Questo comando recupera i dati degli eventi dal cloud Azure Sphere Security Service e non richiede una connessione fisica a un dispositivo specifico. Il comando azsfera tenant download-error-report funziona nel contesto del tenant corrente e restituisce le segnalazioni di errori per tutti i dispositivi all'interno di tale tenant.
Nota
Potrebbero essere richieste fino a 24 ore prima che gli eventi segnalati di recente siano disponibili per il download. Per altre informazioni, vedere Raccogliere e interpretare i dati degli errori.
Parametri facoltativi
Parametro | Digitare | Descrizione |
---|---|---|
--Destinazione | Stringa | Specifica il percorso e il nome file del file di output. |
-t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
Parametro | Descrizione |
---|---|
--debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
-h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
--only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
-o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
--Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
--Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.
Esempio
azsphere tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
Elenco
Elenca i tenant di Azure Sphere.
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
Parametro | Descrizione |
---|---|
--debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
-h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
--only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
-o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
--Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
--Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.
Esempio
azsphere tenant list
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
Selezionare
Seleziona il tenant Azure Sphere predefinito da usare per l'utente corrente in questo PC.
Per visualizzare il tenant predefinito corrente, usare il tenant azsfera mostra-selezionato.
Parametri obbligatori
Parametro | Digitare | Descrizione |
---|---|---|
-t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
Parametro | Descrizione |
---|---|
--debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
-h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
--only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
-o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
--Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
--Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.
Esempio
azsphere tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
mostra-selezionato
Visualizza i dettagli del tenant Azure Sphere predefinito per l'utente corrente in questo PC.
Questo è il tenant selezionato con il comando di selezione tenant azsfera .
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
Parametro | Descrizione |
---|---|
--debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
-h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
--only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
-o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
--Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
--Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.
Esempio
azsphere tenant show-selected
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
Aggiornamento
Aggiornamenti i dettagli di un tenant, ad esempio il nome del tenant.
Parametri obbligatori
Parametro | Digitare | Descrizione |
---|---|---|
-n, --new-name | Stringa | Specifica un nuovo nome per il tenant. Quando si assegna un nome al tenant, usare caratteri alfanumerici. I caratteri speciali non sono consentiti. Il nome non deve superare i 50 caratteri e fa distinzione tra maiuscole e minuscole. |
Parametri facoltativi
Parametro | Digitare | Descrizione |
---|---|---|
-t, --tenant | GUID o nome | Specifica il tenant in cui eseguire questa operazione. Sostituisce il tenant selezionato predefinito. È possibile specificare l'ID tenant o il nome del tenant. |
Parametri globali
Per Azure Sphere CLI sono disponibili i seguenti parametri globali:
Parametro | Descrizione |
---|---|
--debug | Aumenta il livello di dettaglio della registrazione per visualizzare tutti i log di debug. Se trovi un bug, fornisci l'output generato con il --debug flag attivato quando invii una segnalazione di bug. |
-h, --help | Stampa informazioni di riferimento CLI sui comandi e sui relativi argomenti ed elenchi di sottogruppi e comandi disponibili. |
--only-show-errors | Mostra solo gli errori, eliminando gli avvisi. |
-o, --output | Cambia il formato di output. I formati di output disponibili sono json, jsonc (JSON colorato), tsv (valori separati da tabulazione), tabella (tabelle ASCII leggibili dall'uomo) e yaml. Per impostazione predefinita, l'output CLI .table Per altre informazioni sui formati di output disponibili, vedi Formato di output per i comandi CLI di Azure Sphere. |
--Query | Usa il linguaggio di query JMESPath per filtrare l'output restituito da Azure Sphere Security Services. Per altre informazioni ed esempi, vedere l'esercitazione su JMESPath e l'output del comando CLI di Azure query. |
--Dettagliato | Consente di stampare informazioni sulle risorse create in Azure Sphere durante un'operazione e altre informazioni utili. Da usare --debug per i log di debug completi. |
Nota
Se si usa la cli classica di Azure Sphere, vedere Parametri globali per ulteriori informazioni sulle opzioni disponibili.
Esempio
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2 Administrator
Contributor
------------------------------------ --------------------- -------------
Mancia
Se non è stato selezionato un tenant predefinito, viene visualizzato un elenco di tenant disponibili. Impostare il tenant predefinito selezionando una delle opzioni.