Applies to: Exchange Server 2013

Topic Last Modified: 2012-10-30

An organization relationship enables users in your Exchange organization to share calendar free/busy information as part of federated sharing with other federated Exchange organizations. Federated sharing can be configured between two federated Exchange 2013 organizations or between a federated Exchange 2013 organization and federated Exchange 2010 organizations.

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-premise Exchange organization must be configured. For details, see Configure a Federation Trust.

  • The external organization you want to configure in the organization relationship must have a federation trust established with the Microsoft Federation Gateway. 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.

What do you want to do?

Use the EAC to create an organization relationship

  1. On an Exchange 2013 server in your on-premises organization, navigate to the Organization > Sharing.

  2. Under Organization Sharing, and click New Add Icon.

  3. In Organization Relationship, in the Relationship name box, type a friendly name for the organization relationship.

  4. In the Domain to share with box, type the federated domain or federated subdomain for the external federated Exchange organization you want to configure for federated sharing. If you need to enter multiple domains for the external federated Exchange organization, separate the domains with a comma. For example,,

  5. Select the Enable calendar free/busy information sharing check box to set the sharing level for calendar free/busy information and to define the internal users who 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 specify which internal users will be sharing calendar free/busy information, select one of the following:

    • Everyone in your organization

    • A specified security group

      To specify a security group, click Browse.

  6. 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,, and

  • Free/busy access is enabled.

  • The requesting organization receives free/busy time, subject, and location information from the target organization.

Copy Code
New-OrganizationRelationship -Name "Contoso" -DomainNames "","","" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel LimitedDetails

This example attempts to automatically discover configuration information from the external Exchange organization 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.

Copy Code
Get-FederationInformation -DomainName | New-OrganizationRelationship -Name "Contoso" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel -LimitedDetails

For detailed syntax and parameter information, see Get-FederationInformation and New-OrganizationRelationship.

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, a federated domain of Fourth Coffee.

  • The Exchange Web Services application URL is

  • The Autodiscover URL is

  • Free/busy access is enabled.

  • The requesting organization receives only free/busy information with the time.

Copy Code
New-OrganizationRelationship -Name "Fourth Coffee" -DomainNames "" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel -AvailabilityOnly -TargetAutodiscoverEpr "" -TargetApplicationUri ""

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:

Copy Code
Get-OrganizationRelationship | format-list
Having problems? Ask for help in the Exchange forums. Visit the forums at: Exchange Server, Exchange Online, or Exchange Online Protection