Use the Add-ExchangeItem cmdlet to add Transporter objects into Microsoft Exchange Server 2007 mailboxes or the Active Directory directory service.

Add-ExchangeItem -TransporterObject <IAlienDataObject> [-Confirm [<SwitchParameter>]] [-GlobalCatalog <String>] [-MaxThreadCount <UInt32>] [-Quiet <SwitchParameter>] [-TargetClientAccessServer <String>] [-TargetCredential <PSCredential>] [-TargetMailboxDatabase <String>] [-TargetMapping <String>] [-TargetMode <String>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter Required Type Description

TransporterObject

Required

Microsoft.Exchange.Transporter.IAlienDataObject

The receptacle for iAlienDataObjects of type message from the pipeline.

Confirm

Optional

System.Management.Automation.SwitchParameter

Causes the command to pause processing and requires that you acknowledge what the command will do before processing continues. You do not have to specify a value when you use this parameter.

DomainController

Optional

System.String

Specifies the Active Directory domain controller to connect to.

If a value is not specified, a referral will occur to obtain a valid domain controller.

The default value for this parameter is false.

GlobalCatalog

Optional

System.String

Identifies the Active Directory server.

MaxThreadCount

Optional

System.UInt32

Indicates the maximum number of threads that are allocated to this task.

Quiet

Optional

System.Management.Automation.SwitchParameter

Suppresses feedback during task actions.

TargetClientAccessServer

Optional

System.String

Specifies the Exchange Client Access server. This can be specified in either fully qualified domain name (FQDN) or URL format.

If specified, this parameter overrides the autodiscovery process so that only the server that is specified is used to access the target.

The default behavior is autodiscovery.

TargetCredential

Optional

System.Management.Automation.PSCredential

 

TargetMailboxDatabase

Optional

System.String

Specifies the Exchange mail database to create new mailboxes in. We recommend that you use one of the following formats:

  • database name

  • server name\database

  • name

  • server name\storage group\database name

If specified, this parameter indicates that mailboxes should be created.

TargetMapping

Optional

System.String

Specifies a custom map file, which defines how the attributes in the source object will be mapped to the target schema.

The default behavior is to use the default map file.

TargetMode

Optional

System.String

Specifies the mode of injection to be used. Purge clears the target of any records before starting the injection. Merge checks each item to determine whether it exists before writing it to the target. Append copies all records to the target location.

The default value for this parameter is Merge.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view the changes that would occur without applying any of those changes. You do not have to specify a value for this parameter.

UseDelegate

Optional

System.Management.Automation.SwitchParameter

Allows the user to bypass an attempt to use Exchange Impersonation rights to access an Exchange mailbox. To use this parameter, you must have Full Mailbox permissions for the target mailbox.

Detailed Description

The Add-ExchangeItem cmdlet adds Transporter objects into an Exchange 2007 mailbox.

To run the Add-ExchangeItem cmdlet, you must have Exchange Impersonation rights on the computer that is running Exchange 2007 where the target mailbox exists. For more information, see Exchange Server Permissions.

Input Types

None.

Return Types

None.

Example

The following example shows you how to move a Transporter object that is saved as a variable called $mail to an Exchange server by using the Add-ExchangeItem cmdlet.

  Copy Code 
$mail | Add-ExchangeItem