"Get-HybridMailflowDatacenterIPs is not recognized" error when running Hybrid Configuration wizard

Original KB number:   3063646

Note

The Hybrid Configuration wizard that's included in the Exchange Management Console in Microsoft Exchange Server 2010 is no longer supported. Therefore, you should no longer use the old Hybrid Configuration wizard. Instead, use the Microsoft 365 Hybrid Configuration wizard that's available at https://aka.ms/HybridWizard. For more information, see Microsoft 365 Hybrid Configuration wizard for Exchange 2010.

Symptoms

You want to set up a hybrid deployment between your on-premises Exchange Server organization and Exchange Online in Microsoft 365. However, when you run the Hybrid Configuration wizard, the wizard doesn't complete successfully, and you receive a Get-HybridMailflowDatacenterIPs is not recognized error message. The full text of this message resembles the following example:

ERROR:Updating hybrid configuration failed with error 'Subtask CheckPrereqs execution failed: Configure Mail Flow

Execution of the Get-HybridMailflowDatacenterIPs cmdlet had thrown an exception. This may indicate invalid parameters in your Hybrid Configuration settings.

The term 'Get-HybridMailflowDatacenterIPs' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again. at System.Management.Automation.PowerShell.CoreInvoke[TOutput](IEnumerable input, PSDataCollection`1 output, PSInvocationSettings settings) at System.Management.Automation.PowerShell.Invoke(IEnumerable input, PSInvocationSettings settings) at System.Management.Automation.PowerShell.Invoke() at Microsoft.Exchange.Management.Hybrid.RemotePowershellSession.RunCommand(String cmdlet, Dictionary`2 parameters, Boolean ignoreNotFoundErrors)'.

Cause

The Hybrid Configuration wizard depends on the availability of a Microsoft 365 plan in which it can access the Get-HybridMailflowDatacenterIPs cmdlet. The error message indicates that the subscriptions that you currently have can't access this cmdlet.

Workaround

Add a trial subscription of Office 365 Enterprise E3 to your account. After you add the Office 365 Enterprise E3 plan, the Hybrid Configuration Wizard will complete successfully. To add a trial subscription, follow these steps:

  1. Sign in to the Microsoft 365 portal.
  2. To open the Microsoft 365 admin center, select Admin.
  3. In the navigation pane, expand Billing, select Subscriptions, and then select New Subscription.
  4. Under Office 365 Enterprise E3, select Trial, and then follow the steps that are displayed on the screen.

For more help to work around this issue, contact Microsoft Support.

Status

It's a known issue. We're working to address this issue and will post more information in this article when it becomes available.

More information

Still need help? Go to Microsoft Community or the Microsoft Q&A.