This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Original KB number: 3160413
You have a hybrid deployment of on-premises Exchange Server and Exchange Online in Microsoft 365. Your primary mailboxes are located in the on-premises environment and archive mailboxes are located in Exchange Online. When you try to move only a primary mailbox from the on-premises environment to Exchange Online by using the Exchange admin center (EAC) in Microsoft 365, you receive the following error message.
Error: MigrationPermanentException
ErrorSummary: You must specify the PrimaryOnly parameter
The EAC doesn't provide the option to move only a primary mailbox from an on-premises environment to Exchange Online. To do this, you must use the New-MoveRequest cmdlet.
To move only a primary mailbox, use the New-MoveRequest cmdlet. Follow these steps:
Run the following command to connect to Exchange Online PowerShell:
Connect-ExchangeOnline
Run the following command to initiate a mailbox migration from the on-premises environment to Exchange Online:
New-MoveRequest -Identity <mailbox ID> -RemoteCredential (Get-Credential) -Remote -RemoteHostName <on-premises MRS proxy URL> -BatchName <name of batch> -PrimaryOnly -TargetDeliveryDomain <mail.onmicrosoft.com domain>
Note: When you're prompted for credentials, enter your credentials for on-premises Exchange.
You have a hybrid deployment of on-premises Exchange Server and Exchange Online in Microsoft 365 where the primary mailboxes and archive mailboxes are hosted in Exchange Online. When you try to offboard only a primary mailbox from Exchange Online to the on-premises environment by using the EAC in Microsoft 365, you receive the following error message.
Error: ParameterValueRequiredPermanentException
ErrorSummary: You must specify the ArchiveDomain parameter
The EAC doesn't have the option to move only a primary mailbox from Exchange Online to an on-premises environment.
To move only a primary mailbox, use the New-MoveRequest cmdlet. Follow these steps:
Run the following command to connect to Exchange Online PowerShell:
Connect-ExchangeOnline
Run the following command:
New-MoveRequest -Identity <mailbox ID> -Outbound -RemoteTargetDatabase <on-premises mailbox database> -RemoteHostName <on-premises MRS proxy URL> -BatchName <name of batch> -PrimaryOnly -ArchiveDomain <mail.onmicrosoft.com domain> -TargetDeliveryDomain <on-premises domain> -RemoteCredential (Get-Credential)
Still need help? Go to Microsoft Community or the Microsoft Q&A.
Training
Module
Manage Exchange Online by using Windows PowerShell - Training
This module covers managing mailboxes, resources, and admin roles in Exchange Online with PowerShell.
Certification
Microsoft 365 Certified: Administrator Expert - Certifications
If you’re an administrator who deploys and manages Microsoft 365 and performs Microsoft 365 tenant-level implementation and administration of cloud and hybrid environments, this certification is designed for you.