Add-EmailAddress cmdlet adds Email addresses to:

  • Mailboxes (MS Exchange, OWA only, POP/IMAP, Resource mailbox)
  • MS Exchange Distribution lists
  • Public folders.

This cmdlet supports risk-mitigation parameters.

Input parameters


Mandatory (R/O)

Restrictions/Valid Values
1 Authentication Information (all parameters)  


(aliases: Address, EmailAddress, EmailAddresses)

string[] R Email address (or addresses), which will be added to the current list of addresses Email address(es) must be in a valid  format and with the valid domain part


(aliases: GUID, DistinguishedName)


A property, that is used for managing addresses of mail-enabled Š¾bjects:

  • MS Exchange mailbox
  • OWA-only mailbox
  • POP/IMAP mailbox
  • Resource mailbox
  • MS Exchange distribution list
  • Public folder 

Value of one of these parameters can be used as Identity:

1 GUID Globally Unique Identifier (ObjectGuid)
2 DistinguishedName Unique name of the object in Active Directory

Type ADObjectIDParameter

This type is used for implicit converting strings, GUIDs or ADObjectIDInfo for identifiers, acceptable to Control Panel. E.g. It defines what the user has printed: GUID or DistinguishedName.

ADObjectIDParameter doesn't have any properties (parameters) as such. The user must not construct objects of this type by himself.

Output parameters

No parameters

Examples of using Add-EmailAddress cmdlet

Adding one address:

Add-EmailAddress -Identity 36082eb0-1011-4f22-aa98-9139ddbd31b3 -EmailAddress ""

Adding several addresses:

Add-EmailAddress -Identity 36082eb0-1011-4f22-aa98-9139ddbd31b3 -EmailAddresses "", ""