Create an organization relationship
Applies to: Exchange Server 2013
Set up an organization relationship to share calendar information with an external business partner. You can configure an organization relationship between two federated Exchange 2013 organizations or between a federated Exchange 2013 organization and federated Exchange 2010 organizations. You can also set up an organization relationship between your on-premises Exchange organization and a Microsoft 365 or Office 365 organization.
Creating an organization relationship is one of several steps in setting up federated sharing in your Exchange organization and requires the configuration of a federation trust for your on-premises Exchange organization.
To learn more about federated sharing, see Sharing.
What do you need to know before you begin?
Estimated time to complete: 15 minutes.
You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Calendar and Sharing Permissions" section in the Recipients Permissions topic.
An active federation trust for the on-premises Exchange organization must be configured. For details, see Configure a federation trust.
The external organization you want to configure in the organization relationship must also have a federation trust established with the Azure AD authentication system. You'll use the primary federated domain for the external Exchange organization when configuring the organization relationship.
For information about keyboard shortcuts that may apply to the procedures in this topic, see Keyboard shortcuts in the Exchange admin center.
Use the EAC to create an organization relationship
On an Exchange 2013 server in your on-premises organization, navigate to organization > sharing.
Under Organization Sharing, click New .
In new organization relationship, in the Relationship name box, type a friendly name for the organization relationship.
In the Domains to share with box, type the federated domain or federated subdomain for the Microsoft 365 or Office 365 or Exchange on-premises organization you want to let see your calendars. If you need to enter multiple domains for the external organization, separate the domains with a comma. For example, contoso.com, service.contoso.com.
Select the Enable calendar free/busy information sharing check box to turn on calendar sharing with the domains you listed. Set the sharing level for calendar free/busy information and set which users can share calendar free/busy information.
To set the free/busy access level, select one of the following:
Calendar free/busy information with time only
Calendar free/busy with time, subject, and location
To set which users will share calendar free/busy information, select one of the following:
Everyone in your organization
A specified security group
To specify a security group, click browse.
Click save to create the organization relationship.
Use the Shell to create an organization relationship
This example creates an organization relationship with Contoso, Ltd with the following conditions:
The organization relationship is enabled for contoso.com, northamerica.contoso.com, and europe.contoso.com.
Free/busy access is enabled.
The requesting organization receives free/busy time, subject, and location information from the target organization.
New-OrganizationRelationship -Name "Contoso" -DomainNames "contoso.com","northamerica.contoso.com","europe.contoso.com" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel LimitedDetails
This example attempts to automatically discover configuration information from the external Exchange organization Contoso.com by using the domain names provided in the Get-FederationInformation cmdlet. If you use this method to create your organization relationship, you must first make sure that you've created an organization identifier by using the Set-FederatedOrganizationIdentifier cmdlet.
Get-FederationInformation -DomainName Contoso.com | New-OrganizationRelationship -Name "Contoso" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel LimitedDetails
This example creates an organization relationship with Fourth Coffee. In this example, the connection settings with the external Exchange organization are provided. The following conditions apply:
The organization relationship is established with the domain fourthcoffee.com, a federated domain of Fourth Coffee.
The Exchange Web Services application URL is mail.fourthcoffee.com.
The Autodiscover URL is https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity.
Free/busy access is enabled.
The requesting organization receives only free/busy information with the time.
New-OrganizationRelationship -Name "Fourth Coffee" -DomainNames "fourthcoffee.com" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel AvailabilityOnly -TargetAutodiscoverEpr "https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity" -TargetApplicationUri "mail.fourthcoffee.com"
For detailed syntax and parameter information, see New-OrganizationRelationship.
How do you know this worked?
The successful completion of the New organization relationship wizard will be your first indication that the creation of the organization relationship worked as expected.
To further verify that you have successfully created the organization relationship, run the following Shell command to verify the organization relationship information:
Get-OrganizationRelationship | format-list
Having problems? Ask for help in the Exchange forums. Visit the forums at Exchange Server.