Modify an organization relationship in Exchange Online

Article
02/28/2024

An organization relationship lets users in your Microsoft 365 or Office 365 organization share calendar free/busy information with other Microsoft 365, Office 365, or on-premises Exchange organizations. You might want to change the settings of an organization relationship, such as changing the name, temporarily disabling calendar sharing, changing the access level, or changing which security group members share calendars.

To learn more about organization relationships, see Organization relationships in Exchange Online.

What do you need to know before you begin?

Estimated time to complete: 5 minutes.
You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the Permissions in Exchange Online article.
To connect to Exchange Online PowerShell, see Connect to Exchange Online PowerShell.
If you want to share calendars with an on-premises Exchange organization, the on-premises Exchange administrator has to set up an authentication relationship with the cloud (also known as "federation") and must meet minimum software requirements.

Use the Exchange admin center to add a domain to an organization relationship

In the EAC, go to Organization > Sharing > Organization sharing tab. Or, use Organization sharing.
On the Organization sharing tab of the Sharing page, select the organization relationship by clicking the name (don't select the round check box that appears next to the name).
In the details flyout that opens, verify that the General tab is selected, and then select Manage general settings.
In the Manage general settings flyout that opens, find the Domain name section, add the domain name in the box and then select Add . To remove an existing domain entry, select Delete next to the domain.
When you're finished on the Manage general settings flyout, select Save.

In the EAC, go to Organization > Sharing > Organization sharing tab. Or, use Organization sharing.
On the Organization sharing tab of the Sharing page, select the organization relationship by clicking the name (don't select the round check box that appears next to the name).
In the details flyout that opens, select the Sharing tab, and then select Manage sharing settings.
In the Manage sharing settings flyout that opens, toggle Enable calendar free/busy information sharing to Off.
When you're finished on the Manage sharing settings flyout, select Save.

Use the Exchange admin center to change the free/busy access level for the organization relationship

In the EAC, go to Organization > Sharing > Organization sharing tab. Or, use Organization sharing.
On the Organization sharing tab of the Sharing page, select the organization relationship by clicking the name (don't select the round check box that appears next to the name).
In the details flyout that opens, select the Sharing tab, and then select Manage sharing settings.
In the Manage sharing settings flyout that opens, verify that the Enable calendar free/busy information sharing toggle is On, and then select one of the following values:
- Calendar free/busy information with time only (default).
- Calendar free/busy information with time, subject, and location.
When you're finished on the Manage sharing settings flyout, select Save.

Use Exchange Online PowerShell to modify the organization relationship

This example adds the domain name service.contoso.com to the organization relationship Contoso.

$domains = (Get-OrganizationRelationship Contoso).DomainNames

$domains += 'service.contoso.com'

Set-OrganizationRelationship -Identity Contoso -DomainNames $domains

This example disables the organization relationship Contoso.

Set-OrganizationRelationship -Identity Contoso -Enabled $false

This example enables calendar availability information access for the organization relationship WoodgroveBank and sets the access level to AvailabilityOnly (calendar free/busy information with time only).
```
Set-OrganizationRelationship -Identity Contoso -FreeBusyAccessEnabled $true -FreeBusyAccessLevel AvailabilityOnly
```

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

How do you know that you've successfully modified an organization relationship?

To verify that you've successfully updated the organization relationship, replace <OrgRelationshipName> with the name of the organization relationship and run the following command to verify the settings:

Get-OrganizationRelationship -Identity "<OrgRelationshipName>" | Format-List