Connect a Microsoft account

Important

This is the Azure Sphere (Legacy) documentation. Azure Sphere (Legacy) is retiring on 27 September 2027, and users must migrate to Azure Sphere (Integrated) by this time. Use the Version selector located above the TOC to view the Azure Sphere (Integrated) documentation.

To use Azure Sphere (Legacy), you must have a Microsoft account. To find out whether you have one, or to create a new account, see One account for all things Microsoft.

That Microsoft account must be registered with Azure Sphere (Legacy). This is a one-time operation for any Microsoft account, so if you have previously used Azure Sphere (Legacy) with any tenant, then this is already complete. However, if you are using Azure Sphere (Legacy) for the first time, you must register yourself as a new user.

You can do this in one of two ways:

• If you are trying to obtain access to an existing Azure Sphere tenant, you should ask an existing Adminstrator of that tenant to add you to a role within that tenant using the azsphere role add command. This role addition automatically registers your Microsoft account with Azure Sphere (Legacy).
• You can create an Azure Sphere (Integrated) catalog. We recommend you use Azure Sphere (Integrated) instead of Azure Sphere (Legacy) due to its new features. However, if you need to use Azure Sphere (Legacy), then the act of creating an Azure Sphere (Integrated) catalog will also register you as an Azure Sphere (Legacy) user.

Once you have completed the steps above, you can sign in to Azure Sphere (Legacy) using azsphere login.

Note

Previously, a third way of acheiving registration was available, using the command azsphere register-user. This command has now been deprecated and will fail, you should use one of the two approaches above.