As you are aware, we released the Microsoft Hybrid Agent for Exchange Server as a preview on Feb. 5th, 2019. The blog post for that release is located here. We have been busy working on a few improvements for the Hybrid Agent over that past two months and wanted to let you know of some new features now available in the latest build of the Hybrid Configuration Wizard. The three enhancements for the Hybrid Agent are:
- Multi Agent installation and configuration
- Agent status views
- Registration/Usage of a load balancer for the internal URL instead of a specific Exchange Client Access Server
Multi Agent Deployment
Option 1 – Use the Hybrid Configuration Wizard to install additional agents
For existing Hybrid Agent preview customers who would like to install additional Hybrid Agents for redundancy, simply download the latest version of the Hybrid Configuration Wizard (HCW) and open the application on the machine where you would like to install an additional Hybrid Agent.- Like previous HCW runs, start the application, select Next.
- Select a desired server to execute against, select Next.
- Provide credentials to sign into your Office 365 tenant, select Next.
- The HCW will gather configuration information, select Next when complete.
- Select the default option provided for either Full or Minimal, select Next.
- Select Exchange Modern Hybrid Topology, Next.
- Agree to the Terms, Next.
- A new page will be shown that will provide you with the status of your existing / previously installed agent. Make sure the status of the existing agent is accurate before proceeding to the next step. Select Install and additional agent option, Next.
The HCW will install the additional Hybrid Agent. When the installation is complete, you can open the Microsoft Windows Services console from the machine and verify the service / agent is installed and running (look for Microsoft Hybrid Service - mshybridsvc). At that point, you can either re-run HCW if you wish to make further changes to your hybrid config, or simply cancel the wizard.
You can repeat this step on each machine where you would like an additional Hybrid Agent installed.
Option 2 – Manually download & install additional agents
A second option for installing additional agents is outside the HCW itself and is done by downloading and manually installing the agent on the desired machine.- Go to https://aka.ms/hybridagentinstaller.
- Save the MSHybridService.msi to a location on your machine.
- From that machine, open a Windows Command console as Administrator and run:
- Msiexec /i MSHybridService.msi to install the hybrid agent. You will be prompted for your tenant Global Admin credentials.
- After the installation is complete, you can open the Microsoft Windows Services console from the machine and verify the service / agent is installed and running.
Checking the Status of Your Hybrid Agents
Option 1 – Get status via the Hybrid Configuration Wizard (HCW)
- Start the HCW application, select Next.
- Select a server in your Exchange org, select Next.
- Provide credentials to sign into your Office 365 tenant, select Next.
- The HCW will gather configuration information, select Next when complete.
- Select default option provided for either Full or Minimal, select Next.
- Select Exchange Modern Hybrid Topology, Next.
- Agree to the Terms, Next.
- A new page will be shown that will provide you with the status of your existing installed agents.
Cancel the HCW app when you are done.
Option 2 – Get status via the Hybrid Management PowerShell Module
With each installation of the Hybrid Agent, we install the Hybrid Management PowerShell module in the directory …\Program Files\Microsoft Hybrid Service\ on the machine where the agent is installed. By default, this module is not imported and so you will need to import it before you can use it. This module also requires the Azure module for PowerShell if not already installed. Please install the PackageManagement modules first and then see this article for how to install the Azure module. To import the Hybrid Management module, run the following from a Windows PowerShell prompt as Administrator:Import-module .\HybridManagement.psm1
After that you can run: Get-HybridAgent -credential (get-credential) to view agent status:
Note: the ‘id’ value provided in the above snip is the agent identity and not your unique tenant guid assigned to the route.
Directing your Hybrid Agent(s) to the load balancer instead of a specific server
If you would like your Hybrid Agent(s) to direct requests to your load balancer instead of a specific Exchange Client Access Server, this can be done with the Hybrid Management PowerShell module. In preview, the Hybrid Agent supports routing requests to the load balancer for Exchange Server 2013 – 2019 Client Access Servers. You cannot use this if you only have Exchange Server 2010 CAS deployed. Follow the steps above to import the Hybrid Management module for PowerShell. From PowerShell, then simply use the Update-HybridApplication cmdlet to change the value of the internalURL (targetURI parameter) from a specific server to your load balancer endpoint. Before running this cmdlet you will need to get the unique guid value (e.g. 12345678-1234-1234-1234-1111111111111) of your tenant’s endpoint from either your MRS configuration or the Organization Relationship object (TargetSharingEPR). Example:PS C:\PowerShell> Get-OrganizationRelationship ((Get-OnPremisesOrganization).OrganizationRelationship) | Select-Object TargetSharingEpr
TargetSharingEpr
----------------
https://e399b770-3b66-407b-a71a-96ef80a67714.resource.mailboxmigration.his.msappproxy.net/EWS/Exchange.asmx
PS C:\PowerShell> Get-MigrationEndpoint "Hybrid Migration Endpoint - EWS (Default Web Site)" | Select-Object RemoteServer
RemoteServer
------------
e399b770-3b66-407b-a71a-96ef80a67714.resource.mailboxmigration.his.msappproxy.net
We really hope you are enjoying and benefitting from using the Hybrid Agent. We see a lot of usage and we’re working hard to improve it all the time.
Thank you!
Updated Jul 01, 2019
Version 2.0
The_Exchange_Team
Microsoft
Microsoft
