Add or remove email addresses from a mailbox

You can configure more than one email address for the same mailbox. Additional addresses are called proxy addresses. A proxy address enables a user to receive mail that is sent to another email address. All email messages sent to the user's proxy address are delivered to the primary email address, also known as the primary SMTP address or the default reply-to address.

Important. If you use Microsoft 365 or Office 365 for business, you must add or remove email addresses for user mailboxes in the Add another email alias for a user

For other management tasks related to managing recipients, see the "Recipients documentation" table in Recipients in Exchange Online.

What do you need to know before you begin?

• Estimated time to complete each procedure: 2 minutes.
• You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Recipients" entry in the Feature permissions in Exchange Online article.
• For information about keyboard shortcuts that can be applied to the procedures in this article, see Keyboard shortcuts for the Exchange admin center.

The procedures in this article show how to add or remove email addresses for a user mailbox. You can use similar procedures to add or remove email addresses for other types of recipients.

Note. You can use similar procedures to add or remove email addresses that use plus addressing. For more information about plus addressing, see Plus Addressing.

Use Exchange Online PowerShell to add an email address

The email addresses associated with a mailbox are listed in the mailbox's EmailAddresses property. Because it can contain more than one email address, the EmailAddresses property is known as a multi-valued property. The following examples show different ways to modify a multi-valued property.

This example shows how to add an SMTP address to Dan Jump's mailbox.

Set-Mailbox "Dan Jump" -EmailAddresses @{add="dan.jump@northamerica.contoso.com"}

This example shows how to add multiple SMTP addresses to a mailbox.

Set-Mailbox "Dan Jump" -EmailAddresses @{add="dan.jump@northamerica.contoso.com","danj@tailspintoys.com"}

For more information about how to use this method of adding or removing multivalued property values, see Modifying Multivalued Properties.

This example shows another way to add email addresses to a mailbox by specifying all addresses associated with the mailbox. In this example, danj@tailspintoys.com is the new email address you want to add. The other two email addresses are existing addresses. The address with the SMTP case-sensitive qualifier is the primary SMTP address. You must include all email addresses for the mailbox when you use this command syntax. If you do not, the addresses specified in the command will overwrite the existing addresses.

Set-Mailbox "Dan Jump" -EmailAddresses @{add="dan.jump@northamerica.contoso.com","danj@tailspintoys.com"}

Set-Mailbox "Janet Schorr" -EmailAddresses @{remove="janets@corp.contoso.com"}

Set-Mailbox "Janet Schorr" -EmailAddresses @{remove="janet.schorr@corp.contoso.com","janets@tailspintoys.com"}

Set-Mailbox "Janet Schorr" -EmailAddresses SMTP:janets@contoso.com,janets@tailspintoys.com

Use Exchange Online PowerShell to add email addresses to multiple mailboxes

You can add a new email address to multiple mailboxes at once by using Exchange Online PowerShell and a comma-separated values (CSV) file.

This example imports data from C:\Users\Administrator\Desktop\AddEmailAddress.csv, which has the following format.

Mailbox,NewEmailAddress
Dan Jump,danj@northamerica.contoso.com
David Pelton,davidp@northamerica.contoso.com
Kim Akers,kima@northamerica.contoso.com
Janet Schorr,janets@northamerica.contoso.com
Jeffrey Zeng,jeffreyz@northamerica.contoso.com
Spencer Low,spencerl@northamerica.contoso.com
Toni Poe,tonip@northamerica.contoso.com
...

Run the following command to use the data in the CSV file to add an email address to each mailbox specified in the CSV file.

Import-CSV "C:\Users\Administrator\Desktop\AddEmailAddress.csv" | ForEach {Set-Mailbox $_.Mailbox -EmailAddresses @{add=$_.NewEmailAddress}}

Nota. Los nombres de columna de la primera fila de este archivo CSV (Mailbox, NewEmailAddress) son arbitrarios. Independientemente de lo que use para los nombres de columna, asegúrese de usar los mismos nombres de columna en Exchange Online comando de PowerShell.