New-OrganizationRelationship

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。

使用 New-OrganizationRelationship cmdlet 可以创建组织关系。 组织关系定义与外部 Exchange 组织一起使用的设置,以访问日历忙/闲信息,或在本地 Exchange 服务器和Exchange Online之间移动邮箱,作为混合部署的一部分。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

New-OrganizationRelationship
   [-Name] <String>
   -DomainNames <MultiValuedProperty>
   [-ArchiveAccessEnabled <Boolean>]
   [-Confirm]
   [-DeliveryReportEnabled <Boolean>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-FreeBusyAccessEnabled <Boolean>]
   [-FreeBusyAccessLevel <FreeBusyAccessLevel>]
   [-FreeBusyAccessScope <GroupIdParameter>]
   [-MailboxMoveCapability <MailboxMoveCapability>]
   [-MailboxMoveEnabled <Boolean>]
   [-MailboxMovePublishedScopes <MultiValuedProperty>]
   [-MailTipsAccessEnabled <Boolean>]
   [-MailTipsAccessLevel <MailTipsAccessLevel>]
   [-MailTipsAccessScope <GroupIdParameter>]
   [-OAuthApplicationId <String>]
   [-OrganizationContact <SmtpAddress>]
   [-PhotosEnabled <Boolean>]
   [-TargetApplicationUri <Uri>]
   [-TargetAutodiscoverEpr <Uri>]
   [-TargetOwaURL <Uri>]
   [-TargetSharingEpr <Uri>]
   [-WhatIf]
   [<CommonParameters>]

说明

在创建组织关系前必须首先建立联合信任。 有关详细信息,请参阅 联合身份验证

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

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

本示例将创建与 Contoso 的组织关系。 要连接到的域名为 contoso.com。 使用下列设置:

忙/闲访问已启用。

请求的组织接收来自目标组织的时间、主题和位置信息。

本示例将尝试使用 Get-FederationInformation 命令中提供的域名自动发现外部组织的配置信息。 如果使用此方法创建组织关系,则必须首先确保已使用 Set-FederationOrganizationIdentifier cmdlet 创建了组织标识符。

示例 2

New-OrganizationRelationship -Name "Fourth Coffee" -DomainNames "mail.fourthcoffee.com" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel AvailabilityOnly -TargetAutodiscoverEpr "https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity" -TargetApplicationUri "mail.fourthcoffee.com"

本示例将使用以下设置创建与 Fourth Coffee 的组织关系。 本示例中提供了与外部组织的连接设置。

连接的域为 mail.fourthcoffee.com。

Exchange Web 服务应用程序 URL 为 mail.fourthcoffee.com。

自动发现 URL 为 https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity

忙/闲访问已启用。

请求的组织仅收到与时间有关的忙/闲信息。

参数

-ArchiveAccessEnabled

ArchiveAccessEnabled 参数指定是否已配置组织关系以提供远程存档访问。 有效值包含:

  • $true:外部组织提供对邮箱存档的远程访问。
  • $false:外部组织不提供对邮箱存档的远程访问。 此值为默认值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Confirm

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet (例如,Remove-* cmdlet) 具有内置的暂停,该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 大多数其他 cmdlet (例如,New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DeliveryReportEnabled

DeliveryReportEnabled 参数指定是否应通过组织关系共享传递报告。 有效值包含:

  • $true:传递报告应通过组织关系共享。 此值表示组织已同意与外部组织共享所有传递报告,并且应使用组织关系从外部组织检索送达报告信息。
  • $false:不应通过组织关系共享传递报告。 此为默认值

若要在跨界 Exchange 方案中运行邮件跟踪,必须将此参数设置为在组织关系的两端$true。 如果将此参数的值设置为在组织关系的一方或两端$false,则组织之间的邮件跟踪不会在任一方向上工作。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

此参数只在本地 Exchange 中可用。

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainNames

DomainNames 参数指定外部组织的 SMTP 域。 可以指定用逗号分隔的多个域, (例如“contoso.com”、“northamerica.contoso.com”) ,在一个请求中限制为 238 个域。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Enabled

Enabled 参数指定是否启用组织关系。 有效值包含:

  • $true:已启用组织关系。 此值为默认值。
  • $false:禁用组织关系。 此值完全停止共享组织关系。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-FreeBusyAccessEnabled

FreeBusyAccessEnabled 参数指定是否应使用组织关系从外部组织检索忙/闲信息。 有效值包含:

  • $true:从外部组织检索忙/闲信息。
  • $false:不会从外部组织检索忙/闲信息。 此值为默认值。

可以使用 FreeBusyAccessLevel 和 FreeBusyAccessScope 参数控制忙/闲访问级别和范围。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-FreeBusyAccessLevel

FreeBusyAccessLevel 参数指定已返回到请求组织的最大详细信息量。 有效值包含:

  • 无:无忙/闲访问。
  • AvailabilityOnly:仅限时间的忙/闲访问。
  • LimitedDetails:具有时间、主题和位置的忙/闲访问。

仅当 FreeBusyAccessEnabled 参数值$true时,此参数才有意义。

Type:FreeBusyAccessLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-FreeBusyAccessScope

FreeBusyAccessScope 参数指定内部组织中启用邮件的安全组,其中包含外部组织可访问其忙/闲信息的用户。 可以使用任何能够唯一标识该组的值。 例如:

  • 名称
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • GUID

仅当 FreeBusyAccessEnabled 参数值$true时,此参数才有意义。

Type:GroupIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MailboxMoveCapability

此参数仅在基于云的服务中可用。

MailboxMoveCapability 参数用于跨租户邮箱迁移。 有效值包含:

  • 入境
  • 出站
  • RemoteInbound
  • RemoteOutbound

有关详细信息,请参阅 跨租户邮箱迁移

Type:MailboxMoveCapability
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-MailboxMoveEnabled

MailboxMoveEnabled 参数指定组织关系是否允许向外部组织移动邮箱或从外部组织移动邮箱。 有效值包含:

  • $true:允许邮箱移入或移出外部组织。
  • $false:不允许邮箱移入或移出外部组织。 此值为默认值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MailboxMovePublishedScopes

此参数仅在基于云的服务中可用。

MailboxMovePublishedScopes 参数用于跨租户邮箱迁移,以指定允许其成员迁移的已启用邮件的安全组。 可以使用任何能够唯一标识该组的值。 例如:

  • 名称
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • GUID

若要输入多个值,请使用以下语法: <value1>,<value2>,...<valueX>。 如果值包含空格或需要引号,请使用以下语法: "<value1>","<value2>",..."<valueX>"

有关详细信息,请参阅 跨租户邮箱迁移

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-MailTipsAccessEnabled

MailTipsAccessEnabled 参数指定是否通过此组织关系返回此组织中的用户的邮件提示。 有效值包含:

  • $true:此组织中的用户的邮件提示通过组织关系返回。
  • $false:此组织中的用户的邮件提示不会通过组织关系返回。 此值为默认值。

可以使用 MailTipsAccessLevel 参数控制 MailTips 访问级别。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MailTipsAccessLevel

MailTipsAccessLevel 参数指定通过此组织关系在外部共享的邮件提示数据的级别。 此参数可接受下列值:

  • 全部:返回所有邮件提示,但远程组织中的收件人被视为外部收件人。 对于自动答复邮件提示,将返回外部自动答复邮件。
  • 受限:仅返回可能阻止未送达报告 (NDR) 或自动答复的邮件提示。 不会返回自定义邮件提示、大型受众邮件提示和审查收件人邮件提示。
  • 无:不会将邮件提示返回到远程组织。 此值为默认值。

仅当 MailTipsAccessEnabled 参数值$true时,此参数才有意义。

Type:MailTipsAccessLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MailTipsAccessScope

MailTipsAccessScope 参数指定内部组织中已启用邮件的安全组,其中包含其忙/闲信息可由外部组织访问的用户。 可以使用任何能够唯一标识该组的值。 例如:

  • 名称
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • GUID

默认值为空白 ($null) ,这意味着未指定任何组。

如果使用此参数,则仅针对属于指定组成员的收件人返回特定于收件人的邮件提示。 收件人特定的邮件提示为:

  • 自动答复
  • 邮箱已满
  • 自定义警报

如果不使用此参数,则会为组织中的所有收件人返回特定于收件人的邮件提示。

此限制仅适用于邮箱、邮件用户和邮件联系人。 它不适用于通讯组。

Type:GroupIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Name

Name 参数指定组织关系的唯一名称。 最大长度为 64 个字符。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OAuthApplicationId

此参数仅在基于云的服务中可用。

OAuthApplicationId 用于跨租户邮箱迁移,以指定你同意的邮箱迁移应用的应用程序 ID。 有关详细信息,请参阅 跨租户邮箱迁移

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-OrganizationContact

OrganizationContact 参数指定可用于联系外部组织的电子邮件地址 (例如 administrator@fourthcoffee.com ,) 。

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PhotosEnabled

PhotosEnabled 参数指定是否通过组织关系返回内部组织中用户的照片。 有效值包含:

  • $true:此组织中的用户的照片通过组织关系返回。
  • $false:此组织中的用户的照片不会通过组织关系返回。 此值为默认值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TargetApplicationUri

TargetApplicationUri 参数指定外部组织的目标统一资源标识符 URI。 当请求外部组织的委托令牌以提取忙/闲信息(例如,mail.contoso.com)时,Exchange 会指定 TargetApplicationUri 参数。

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TargetAutodiscoverEpr

TargetAutodiscoverEpr 参数指定外部组织的 Exchange Web 服务的自动发现 URL, https://contoso.com/autodiscover/autodiscover.svc/wssecurity例如 。 Exchange 使用自动发现服务自动检测用于外部请求的正确 Exchange 服务器终结点。

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TargetOwaURL

TargetOwaURL 参数指定组织关系中定义的外部组织以前Outlook Web App) URL 的Outlook 网页版 (。 它用于在跨界 Exchange 方案中Outlook 网页版重定向。 配置此属性后,组织中的用户可以使用其当前Outlook 网页版 URL 访问外部组织中的Outlook 网页版。

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TargetSharingEpr

TargetSharingEpr 参数指定外部组织的目标 Exchange Web 服务的 URL。

如果使用此参数,则始终使用此 URL 访问外部 Exchange 服务器。 TargetAutodiscoverEpr 参数指定的 URL 不用于查找外部 Exchange 服务器。

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WhatIf

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

输入

Input types

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。