Quickstart: Choose a tenant and claim your device

Every device must be "claimed" into an Azure Sphere tenant. Claiming the device associates its unique, immutable device ID with your Azure Sphere tenant. The Azure Sphere Security Service uses the device ID to identify and authenticate the device.

Important

Currently, a few early Seeed Azure Sphere MT3620 Development Kits require a manual update. If you have a kit that has never been used, update the OS manually now so that you can log in, claim your device, and connect your device to the internet. If you have any other type of dev kit (including the Seeed MT3620 Mini Dev Board), or if you have already used your Seeed Azure Sphere MT3620 Development Kit, the OS will be updated as soon as you connect the device to the internet; manual update is not required.

Prerequisites

Sign in to Azure Sphere

  1. Connect your device over USB.

  2. Open a command prompt. On Windows, use an Azure Sphere Developer Command Prompt, which is available in the Start menu under Azure Sphere.

  3. Sign in to Azure Sphere, using a Microsoft account:

    azsphere login

    If you've never logged in to Azure Sphere before, add the --newuser parameter along with your Microsoft account email address:

    azsphere login --newuser <email-address>

Choose a tenant

After successful login, you'll need to choose an Azure Sphere tenant.

  • If you have access to a single tenant, it will be selected by default, and you can proceed to the next step.
  • If you don't have access to any tenants, you'll need to create a tenant.
  • If you have access to multiple tenants, you'll need to select one. See azsphere tenant select for details. After you select a tenant, proceed to the next step.

Important

Claiming is a one-time operation that you cannot undo even if the device is sold or transferred to another person or organization. A device can be claimed only once. Once claimed, the device is permanently associated with the Azure Sphere tenant.

Claim the device

Claim your device. After you claim your device into a tenant, you cannot move it to a different tenant.

azsphere device claim

You should see output like this:

Claiming device.

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

Command completed successfully in 00:00:05.5459143.

Next steps