Pairing Environments, Domains, and Attributes

What is pairing?

Pairing in this context means to identify the source and target relationships in your project. There are three (3) pairing types in an Advanced or Premium project. Those are tenant environment pairing, the accepted domain pairing and the object attribute pairing.


Why is pairing required?

Pairing environments, domains and objects are important because without designating the source and target locations, it will not be possible to migrate data, match objects, orchestrate mail flow or translate email addresses.


When do I setup my pairings?

The project setup wizard will ask a few questions about the required pairings. And authorized administrators may update pairings when needed.


How do I setup environment pairings?

After adding your tenants in the project setup wizard, it is time to set up your tenant pairs. This is where you identify the source and target relationships in your project.

Power365 will use this information as it guides you through configuring your project. You start with your tenants, and then it’s just a matter of “from” and “to.” From what tenant would you like to migrate accounts? And to where are they going?

With only two tenants it might be just a simple one-to-one relationship. If you have multiple tenants like in a divestiture, you may need to set up several tenant pairings.


How do I setup domain pairings?

After setting up tenant pairs, the next step is to pair the domains. Domain Pairing is setting up accepted domains from the source tenant with accepted domains in the target.

When an account is setup in the target, the email address is automatically stamped with the paired domain in the target. The default domain might be a different domain altogether, so pairing makes sure you know what you will have in the target after migration.

Create one pairing at time. Choose an accepted domain from the source. And then a domain from the target. That’s the basic pairing.

Create whatever combination of domain pairings meets your needs. You can do a simple one-to-one relationship, or pair several source domains to a single target domain.


How do I setup attribute pairings?

After setting up domain pairs, the next step is to pair the attributes for the purposes of matching objects between environments. Attribute Pairing is setting up value pairs from the source object and the target object.

For more detailed information about attribute pairing, see the Prerequisites Guide.


Additional Information

Quick-Start Guide (PDF)

Prerequisites (PDF)

Application Permissions


Tenant Environments

Manage Scope