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="[email protected]"}

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

Set-Mailbox "Dan Jump" -EmailAddresses @{add="[email protected]","[email protected]"}

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, [email protected] 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="[email protected]","[email protected]"}

Set-Mailbox "Janet Schorr" -EmailAddresses @{remove="[email protected]"}

Set-Mailbox "Janet Schorr" -EmailAddresses @{remove="[email protected]","[email protected]"}

Set-Mailbox "Janet Schorr" -EmailAddresses SMTP:[email protected],[email protected]

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,[email protected]
David Pelton,[email protected]
Kim Akers,[email protected]
Janet Schorr,[email protected]
Jeffrey Zeng,[email protected]
Spencer Low,[email protected]
Toni Poe,[email protected]
...

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.