Creare un tenant di Azure SphereCreate an Azure Sphere tenant

Un tenant Azure Sphere isola i dispositivi Azure Sphere e fornisce un modo per organizzare e distribuire le applicazioni.An Azure Sphere tenant isolates your Azure Sphere devices and provides a way for you to organize and deploy applications. Il tenant di Azure Sphere viene usato solo per Azure Sphere.The Azure Sphere tenant is used only for Azure Sphere.

Importante

Se il team o l'organizzazione ha già un tenant di Azure Sphere, valutare se richiedere l'accesso al tenant invece di crearne uno aggiuntivo.If your team or organization already has an Azure Sphere tenant, consider whether to ask for access to this tenant rather than creating an additional tenant. Dopo aver creato un tenant, non è possibile eliminarlo o spostarlo in un'altra sottoscrizione di Azure, se è associato a uno di essi.Once you create a tenant, you cannot delete it or move it to a different Azure subscription, if it's associated with one. Ogni ID dispositivo può essere usato per creare un solo tenant Azure Sphere.Each device ID can be used to create only one Azure Sphere tenant.

All'account che crea il tenant viene assegnato automaticamente il ruolo di amministratore per il tenant.The account that creates the tenant is automatically assigned the role of administrator for the tenant.

PrerequisitiPrerequisites

  • Guida introduttiva: installare Azure Sphere SDK per Windows o per Linux.Quickstart: Install the Azure Sphere SDK for Windows or for Linux.
  • Per creare un tenant, è necessario disporre di un dispositivo non reclamato che non è stato usato in precedenza per creare un tenant.To create a tenant, you must have an unclaimed device that has not previously been used to create a tenant.

Creare un nuovo tenant Azure SphereCreate a new Azure Sphere tenant

Se la schermata di accesso ad Azure Sphere indica che non si ha accesso a un tenant di Azure Sphere, è possibile crearne uno:If your Azure Sphere login indicates that you have no access to an Azure Sphere tenant, you can create one:

  1. Collegare un dispositivo Azure Sphere al computer tramite USB.Connect an Azure Sphere device to your computer by USB.

  2. Aprire un'interfaccia della riga di comando usando PowerShell, il prompt dei comandi di Windows o la shell dei comandi Linux e immettere il comando seguente:Open a command-line interface using PowerShell, Windows command prompt, or Linux command shell and enter the following command:

    azsphere tenant create --name <tenant-name>

    Sostituire <tenant-name> con un nome riconoscibile da altri utenti, ad esempio "Contoso Ltd" o "contoso lavastoviglie Division".Replace <tenant-name> with a name that other users will recognize, such as "Contoso Ltd" or "Contoso Dishwasher Division." Se il nome include degli spazi, racchiuderlo tra virgolette.If the name includes spaces, enclose it in quotation marks. I nomi devono essere costituiti solo da caratteri alfanumerici senza simboli.Names must be all alphanumeric characters with no symbols.

  3. Una volta creato il tenant, eseguire azsphere tenant Select per selezionare il tenant predefinito da usare per l'utente corrente nel computer.Once the tenant is created, run azsphere tenant select to select the default tenant to use for the current user on this PC.

Suggerimento

Esegui azsphere tenant Show-selezionato per verificare che il tenant selezionato venga usato come impostazione predefinita nel computer.Run azsphere tenant show-selected to verify that the selected tenant should be used as the default on this PC.

Verrà richiesto di eseguire di nuovo l'accesso se si è connessi. Assicurarsi di accedere con l'account che verrà usato per gestire i dispositivi Azure Sphere.You are prompted to sign in again if you are signed out. Be sure to sign in with the account that you will use to manage your Azure Sphere devices.

Rinominare un tenant esistenteRename an existing tenant

È possibile usare l'API Azure Sphere pubblico per rinominare un tenant di Azure Sphere esistente.You can use the Azure Sphere public API to rename an existing Azure Sphere tenant. L'API usa il protocollo HTTP REST per richiedere e ricevere dati in formato JSON.The API uses REST HTTP protocol to request and receive data in JSON format.

Per ulteriori informazioni sulle regole di denominazione, vedere l' Azure Sphere API pubblica.For more information about naming rules, see the Azure Sphere Public API.

Richiedere un dispositivoClaim a device

Il comando azsphere tenant create crea un tenant, ma non lo richiede al tenant.The azsphere tenant create command creates a tenant but does not claim the device into the tenant.

Per richiedere un dispositivo, registrare il nome utente usato per richiedere il dispositivo e il tenant in cui è stato richiesto.To claim a device, record the username you use to claim the device and the tenant you claim it into. Quando si reclama il dispositivo in un tenant, non è possibile spostarlo in un tenant diverso.After you claim your device into a tenant, you cannot move it into a different tenant.

azsphere device claim

Verrà visualizzato un output simile al seguente:You should see output like this:

Claiming device.
Successfully claimed device ID '<device ID>' into tenant '<name>' with ID 'd343c263-4aa3-4558-adbb-d3fc34631800'.

Per altre informazioni, vedere richiedere il dispositivo.For more information, see Claim your device.

Quando si crea un tenant, il servizio di sicurezza di Azure Sphere registra l'ID del dispositivo collegato.When you create a tenant, the Azure Sphere Security Service records the device ID of the attached device. Ogni ID dispositivo può essere usato per creare un solo tenant Azure Sphere.Each device ID can be used to create only one Azure Sphere tenant.

Se si ha già accesso a un tenant e si è certi che si vuole usare questo account per creare un nuovo tenant di Azure Sphere usando il dispositivo collegato, usare il --force parametro nel comando azsphere tenant create--Force--Name <tenant-name> .If you already have access to a tenant, and are certain that you want to use this account to create a new Azure Sphere tenant using the attached device, use the --force parameter in the azsphere tenant create --force --name <tenant-name> command. Una volta creato il tenant, eseguire azsphere tenant Select per selezionare il tenant predefinito da usare per l'utente corrente nel computer.Once the tenant is created, run azsphere tenant select to select the default tenant to use for the current user on this PC.

Suggerimento

Esegui azsphere tenant Show-selezionato per verificare che il tenant selezionato venga usato come impostazione predefinita nel computer.Run azsphere tenant show-selected to verify that the selected tenant should be used as the default on this PC.

Vedi ancheSee also

Informazioni sui tenantAbout tenants

tenant di azsphereazsphere tenant