Export (0) Print
Expand All

New-OrganizationRelationship

Topic Last Modified: 2011-03-19

Use the New-OrganizationRelationship cmdlet to create a relationship with an external Microsoft Exchange Server 2010 organization for the purpose of accessing free/busy information access, securing e-mail using federated delivery, or moving mailboxes between on-premises Exchange servers and Outlook Live.


New-OrganizationRelationship -Name <String> -DomainNames <MultiValuedProperty> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-FederatedDeliveryEnabled <$true | $false>] [-FreeBusyAccessEnabled <$true | $false>] [-FreeBusyAccessLevel <None | AvailabilityOnly | LimitedDetails>] [-FreeBusyAccessScope <GroupIdParameter>] [-MailboxMoveEnabled <$true | $false>] [-Organization <OrganizationIdParameter>] [-OrganizationContact <SmtpAddress>] [-RemoteFederatedDeliveryTargetAddress <SmtpAddress>] [-TargetApplicationUri <Uri>] [-TargetAutodiscoverEpr <Uri>] [-TargetSharingEpr <Uri>] [-WhatIf [<SwitchParameter>]]

Parameter Required Type Description

DomainNames

Required

Microsoft.Exchange.Data.MultiValuedProperty

The DomainNames parameter specifies the SMTP domains of the external organization. If adding multiple domain names, separate each entry with a comma.

Name

Required

System.String

The Name parameter specifies the meaningful name of the organization relationship.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.

Enabled

Optional

System.Boolean

The Enabled parameter specifies whether to enable the sharing relationship. This parameter can be used to completely stop sharing for a particular relationship. The valid values for this parameter are $true or $false. The default value is $true.

FederatedDeliveryEnabled

Optional

System.Boolean

The FederatedDeliveryEnabled parameter specifies whether e-mail messages are sent in encrypted format and delivered as if they came from an internal server with internal addresses resolved, unsolicited e-mail and virus filtering results preserved, and trusted system data preserved. The valid values for this parameter are $true or $false. The default value is $false.

If you set this parameter to $true, you must specify the SMTP address of the RemoteFederatedDeliveryTargetAddress parameter.

FreeBusyAccessEnabled

Optional

System.Boolean

The FreeBusyAccessEnabled parameter specifies whether this organization relationship should be used for retrieving free/busy information from the external organization. The valid values for this parameter are $true or $false. The default value is $false.

FreeBusyAccessLevel

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.FreeBusyAccessLevel

The FreeBusyAccessLevel parameter specifies the maximum amount of detail that's returned to the requesting organization.

You can use the following values:

  • None   No free/busy access
  • AvailabilityOnly   Free/busy access with time only
  • LimitedDetails   Free/busy access with time, subject, and location

FreeBusyAccessScope

Optional

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

The FreeBusyAccessScope parameter specifies a security distribution group in the internal organization that contains users that can have their free/busy information accessed by an external organization. You can use the following values:

  • Distinguished name (DN)
  • Canonical name
  • GUID
  • Name
  • Display name

MailboxMoveEnabled

Optional

System.Boolean

The MailboxMoveEnabled parameter specifies whether the organization relationship is used for moving mailboxes to the external organization. If this parameter isn't set, the move requests require an administrator to provide a remote credential for the remote organization.

Organization

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

The Organization parameter is reserved for internal Microsoft use.

OrganizationContact

Optional

Microsoft.Exchange.Data.SmtpAddress

The OrganizationContact parameter specifies the e-mail address that can be used to contact the external organization, for example, administrator@fourthcoffee.com.

RemoteFederatedDeliveryTargetAddress

Optional

Microsoft.Exchange.Data.SmtpAddress

The RemoteFederatedDeliveryTargetAddress parameter specifies the SMTP address to use for federated delivery e-mail messages, for example, administrator@fourthcoffee.com.

TargetApplicationUri

Optional

System.Uri

The TargetApplicationUri parameter specifies the target URI of the external organization. The TargetApplicationUri parameter is specified by Exchange when requesting a delegated token for the external organization to fetch free and busy information, for example, mail.contoso.com.

TargetAutodiscoverEpr

Optional

System.Uri

The TargetAutodiscoverEpr parameter specifies the Autodiscover URL of Exchange Web Services for the external organization, for example, https://contoso.com/autodiscover/autodiscover.svc/wssecurity. Exchange uses the Autodiscover service to automatically detect the correct Client Access server endpoint for external requests.

TargetSharingEpr

Optional

System.Uri

The TargetSharingEpr parameter specifies the URL of the target Exchange Web Services for the external organization. If the TargetSharingEpr parameter is used, Exchange always uses this URL to reach the external Client Access server and doesn't use the TargetAutodiscoverEpr parameter information to locate the Client Access server.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch.

Before you can create an organization relationship, you must first create a federation trust. For more information, see Understanding Federation.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Organization relationships" entry in the Mailbox Permissions topic.

Error Description

 

This example creates an organization relationship with Contoso. The domain names to connect to are contoso.com, northamerica.contoso.com, and europe.contoso.com. The following settings are used:

  • Free/busy access is enabled.
  • The requesting organization receives time, subject, and location information from the target organization.

This example attempts to automatically discover configuration information from the external organization by using the domain names provided in the Get-FederationInformation command. If you use this method to create your organization relationship, you must first ensure that you've created an organization identifier by using the Set-FederationOrganizationIdentifier cmdlet.

Get-FederationInformation -DomainName Contoso.com | New-OrganizationRelationship -Name "Contoso" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel -LimitedDetails

This example creates the organization relationship with Fourth Coffee using the following settings. In this example, the connection settings with the external organization are provided.

  • The domain to connect to is mail.fourthcoffee.com.
  • 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 only receives free/busy information with the time.
New-OrganizationRelationship -Name "Fourth Coffee" -DomainNames "mail.fourthcoffee.com" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel -AvailabilityOnly -TargetAutodiscoverEpr "https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity" -TargetApplicationUri "mail.fourthcofee.com"
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft