Add-MapiRecipient

Description

Adds a recipient to a message's recipient table.

Syntax

Note:  Parameters in orange are optional.

Add-MapiRecipient
-MessageMapiObject<Mapi.NET.Message>
-RecipientEntryMapiObject<Mapi.NET.Recipient>[]
-AsOneOffSwitchParameter
This version, without additional switches, adds a TO recipient

Add-MapiRecipient
-MessageMapiObject<Mapi.NET.Message>
-RecipientEntryMapiObject<Mapi.NET.Recipient>[]
-AddAsCarbonCopyRecipientSwitchParameter
-AsOneOffSwitchParameter

Add-MapiRecipient
-MessageMapiObject<Mapi.NET.Message>
-RecipientEntryMapiObject<Mapi.NET.Recipient>[]
-AddAsBlindCopyRecipientSwitchParameter
-AsOneOffSwitchParameter

Add-MapiRecipient
-MessageMapiObject<Mapi.NET.Message>
-AddressString[]
-AsOneOffSwitchParameter
This version, without additional switches, adds a TO recipient

Add-MapiRecipient
-MessageMapiObject<Mapi.NET.Message>
-AddressString[]
-AddAsCarbonCopyRecipientSwitchParameter
-AsOneOffSwitchParameter

Add-MapiRecipient
-MessageMapiObject<Mapi.NET.Message>
-AddressString[]
-AddAsBlindCopyRecipientSwitchParameter
-AsOneOffSwitchParameter

Parameters
MessageA message object.  Use Get-MapiItem to get an instance of this object
RecipientEntryA list of one or more Mapi.NET.Recipient objects.  Use Get-MapiRecipient to get these objects
AddressA list of one or more email address values
AsOneOffWhen the parameter is used, causes the recipient to be added as a simple email address, one that is not matched to an entry from any address books.
This switch is only used with the -Address parameter
AddAsCarbonCopyRecipientWhen this switch is present, the recipient is added to the message's recipient table as a CC recipient.
This switch is mutually exclusive with the -AddAsBlindCopyRecipient
AddAsBlindCopyRecipient

 

When this switch is present, the recipient is added to the message's recipient table as a BCC recipient.
This switch is mutually exclusive with the -AddAsCarbonCopyRecipient
Remarks
Messages in PST files have limits on the recipient count.  The limit is a data size limit, not a row count limit; as such, addresses with longer values take up more space.  In general, more than about 500 addresses become problematic and should be avoided.

Even with Exchange mailboxes, high recipient counts should be avoided.