Set-HybridConfiguration

此 cmdlet 仅适用于本地 Exchange。

使用 Set-HybridConfiguration cmdlet 修改本地 Exchange 组织和 Microsoft 365 企业Exchange Online之间的混合部署。

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

语法

Default (默认值)

Set-HybridConfiguration

    [-ClientAccessServers <MultiValuedProperty>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Domains <MultiValuedProperty>]
    [-EdgeTransportServers <MultiValuedProperty>]
    [-ExternalIPAddresses <MultiValuedProperty>]
    [-Features <MultiValuedProperty>]
    [-Name <String>]
    [-OnPremisesSmartHost <SmtpDomain>]
    [-ReceivingTransportServers <MultiValuedProperty>]
    [-SecureMailCertificateThumbprint <String>]
    [-SendingTransportServers <MultiValuedProperty>]
    [-ServiceInstance <Int32>]
    [-TlsCertificateName <SmtpX509Identifier>]
    [-TransportServers <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

说明

Set-HybridConfiguration cmdlet 修改混合配置功能,例如启用安全邮件、为混合功能指定特定邮箱服务器,或启用或禁用本地 Exchange 与 Exchange Online 之间的忙/闲共享。

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Set-HybridConfiguration -SecureMailCertificateThumbprint AC00F35CBA8359953F4126E0984B5CCAFA2F4F17

在 Exchange Server 2010 中,此示例指定混合配置使用指纹AC00F35CBA8359953F4126E0984B5CCAFA2F4F17证书作为安全邮件消息的证书。

示例 2

Set-HybridConfiguration -Features OnlineArchive,MailTips,OWARedirection,FreeBusy,MessageTracking

此示例禁用安全邮件和集中式传输混合部署功能,但保留在本地 Exchange 和 Exchange Online 组织之间启用Exchange Online 存档、邮件提示、Outlook 网页版重定向、忙/闲和邮件跟踪功能。

示例 3

Set-HybridConfiguration -TlsCertificateName "<I>CN=A. Datum Corporation CA-3, OU=www.adatum.com, O=A.Datum Corp, C=US<S>CN=mail.contoso.com, O=Barbara Zighetti, L=Seattle, S=WA, C=US"

此示例指定混合部署使用定义的 TLS 证书,该证书由 CA 颁发的 X.509 证书的颁发者和 Subject 属性的组合引用。

参数

-ClientAccessServers

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

此参数仅在 Exchange Server 2010 中可用。

ClientAccessServers 参数指定Exchange Server 2010 SP2 或更高版本中配置为支持混合部署功能的中心传输服务器。 需要在 TCP 端口 80 和 443 上指定至少一台可从 Internet 访问的客户端访问服务器。 服务器配置为启用以下功能:

  • 邮箱复制服务 (MRS) 代理:启用 MRS 代理服务配置。
  • 虚拟目录:托管 Exchange Web Services (EWS) 、脱机通讯簿和 ActiveSync 服务的默认网站。
  • Outlook Anywhere:已启用。

可以指定用逗号分隔的多个服务器。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Confirm

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

  • 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DomainController

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Domains

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Domains 参数指定混合部署中使用的域命名空间。 必须在本地 Exchange 或 Exchange Online 中将这些域配置为接受的域。 这些域用于配置混合配置使用的组织关系以及发送和接收连接器。

可以指定多个域,中间用逗号隔开。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-EdgeTransportServers

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

EdgeTransportServers 参数指定将配置为支持混合部署功能的边缘传输服务器。 必须从端口 25 从 Internet 外部访问边缘传输服务器。 EdgeTransportServers 参数接受的值是边缘传输服务器的完整或短计算机名称,例如 edge.corp.contoso.com 或 EDGE。 如果定义不止一个边缘传输服务器,使用逗号隔开服务器名称。

在配置 EdgeTransportServers 参数时,必须将 ReceivingTransportServers 和 SendingTransportServers 参数值配置为 $null。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ExternalIPAddresses

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

ExternalIPAddresses 参数是一个旧参数,用于指定 Microsoft Exchange Server 2010 中心传输服务器的可公开访问的入站 IP 地址。

应使用此参数仅更改或清除旧版 Exchange 2010 中心传输服务器 IP 地址值。 不支持 IPv6 地址。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Features

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Features 参数指定为混合配置启用的功能。 有效值包含:

  • OnlineArchive:为本地 Exchange 和Exchange Online用户启用Exchange Online存档。
  • FreeBusy:启用本地 Exchange 与Exchange Online用户之间的日历闲/忙共享。
  • 邮件提示:在本地 Exchange 与Exchange Online用户之间启用邮件提示。
  • MessageTracking:启用本地 Exchange 与 Exchange Online 之间的邮件跟踪。
  • OWARedirection:启用自动Outlook 网页版 ((以前称为 Outlook Web App 或 OWA),) 重定向到本地 Exchange 或 Exchange Online,具体取决于用户邮箱所在的位置。
  • SecureMail:在本地 Exchange 与 Exchange Online 之间通过传输层安全性 (TLS) 启用安全邮件传输。
  • 集中式:使本地 Exchange 服务器能够处理本地 Exchange 与Exchange Online之间的所有消息传输,包括这两个组织向 Internet 传递消息。 如果不使用此值,则本地 Exchange 和 Exchange Online各自负责自己的 Internet 消息传递。
  • 照片:启用在本地 Exchange 与 Exchange Online 之间共享用户照片数据。 此功能与混合部署中的 OrganizationRelationship cmdlet 中的 PhotosEnabled 参数协同工作。 如果使用此值,则 PhotosEnabled 参数将自动设置为 $true。 如果不使用此值,则 PhotosEnabled 参数将自动设置为 $false。

可以指定用逗号分隔的多个值。 使用混合配置向导时,默认情况下会启用所有功能。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Name

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

此参数已弃用,不再使用。

Exchange 组织中只能有一个 HybridConfiguration 对象。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-OnPremisesSmartHost

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

OnPremisesSmartHost 参数指定用于在本地 Exchange 与 Exchange Online 之间安全传输邮件的本地 Exchange 邮箱服务器的 FQDN。

参数属性

类型:SmtpDomain
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ReceivingTransportServers

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

ReceivingTransportServers 参数指定在 Exchange Online 的出站连接器配置中定义的邮箱服务器。 有效值包含:

  • 邮箱服务器 FQDN (例如,mbx.corp.contoso.com) 。
  • 邮箱服务器主机名 (例如 MBX) 。

可以指定由逗号指定的多个服务器。

指定的服务器在混合部署中接收从 Exchange Online发送到本地 Exchange 的安全电子邮件。 需要指定至少一个可公开访问的邮箱服务器才能启用安全邮件。

使用 EdgeTransportServers 参数时,此参数的值 ($null) 必须为空。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-SecureMailCertificateThumbprint

适用:Exchange Server 2010

此参数仅在 Exchange Server 2010 中可用。

SecureMailCertificateThumbprint 参数指定要用作混合部署安全消息传输证书的 X.509 证书的指纹。 此证书不能自签名,必须从受信任的证书颁发机构 (CA) 获取,并且必须安装在 TransportServers 参数中定义的所有中心传输服务器上。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-SendingTransportServers

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

SendingTransportServers 参数指定在 Exchange Online 的入站连接器配置中定义的邮箱服务器。 有效值包含:

  • 邮箱服务器 FQDN (例如,mbx.corp.contoso.com) 。
  • 邮箱服务器主机名 (例如 MBX) 。

可以指定由逗号指定的多个服务器。

指定的服务器将安全电子邮件从本地 Exchange 发送到混合部署中的Exchange Online。 需要指定至少一个可公开访问的邮箱服务器才能启用安全邮件。

使用 EdgeTransportServers 参数时,此参数的值 ($null) 必须为空。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ServiceInstance

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

此参数仅在由世纪互联在中国运营的Office 365有意义。

若要使用中国世纪互联运营的 Office 365 手动配置混合部署,请将此参数的值设置为 1。 否则,默认值为 0。

所有其他Microsoft 365 组织应使用混合配置向导来配置混合部署。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-TlsCertificateName

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

TlsCertificateName 参数指定 TLS 加密要使用的 X.509 证书。 此参数的有效语法为 "<I>X.500Issuer<S>X.500Subject"

  • X.500Issuer:证书的“颁发者”字段中的值。
  • X.500Subject:证书的“使用者”字段中的值。

可以通过运行 Get-ExchangeCertificate cmdlet 查找这些值。

或者,在运行 Get-ExchangeCertificate 查找证书的指纹值后,请在 命令 $TLSCert = Get-ExchangeCertificate -Thumbprint <Thumbprint>中使用指纹值 ,运行 命令 $TLSCertName = "<I>$($TLSCert.Issuer)<S>$($TLSCert.Subject)",然后使用此参数的值 $TLSCertName

参数属性

类型:SmtpX509Identifier
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-TransportServers

适用:Exchange Server 2010

此参数仅在 Exchange Server 2010 中可用。

TransportServers 参数指定 Exchange Server 2010 SP2 或更高版本中配置为支持混合部署功能的中心传输服务器。

需要指定至少一个可从 Internet 访问的中心传输服务器,以便在本地 Exchange 与 Exchange Online 之间安全发送邮件。

可以指定用逗号分隔的多个服务器。

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-WhatIf

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

Input types

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

输出

Output types

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