Description
Adds a recipient to a message's recipient table.
Syntax
Note: Parameters in orange are optional.
| Add-MapiRecipient | ||
| -Message | MapiObject<Mapi.NET.Message> | |
| -RecipientEntry | MapiObject<Mapi.NET.Recipient>[] | |
| -AsOneOff | SwitchParameter | |
| This version, without additional switches, adds a TO recipient | ||
| Add-MapiRecipient | ||
| -Message | MapiObject<Mapi.NET.Message> | |
| -RecipientEntry | MapiObject<Mapi.NET.Recipient>[] | |
| -AddAsCarbonCopyRecipient | SwitchParameter | |
| -AsOneOff | SwitchParameter | |
| Add-MapiRecipient | ||
| -Message | MapiObject<Mapi.NET.Message> | |
| -RecipientEntry | MapiObject<Mapi.NET.Recipient>[] | |
| -AddAsBlindCopyRecipient | SwitchParameter | |
| -AsOneOff | SwitchParameter | |
| Add-MapiRecipient | ||
| -Message | MapiObject<Mapi.NET.Message> | |
| -Address | String[] | |
| -AsOneOff | SwitchParameter | |
| This version, without additional switches, adds a TO recipient | ||
| Add-MapiRecipient | ||
| -Message | MapiObject<Mapi.NET.Message> | |
| -Address | String[] | |
| -AddAsCarbonCopyRecipient | SwitchParameter | |
| -AsOneOff | SwitchParameter | |
| Add-MapiRecipient | ||
| -Message | MapiObject<Mapi.NET.Message> | |
| -Address | String[] | |
| -AddAsBlindCopyRecipient | SwitchParameter | |
| -AsOneOff | SwitchParameter | |
Parameters
| Message | A message object. Use Get-MapiItem to get an instance of this object |
| RecipientEntry | A list of one or more Mapi.NET.Recipient objects. Use Get-MapiRecipient to get these objects |
| Address | A list of one or more email address values |
| AsOneOff | When 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 |
| AddAsCarbonCopyRecipient | When 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.