Gestire i tenant
Importante
Questa è la documentazione di Azure Sphere (legacy). Azure Sphere (legacy) viene ritirato il 27 settembre 2027 e gli utenti devono eseguire la migrazione ad Azure Sphere (integrato) entro questo periodo. Usare il selettore di versione posizionato sopra il sommario per visualizzare la documentazione di Azure Sphere (integrata).
Un tenant di Azure Sphere offre alla tua organizzazione un modo sicuro per gestire in modalità remota i rispettivi dispositivi di Azure Sphere in isolamento rispetto ai dispositivi degli altri clienti. L'organizzazione deve creare un tenant di Azure Sphere e quindi rivendicare ogni dispositivo in tale tenant, in modo che sia possibile gestire tali dispositivi in modalità remota e sicura.
Prerequisiti
- Installare Azure Sphere SDK per Windows o per Linux.
- È necessario disporre di un dispositivo non reclamato che non è stato usato in precedenza per creare un tenant.
Creare un tenant di Azure Sphere
Un tenant di Azure Sphere isola i dispositivi Azure Sphere e offre un modo per organizzare e distribuire applicazioni. All'account che crea il tenant viene assegnato automaticamente il ruolo di amministratore per il tenant.
Suggerimento
- Dopo aver creato un tenant, non può essere eliminato e non è possibile eseguire la migrazione dei dispositivi tra tenant. Se il team o l'organizzazione ha già un tenant di Azure Sphere, prendere in considerazione la possibilità di richiedere l'accesso anziché creare un tenant aggiuntivo.
Per creare un tenant di Azure Sphere:
Collegare un dispositivo Azure Sphere al computer tramite USB.
Aprire un'interfaccia della riga di comando di Azure Sphere usando PowerShell, il prompt dei comandi di Windows o la shell dei comandi Linux.
Accedere all'interfaccia della riga di comando seguendo le istruzioni riportate qui.
Per creare il tenant, immettere il comando seguente:
azsphere tenant create --name <tenant-name or tenant-ID>Sostituire <tenant-name> con un nome che altri utenti possono riconoscere, ad esempio "Contoso Ltd" o "Contoso Lavastoviglie Divisione". Quando si assegna un nome al tenant, usare solo caratteri alfanumerici e spazi. Se si includono spazi, racchiudere il nome tra virgolette. Il nome non deve iniziare con uno spazio o superare i 50 caratteri. I caratteri speciali non sono consentiti. I nomi fanno distinzione tra maiuscole e minuscole.
Quando si crea un tenant, il servizio di sicurezza di Azure Sphere registra l'ID del dispositivo collegato. Ogni ID dispositivo può essere usato per creare un solo tenant Azure Sphere.
Se l'account ha già accesso a un tenant di Azure Sphere, il comando avrà esito negativo, avvisando di usare il tenant esistente. Se si è certi di voler creare un nuovo tenant, è possibile usare il --force-additional parametro per forzare la creazione di un nuovo tenant di Azure Sphere.
Il comando azsphere tenant create crea un tenant ma non richiede il dispositivo nel tenant. Per altre informazioni, vedere Richiedere il dispositivo.
Per creare un tenant usando l'API, usare l'operazione Tenant - Crea .
Mostra e seleziona tenant predefinito
Eseguire azsphere tenant show-selected per verificare che il tenant selezionato debba essere usato come predefinito in questo PC.
Per modificare o selezionare il tenant predefinito, eseguire azsphere tenant select.
Suggerimento
Se si esegue di nuovo l'accesso e si accede di nuovo al servizio di sicurezza di Azure Sphere, è possibile che venga richiesto di selezionare il tenant predefinito. Assicurarsi di accedere con l'account che si vuole usare per gestire i dispositivi Azure Sphere.
Elencare i tenant
È possibile elencare i tenant di Azure Sphere disponibili usando le opzioni seguenti:
Eseguire il comando seguente per elencare i tenant di Azure Sphere disponibili.
azsphere tenant list
Per elencare un tenant usando l'API, usare l'operazione Tenant - Get .
Per elencare i tenant in Visual Studio Code:
Selezionare l'icona Esplora Azure Sphere nella barra delle attività di Visual Studio Code per aprire Esplora Azure Sphere.
Se nel riquadro Tenant viene visualizzato Accedi per visualizzare i tenant, accedere ad Azure Sphere e selezionare Aggiorna per visualizzare i tenant disponibili.
Aggiornare un tenant esistente
È possibile usare l'interfaccia della riga di comando di Azure Sphere o l'API pubblica di Azure Sphere per rinominare un tenant di Azure Sphere esistente. 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.
Per aggiornare un tenant usando l'interfaccia della riga di comando, eseguire il comando :
azsphere tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
Suggerimento
È possibile che venga visualizzato un messaggio se il tenant predefinito non è selezionato. Selezionare il tenant richiesto dall'elenco e riprovare a eseguire il comando.
Per aggiornare un tenant usando l'API, usare l'operazione Tenant - Patch .
Scaricare il report degli errori per il tenant
Per ottenere report sugli errori per tutti i dispositivi all'interno di un tenant, usare il comando azsphere tenant download-error-report.