Share via


Create user mailboxes in Exchange Server

User mailboxes are Exchange mailboxes that are associated with people, typically one mailbox per person. Each user mailbox has an associated Active Directory account that gives the person access to the mailbox to send and receive email messages, and create meetings and appointments.

When you create a new user mailbox in Exchange, you also create the corresponding Active Directory user at the same time. Or, you can create a new mailbox for an existing Active Directory account that doesn't have an associated mailbox. This is known as mailbox-enabling an existing user.

You can create user mailboxes in Exchange Server by using the Exchange admin center (EAC) or the Exchange Management Shell. The following table describes some of the important properties for user mailboxes.

Property Required or optional Description
Alias Optional The Exchange alias (also known as the mail nickname) for the mailbox. The maximum length is 64 characters. Valid characters are letters, numbers and ASCII text characters that are allowed in email addresses. For example, periods are allowed, but each period must be surrounded by other valid characters (for example, pilar.pinilla).
The alias value is used to generate the primary email address (<alias>@ <domain>). If you don't specify an alias value, the username part of the account name (user principal name) is used.
The alias value must be unique.
Note: Don't use apostrophes (') or quotation marks (") in the alias. Although these characters are allowed, they might cause problems later.
Display name EAC: Required
Exchange Management Shell: Optional
Identifies the mailbox in the EAC, and in address lists in Outlook and Outlook on the web (formerly known as Outlook Web App). The maximum length is 256 characters. Spaces and other text characters are allowed.
In the EAC, the display name is populated by the values that you enter for the first name, middle initial, and last name, but you can specify a custom value.
In the Exchange Management Shell, if you don't specify a value for the display name, the value of the Name property is used.
The display name value doesn't need to be unique, but having multiple mailboxes with the same display name would be confusing.
Name Required Specifies the name of the object in Active Directory. Only administrators see this value in Exchange or Active Directory management tools. The maximum length is 64 characters. Spaces and other text characters are allowed.
The name value must be unique.

What do you need to know before you begin?

Tip

Having problems? Ask for help in the Exchange forums. Visit the forums at: Exchange Server, Exchange Online, or Exchange Online Protection.

Create user mailboxes

The procedures in this section describe how to create a new mailbox and the associated Active Directory user account.

Use the EAC to create user mailboxes

  1. In the EAC, go to Recipients > Mailboxes.

  2. Click New (Add icon.) and then select User mailbox.

    In the EAC, click Recipients, Mailboxes, New, keywords: Exchange create mailbox.

    Note: A linked mailbox is a local mailbox that's associated with a user account in a different (trusted) Active Directory forest. For more information, see Manage linked mailboxes.

  3. On the New user mailbox page, configure the following settings. Settings marked with an asterisk (*) are required.

    • Alias
    • Existing user or New user: Select New user.
    • First name
    • Initials
    • Last name
    • * Display name: By default, this field is populated with the names you enter in the First name, Initials, and Last name fields, but you can override it. The maximum length is 256 characters.
    • * Name: By default, this field is populated with the names you enter in the First name, Initials, and Last name field, but you can override it. The maximum length is 64 characters, and the value must be unique in your organization.
    • Organizational unit: Typically, the default location for the user account is the Users container. To change it, click Browse and select the OU or container where you want to create the account.
    • * User logon name: This is the Active Directory user account that's created and associated with the mailbox.

    Notes:

    • Don't use apostrophes (') or quotation marks ("). Although these characters are allowed, they might cause problems later (for example, assigning access permissions to the mailbox).
    • If this value is different than the Alias value, the user's email address and account name will be different (important if the email domain and the Active Directory domain are the same).
    • * New Password: Verify the value complies with your organization's password length, complexity, and history requirements.
    • * Confirm password
    • Require password change on next logon: Select this check box to force the user to change the initial password when they first sign in to the mailbox.
  4. You can click Save to create the mailbox and the associated Active Directory user account, or you can click More options to configure the following additional settings:

    • Mailbox database: Click Browse to select the mailbox database that holds the mailbox.

    • Create an on-premises archive mailbox for this user: Select this check box to create an archive mailbox for the mailbox, and then click Browse to select the mailbox database that holds the archive mailbox. Items are automatically moved from the primary mailbox to the archive based on the retention policy settings. For more information, see In-Place Archiving in Exchange Server.

    • Address book policy: ABPs define a global address list (GAL), an offline address book (OAB), a room list, and a set of address lists. An ABP gives the user access to a customized GAL in Outlook and Outlook on the web. For more information, see Address book policies in Exchange Server.

    When you're finished, click Save.

Use the Exchange Management Shell to create user mailboxes

To create a user mailbox in the Exchange Management Shell, use the following syntax:

New-Mailbox -Name <Name> -UserPrincipalName <UPN> -Password (Read-Host "Enter password" -AsSecureString) [-Alias <Alias>] [-FirstName <FirstName>] [-LastName <LastName>] [-DisplayName <DisplayName>] -[OrganizationalUnit <OU>]

This example creates a new mailbox and Active Directory user account for Pilar Pinilla with the following settings:

  • Required parameters:

    • Name: Pilar Pinilla. This value is also used for the display name, because we aren't using the DisplayName parameter.
    • UserPrincipalName: The Active Directory account name is pilarp@contoso.com.
    • Password: You're prompted to enter the password.
  • Optional parameters:

    • FirstName: Pilar
    • LastName: Pinilla
    • The alias value is pilarp because we aren't using the Alias parameter, and pilarp is taken from the UserPrincipalName parameter value.
New-Mailbox -Name "Pilar Pinilla" -UserPrincipalName pilarp@contoso.com -Password (Read-Host "Enter password" -AsSecureString) -FirstName Pilar -LastName Pinilla

For detailed syntax and parameter information, see New-Mailbox.

How do you know that you've created user mailboxes?

To verify that you've successfully created a user mailbox, use either of the following procedures:

  • In the EAC, go to Recipients > Mailboxes, and verify the mailbox is displayed in the list.

  • In the Exchange Management Shell, replace <Name> with the Name parameter value that you used, and run the following command:

    Get-Mailbox -Identity <Name> | Format-List Name,DisplayName,Alias,PrimarySmtpAddress,Database
    

Create mailboxes for existing user accounts

When you mailbox-enable a user account, you can only select existing Active Directory users that aren't already mail-enabled (no mail users or accounts that already have an associated mailbox).

Use the EAC to create mailboxes for existing user accounts

  1. In the EAC, go to Recipients > Mailboxes.

  2. Click New (Add icon.) and then select User mailbox.

    In the EAC, click Recipients, Mailboxes, New, keywords: create Exchange mailbox, Exchange Server create mailbox.

  3. On the New user mailbox page, configure the following settings.

    • Alias: This setting is optional.

      Notes:

      • Don't use apostrophes (') or quotation marks ("). Although these characters are allowed, they might cause problems later.

      • If this value is different than the username part of the user principal name, the user's email address and account name will be different (important if the email domain and the Active Directory domain are the same).

    • Existing user or New user: Verify Existing user is selected, and then click Browse to select an available account.

  4. You can click Save to create the mailbox, or you can click More options to configure the following additional settings:

    • Mailbox database: Click Browse to select the mailbox database that holds the mailbox.

    • Create an on-premises archive mailbox for this user: Select this check box to create an archive mailbox for the mailbox, and then click Browse to select the mailbox database that holds the archive mailbox. Items are automatically moved from the primary mailbox to the archive based on the retention policy settings. For more information, see In-Place Archiving in Exchange Server.

    • Address book policy: ABPs define a global address list (GAL), an offline address book (OAB), a room list, and a set of address lists. An ABP gives the user access to a customized GAL in Outlook and Outlook on the web. For more information, see Address book policies in Exchange Server.

    When you're finished, click Save.

Use the Exchange Management Shell to create mailboxes for existing user accounts

To create a mailbox for an existing user account, use the following syntax:

Enable-Mailbox -Identity <Account> [-Alias <Alias>] [-DisplayName <DisplayName>] [-Database <Database>]

This example creates a mailbox in the mailbox database named UsersMailboxDatabase for the existing user named Kathleen Reiter, whose account name (user principal name) is kreiter@contoso.com.

  • Because we aren't using the Alias parameter, the alias value is kreiter.

  • Because we aren't using the DisplayName parameter, the value of the name attribute in Active Directory is used as the display name.

Enable-Mailbox -Identity kreiter@contoso.com -Database UsersMailboxDatabase

This example finds all user accounts that aren't mail-enabled and that aren't system accounts (the userPrincipalName attribute isn't blank), and then creates mailboxes for those accounts.

Get-User -RecipientTypeDetails User -Filter "UserPrincipalName -ne `$null" -ResultSize unlimited | Enable-Mailbox

For detailed syntax and parameter information, see Enable-Mailbox and Get-User.

How do you know that you've created mailboxes for existing user accounts?

To verify that you've successfully created a mailbox for an existing user, use either of the following procedures:

  • In the EAC, go to Recipients > Mailboxes and verify the mailbox is displayed in the list.

  • In the Exchange Management Shell, replace <Name> with the name attribute of the user, and run the following command:

    Get-Mailbox -Identity <Name> | Format-List Name,DisplayName,Alias,PrimarySmtpAddress,Database