Move Mailbox operation

The Move Mailbox process moves mailboxes within your organization or between different organizations. The following table describes the input parameters for Move Mailbox process

 Adapter request parameters for Move Mailbox process

Element

Definition

Required

<ConfigurationOnly>

Changes the Exchange server location in the Active Directory directory service

Use this parameter to direct the mailbox to a functional server. The mailbox content is not moved.

Yes

<Identity>

Specifies the recipient identification of the single mailbox to move

Yes

<TargetDatabase>

Specifies the database to which the mailbox will be moved

If you do not specify the server name, the cmdlet will search for the database on the local server. If you have multiple databases with the same name on the same server, you must specify the storage group.

Yes

<AllContentKeywords>

Specifies the keywords of the content to include in the move.

If the command finds a keyword that you specify in the message body, attachment content, or subject, it will export those messages

This is different from using both the ContentKeywords and SubjectKeywords parameters. If you use both the ContentKeywords and SubjectKeywords parameters, the command will export only those messages that have both the keyword that you specify for the ContentKeywords parameter in the message body or attachment content, and the keyword you specify for the SubjectKeywords parameter in the subject.

No

<AllowMerge>

Specifies the merging of mailboxes if one mailbox already exists

You can use this parameter to move a mailbox between different organizations even if a target mailbox already exists. The contents of the mailbox are merged at the target. This parameter cannot be used if the NTAccountOU parameter is used. If you specify this parameter, the user's rules will not be moved to the target.

No

<AttachmentFilenames>

Specifies the attachments to be included in the move. File names can include any file type and wildcard characters

No

<BadItemLimit>

Specifies the number of bad items to skip. Use 0 to not skip bad items. The valid input range for this parameter is 0 to 2,147,483,647

No

<ContentKeywords>

Specifies the keywords of the content to include in the move

If the command finds a keyword that you specify in the message body or in the attachment content, it will export those messages.

No

<DomainController>

Specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory

The DomainController parameter should be included in the command.

No

<EndDate>

Specifies the end date for filtering content that will be moved from the source mailbox

Only items in the mailbox whose date is prior to or the same as the end date will be moved. When you enter a specific date, use the short date format that is defined in the Regional Options settings that are configured on the local computer. For example, if your computer is configured to use the short date format mm/dd/yyyy, enter 03/01/2006 to specify March 1, 2006.

No

<ExcludeFolders>

Specifies the list of folders to exclude during the move

No

<GlobalCatalog>

Specifies the global catalog in which to perform search operations in the target forest

No

<IgnorePolicyMatch>

Specifies whether to match recipient policies

No

<IgnoreRuleLimitErrors>

Specifies that the command will not move the user's rules to the target Microsoft Exchange Server 2003 or Exchange 2000 Server account

You can specify this parameter to avoid the Microsoft Outlook 32K rules limit. By default, the Move-Mailbox cmdlet will move rules, both in single forest and cross-forest moves.

No

<IncludeFolders>

Specifies the list of folders to include during the move

No

<Locale>

Specifies the locale of messages to move. The command will move only messages with the locale that you specify

No

<MaxThreads>

Specifies the maximum number of threads to use. The valid input range for this parameter is 0 to 30

No

<NTAccountOU>

Specifies the organizational unit in which the Microsoft Windows NT accounts are created

This parameter cannot be used if the AllowMerge parameter is used.

No

<PreserveMailboxSizeLimit>

Specifies whether to apply the size limit options of the source mailbox to the target mailbox

No

<RecipientKeywords>

Specifies recipient e-mail addresses or display names

If the command finds a message with a recipient that is the same as the recipient keyword that you specified, it will move the message. If the recipient keyword that you specify is the same as a distribution group that is a recipient of a message, the message will be moved. The command does not expand distribution groups to compare the recipient keywords that you specify to the members of a distribution group that is a recipient of a message.

No

<ReportFile>

Specifies the path and file name for the XML Report log

No

<RetryInterval>

Specifies the interval for retrieving the move's status from the server

No

<RetryTimeout>

Specifies the time-out limit for moving a mailbox

No

<SenderKeywords>

Specifies sender e-mail addresses or display names

If the command finds a message with a sender that is the same as a sender keyword that you specify, it will move the message.

No

<SourceForestGlobalCatalog>

Specifies the global catalog in which to perform search operations in the source forest

No

<SourceMailboxCleanupOptions>

Specifies cleanup options for the source mailbox

This parameter cannot be used if the AllowMerge parameter is used.

The possible values are:

  • DeleteSourceNTAccount. Use to delete the source user account Active Directory object.
  • DeleteSourceMailbox. Use to delete mailbox attributes from the source user account.
  • CreateSourceContact. Use to delete the source user account Active Directory object and create a contact in the source forest that is associated with the mailbox that you are moving to the target forest. You can use this option only if the target mailbox is on an Exchange 2007 server.
  • MailEnableSourceAccount. Use to delete mailbox attributes from source user account and mail-enable the source user account so that it is associated with the mailbox that you are moving to the target forest. You can use this option only if the target mailbox is on an Exchange 2007 server.

No

<StartDate>

Specifies the start date for filtering content that will be moved from the source mailbox

Only items in the mailbox whose date is later than the start date will be moved. When you enter a specific date, use the short date format that is defined in the Regional Options settings that are configured on the local computer. For example, if your computer is configured to use the short date format mm/dd/yyyy, enter 03/01/2006 to specify March 1, 2006.

No

<SubjectKeywords>

Specifies the keyword filters for subjects of items in the source mailbox

No

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*