在 Exchange 中配置与 Outlook 网页版 的即时消息集成

  • 项目

若要在 exchange 2016 或 Exchange 2019 中配置即时消息 (IM) 集成Skype for Business Server与以前称为Outlook Web App) Outlook 网页版 (的集成，需要使用 Exchange 命令行管理程序。 这与需要编辑 Web.config 文件的早期版本 Exchange 不同。 如果你编辑 Web.config 文件，而未按本主题中的步骤操作，那么设置会遭到忽略，而且 Web 上的 Outlook 用户也会看到以下错误消息：

There's a problem with instant messaging. Please try again later.

另外，Exchange 服务器上会生成以下运行状况设置错误：

  • HealthSet： OWA.Protocol.Dep

  • 主题： OWA.Protocol.Dep health set unhealthy (OwaIMInitializationFailedMonitor/OWA.Protocol.Dep) - Owa InstantMessaging provider failed to intialize

  • 消息： Owa InstantMessaging provider failed to initialize due to incorrect IM configuration on the server. Signin attempts to OWA IM will fail. Error Message: {Instant Messaging Certificate Thumbprint is null or empty on web.config).

使用本主题中的过程修复这些错误并在 Skype for Business Server 与 Exchange 2016 或 Exchange 2019 之间配置 IM 集成。 不支持 Lync Server 2013 与 Exchange 2016 或更高版本之间的 IM 集成。 有关使用以前称为Outlook Web App) Outlook 网页版 (设置Skype for Business Server的详细信息，请参阅配置本地Skype for Business Server与Outlook Web App

开始前，有必要了解什么？

  • 估计完成时间：5 分钟

  • 配置 Exchange 和 Skype for Business 集成需要使用所有涉及的服务器信任的服务器证书。 按照本主题中的过程执行操作的前提是，你已经拥有所需的证书。 有关详情，请参阅计划集成 Skype for Business Server 2015 和 Exchange。 所需的 IM 证书指纹是指分配给 IIS 服务的Exchange Server证书。

  • 只能使用 PowerShell 执行此过程。 若要了解如何在本地 Exchange 组织中打开 Exchange 命令行管理程序，请参阅 Open the Exchange Management Shell。

  • 您必须先获得权限，然后才能执行此过程或多个过程。 若要查看所需的权限，请参阅 客户端和移动设备权限主题中的"客户端访问虚拟目录设置"条目。

  • 根据Skype for Business Server拓扑，你可能有多个前端池，应选择区域终结点 (离 exchange AD 站点最近的池) ：IMServerName=<Skype Server\pool Name>。

提示

是否有任何疑问？ 请在 Exchange 论坛中寻求帮助。 请访问以下论坛：Exchange Server、Exchange Online 或 Exchange Online Protection。

使用 Exchange 命令行管理程序 配置与 Web 上的 Outlook 的 IM 集成。

第 1 步：指定 IM 服务器和 IM 证书指纹

在 Exchange 命令行管理程序 中使用以下语法，指定 IM 服务器和 IM 证书指纹：

New-SettingOverride -Name "<UniqueOverrideName>" -Component OwaServer -Section IMSettings -Parameters @("IMServerName=<Skype server/pool  name>","IMCertificateThumbprint=<Certificate Thumbprint>") -Reason "<DescriptiveReason>" [-Server <ServerName>]

注意：

  • 若要在 Active Directory 林中的所有 Exchange 2016 和 Exchange 2019 服务器上配置相同的设置，请不要使用 Server 参数。

  • 若要在特定 Exchange 2016 或 Exchange 2019 服务器上配置设置，请使用 Server 参数，服务器名称 (不使用完全限定的域名或 FQDN) 。 如果你需要在各个 Exchange 服务器上指定不同的设置，则会发现此方法非常有用。

此示例指定组织中所有 Exchange 2016 和 Exchange 2019 服务器上的 IM 服务器和 IM 证书指纹。

  • 设置替代名称：“IM 替代” (必须唯一)

  • Skype for Business服务器名称：skype01.contoso.com

  • 证书指纹：CDF34A740E9D225A1A06193A9D44B2CE22775308

  • 替代原因：配置 IM

New-SettingOverride -Name "IM Override"  -Component OwaServer -Section IMSettings -Parameters @("IMServerName=skype01.contoso.com","IMCertificateThumbprint=CDF34A740E9D225A1A06193A9D44B2CE22775308") -Reason "Configure IM"

此示例只在名为 Mailbox01 的服务器上指定 IM 服务器和 IM 证书指纹。

New-SettingOverride -Name "Mailbox01 IM Override"  -Component OwaServer -Section IMSettings -Parameters @("IMServerName=skype01.contoso.com","IMCertificateThumbprint=CDF34A740E9D225A1A06193A9D44B2CE22775308") -Reason "Configure IM" -Server Mailbox01

第 2 步：在 Exchange 服务器上刷新 IM 设置

在 Exchange 命令行管理程序 中使用以下语法，刷新服务器上的 IM 设置。 你需要在用于Outlook 网页版的每个 Exchange 2016 或 Exchange 2019 服务器上执行此操作。

Get-ExchangeDiagnosticInfo -Server <ServerName> -Process Microsoft.Exchange.Directory.TopologyService -Component VariantConfiguration -Argument Refresh

此示例在名为 Mailbox01 的服务器上刷新 IM 设置。

Get-ExchangeDiagnosticInfo -Server Mailbox01 -Process Microsoft.Exchange.Directory.TopologyService -Component VariantConfiguration -Argument Refresh

步骤 3：重启 Exchange 服务器上的Outlook 网页版池

在 Exchange 命令行管理程序 或服务器上的 Windows PowerShell 中运行以下命令。 你需要在用于Outlook 网页版的每个 Exchange 2016 或 Exchange 2019 服务器上执行此操作。

Restart-WebAppPool MSExchangeOWAAppPool

续订或更改 Exchange IIS 证书时，使用 Exchange 命令行管理程序更新与 Outlook 网页版的现有 IM 集成

步骤 1：更新现有替代上的 IM 证书指纹

在 Exchange 命令行管理程序中使用以下语法指定新的 IM 证书指纹：

Set-SettingOverride -Name "<UniqueOverrideName>" -Parameters @("IMCertificateThumbprint=<Certificate Thumbprint>") -Reason "<DescriptiveReason>" [-Server <ServerName>]

注意：

  • 若要更新 Active Directory 林中所有 Exchange 2016 和 Exchange 2019 服务器上的指纹，请不要使用 Server 参数。

  • 若要更新特定 Exchange 2016 或 Exchange 2019 服务器上的指纹，请使用 Server 参数，服务器名称 (不使用完全限定的域名或 FQDN) 。 如果你需要在各个 Exchange 服务器上指定不同的设置，则会发现此方法非常有用。

本示例更新组织中所有 Exchange 2016 和 Exchange 2019 服务器上的 IM 证书指纹。

  • 设置替代名称：“IM 替代” (必须使用前面步骤中已有的替代名称，因为我们正在更新，而不是创建新的)

  • Skype for Business服务器名称：skype01.contoso.com

  • 证书指纹：NKT34A740E9D225A1A06193A9D44B2CE22771080

  • 替代原因：配置 IM

Set-SettingOverride -Name "<UniqueOverrideName>" -Component OwaServer -Section IMSettings -Parameters @("IMServerName=<Skype server/pool  name>","IMCertificateThumbprint=<Certificate Thumbprint>") -Reason "<DescriptiveReason>" [-Server <ServerName>]

此示例只在名为 Mailbox01 的服务器上指定 IM 服务器和 IM 证书指纹。

Set-SettingOverride -Identity "Mailbox01 IM Override"  -Parameters @("IMServerName=skype01.contoso.com","IMCertificateThumbprint=NKT34A740E9D225A1A06193A9D44B2CE22771080") -Reason "Configure IM" -Server Mailbox01

第 2 步：在 Exchange 服务器上刷新 IM 设置

在 Exchange 命令行管理程序 中使用以下语法，刷新服务器上的 IM 设置。 你需要在用于Outlook 网页版的每个 Exchange 2016 或 Exchange 2019 服务器上执行此操作。

Get-ExchangeDiagnosticInfo -Server <ServerName> -Process Microsoft.Exchange.Directory.TopologyService -Component VariantConfiguration -Argument Refresh

此示例在名为 Mailbox01 的服务器上刷新 IM 设置。

Get-ExchangeDiagnosticInfo -Server Mailbox01 -Process Microsoft.Exchange.Directory.TopologyService -Component VariantConfiguration -Argument Refresh

步骤 3：重启 Exchange 服务器上的Outlook 网页版池

在 Exchange 命令行管理程序 或服务器上的 Windows PowerShell 中运行以下命令。 你需要在用于Outlook 网页版的每个 Exchange 2016 或 Exchange 2019 服务器上执行此操作。

Restart-WebAppPool MSExchangeOWAAppPool

如何知道操作成功？

如果错误消息消失且客户端能够登录 IM，即说明你已成功配置了与 Web 上的 Outlook 的 IM 集成。

若要验证 Exchange 服务器上的 IMServerName 和 IMCertificateThumbprint 属性的值，请将 ServerName> 替换为<服务器的名称 (而不是 FQDN) ，并运行以下命令：

[xml]$diag=Get-ExchangeDiagnosticInfo -Server <ServerName> -Process MSExchangeMailboxAssistants -Component VariantConfiguration -Argument "Config,Component=OwaServer"; $diag.Diagnostics.Components.VariantConfiguration.Configuration.OwaServer.IMSettings

注意：在 Exchange 2016 CU3 或更早版本中，需要对某些参数使用不同的值：

  • 进程： Microsoft.Exchange.Directory.TopologyService (而不是 MSExchangeMailboxAssistants) 。

  • 参数： Config (而不是 "Config,Component=OwaServer") 。