Add a new Azure Stack Hub user account in Microsoft Entra ID

Before you can test offers and plans and create resources, you'll need a user account for the Azure Stack Hub user portal. You create a user account in your Microsoft Entra tenant, by using the Azure portal or PowerShell.

Create user account using the Azure portal

You must have an Azure subscription to use the Azure portal.

  1. Sign in to the Azure portal.

  2. Using the Directory + Subscription filter icon in the upper right, switch to the Microsoft Entra directory tenant you're using for Azure Stack Hub.

  3. Using the search bar at the top, search for and select the Microsoft Entra ID service.

  4. In the left pane, select Users.

  5. On the Users page, select + New user.

    Users - Lists all existing user accounts

  6. On the New user page, select Create user then fill in the required info:

    Users - Add a new user account

    • User name (required): The identifier used for sign in. For example, mary@contoso.com. The domain part of the user name must use either the initial default domain name, <yourdomainname>.onmicrosoft.com, or a custom domain name, such as contoso.com. For more info on how to create a custom domain name, see How to add a custom domain name to Microsoft Entra ID.
    • Name (required): The first and last name of the new user. For example, Mary Parker.
    • Show Password: Select the checkbox and copy the autogenerated password provided in Initial password. You'll need this password for the initial sign-in process.
    • Groups and roles: Make sure the User directory role is selected.
    • Settings and Job info: Optionally, you can add more info about the user. You can also add user info later. For more details, see How to add or change user profile information.
  7. Select Create. You should see a "Successfully created user" notification in the upper right.

  8. Sign out and sign in to the Azure portal again, with the new account using the password you saved. Change the password when prompted.

  9. Sign in to the Azure Stack Hub user portal with the new account to see the user portal.

Create a user account using PowerShell

If you don't have an Azure subscription, you can't use the Azure portal to add a tenant user account. In this case, you can use the Azure AD module for Windows PowerShell instead.

  1. Install the Microsoft Azure AD module for Windows PowerShell with these steps:

    • Open an elevated Windows PowerShell command prompt (run Windows PowerShell as admin).
    • Run the Install-Module AzureAD command.
    • If you're prompted to install the NuGet provider, select Y and Enter.
    • If you're prompted to install the module from PSGallery, select Y and Enter.
  2. Run the following cmdlets to sign in and create the user account:

    • If your directory doesn't require multi-factor authentication, use this sequence to authenticate:

      # Wait for the prompt, then sign in using your Azure AD credentials
      $aadcred = get-credential
      Connect-AzureAD -credential $aadcred
      
    • If your directory requires multi-factor authentication, use this sequence to authenticate:

      # Wait for the prompt, then sign in using your Azure AD credentials and MFA code
      Connect-AzureAD -Confirm
      
    • Now that you've authenticated, complete the sequence by adding the new user:

      # Create the new user account (be sure to replace all <placeholder> values first)
      $passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
      $passwordProfile.Password = "<Password>"
      New-AzureADUser -DisplayName "<UserName>" -PasswordProfile $passwordProfile -UserPrincipalName "<username>@<yourdomainname>" -AccountEnabled $true -MailNickName "<MailNickName>"
      
  3. Sign in to the Azure portal with the new user account. Change the password when prompted.

  4. Sign in to the Azure Stack Hub user portal with the new account to see the user portal.

Next steps