{"id":60850,"date":"2020-07-14T07:04:37","date_gmt":"2020-07-14T07:04:37","guid":{"rendered":"https:\/\/www.stellarinfo.com\/blog\/?p=60850"},"modified":"2026-01-30T09:04:54","modified_gmt":"2026-01-30T09:04:54","slug":"use-set-mailboxexportrequest-exchange-cmdlet","status":"publish","type":"post","link":"https:\/\/www.stellarinfo.com\/blog\/use-set-mailboxexportrequest-exchange-cmdlet\/","title":{"rendered":"How to Use Set-MailboxExportRequest Cmdlet?"},"content":{"rendered":"

In MS Exchange Server (2010 SP1 and later), you can export mailboxes from the Exchange database (EDB) file to PST by using the New-MailboxExportRequest<\/a> cmdlet. However, sometimes, a few mailbox export requests fail or do not complete. This happens if there are any corrupted or large items in the source mailbox or various other reasons. In such a case, you can use the Set-MailboxExportRequest<\/strong> cmdlet. This cmdlet allows you to change the options in the mailbox export request after it has been executed and helps to recover from the failed mailbox export requests. In this blog, we will see how to use the Set-MailboxExportRequest<\/strong> PowerShell cmdlet, along with different parameters.<\/p>

Using the Set-MailboxExportRequest Cmdlet in Exchange Server<\/strong><\/h2>

Like other cmdlets, you must have the required roles and permissions assigned before using the Set-MailboxExportRequest<\/strong> cmdlet. You must be assigned with the Mailbox Import Export<\/strong> role to use this cmdlet.<\/p>

Following is the Set-MailboxExportRequest<\/strong> syntax you can use to modify the Exchange Mailbox Export request.<\/p>

Set-MailboxExportRequest –Identity <mailbox export request identity> <Common Parameter><\/strong><\/code><\/pre>
You can use the cmdlet with various parameters to add exceptions to the failed requests. Some common parameters are.<\/p>
1. –BadItemLimit<\/strong><\/h3>
This parameter is used to specify the maximum number of bad items that can be skipped during export before the request fails. A bad item is a corrupted item in the source mailbox that can’t be copied to the target mailbox. If you set the -BadItemLimit<\/strong> value to 51<\/strong> or higher, you also need to use the AcceptLargeDataLoss<\/strong> switch with the cmdlet. Here’s how to use the cmdlet:<\/p>
Set-MailboxExportRequest -Identity \"Eric\\MailboxExport1\\\" -BadItemLimit 51 –AcceptLargeDataLoss<\/strong><\/code><\/pre>
\"BadItemLimit\"<\/figure>
The above command will modify the export request with identity – Eric\\MailboxExport1 <\/strong>to skip up to 51 corrupted items while exporting the mailbox.<\/p>
2. –LargeItemLimit<\/strong><\/h3>
This parameter is used to specify the number of large items to be allowed before the export request fails. This is useful if the export request fails or does not complete due to large messages that exceed the maximum message size, allowed in the target mailbox.<\/p>
\n
Note: <\/em><\/strong>When you use this parameter, the specified number of large items will be excluded from the exported PST file. Use it only if you are okay with skipping the large items.<\/em><\/p>\n<\/blockquote>
Here’s how to use the Set-MailboxExportRequest<\/strong> cmdlet with the LargeItemLimit <\/strong>parameter.<\/p>
Set-MailboxExportRequest -Identity \"Eric\\MailboxExport1\\\" -LargeItemLimit 51 -AcceptLargeDataLoss<\/strong><\/code><\/pre>
\"LargeItemLimit\"<\/figure>
This command will modify the export request with identity – Eric\\MailboxExport1 <\/strong>to skip up to 51 large items while exporting the mailbox.<\/p>
3. –AcceptLargeDataLoss<\/strong><\/h3>
The –AcceptLargeDataLoss<\/strong> parameter is used with the –BadItemLimit<\/strong> and –LargeItemLimit<\/strong> parameters. This parameter specifies that the request should continue even if a large number of items or bad items in the source mailbox cannot be copied to the target mailbox. You need to use this parameter if you’re setting the value for BadItemLimit<\/strong> or LargeItemLimit<\/strong> to 51 or above. Otherwise, the command will fail and display an error similar to the below:<\/p>
\"AcceptLargeDataLoss\"<\/figure>
Here’s how to use the Set-MailboxExportRequest <\/strong>cmdlet with the AcceptLargeDataLoss<\/strong> parameter:<\/p>
Set-MailboxExportRequest -Identity \"Eric\\MailboxExport1\\\" -BadItemLimit 100 -LargeItemLimit 100 –AcceptLargeDataLoss<\/strong><\/code><\/pre>
After executing the above cmdlet, you will get a warning message that the large or corrupted items (based on the defined value) will not be available in the destination mailbox.<\/p>
\"After<\/figure>
4. –CompletedRequestAgeLimit<\/strong><\/h3>
This parameter is used to specify an age limit for a failed or completed request. You can use it to remove any export request after a specific time interval post execution. Here’s an example:<\/p>
Set-MailboxExportRequest -Identity \"Eric\\MailboxExport1\\\" –CompletedRequestAgeLimit 20<\/strong><\/code><\/pre>
\"CompletedRequestAgeLimit\"<\/figure>
This command will remove the mailbox export request of the identity – Eric\\MailboxExport1\\ <\/strong>after 20<\/strong> days.<\/p>
5. –Priority<\/strong><\/h3>
This parameter is used to specify the order in which the export requests will be processed. You can prioritize a mailbox export request based on various values, such as Lowest<\/strong>, Lower<\/strong>, Low<\/strong>, High<\/strong>, Higher<\/strong>, Highest<\/strong>, and Emergency<\/strong>. By default, the export requests are executed in a queue (Normal<\/strong> priority). Here’s an example of the cmdlet:<\/p>
Set-MailboxExportRequest -Identity \"John\\MailboxE xport01\\\" –Priority High<\/strong><\/code><\/pre>
6. –WhatIf<\/strong><\/h3>
The WhatIf<\/strong> parameter is used to simulate the command actions. By using this switch, you can check what changes would occur before you actually run the command on the mailbox. There is no need to specify a value with this parameter. Here’s an example of the cmdlet with the WhatIf <\/strong>parameter.<\/p>
Set-MailboxExportRequest -Identity \"John\\MailboxExport01\\\" –Priority High –WhatIf<\/code><\/pre>
\"WhatIf\"<\/figure>
\n