为 SharePoint 2013 配置 Office Web Apps

 

适用于:SharePoint Server 2013、SharePoint Foundation 2013、Office Web 应用

总结:说明如何将 SharePoint 2013 配置为使用 Office Web 应用。

目标用户:IT 专业人员

本文介绍部署 Office Web 应用 Server 中断的位置。 在本文中,你设置了运行 Office Web 应用 Server 的服务器。 在本示例中,你将将 SharePoint 2013 配置为使用 Office Web 应用 Server。 首先,需要从 SharePoint 2013 运行几个Windows PowerShell cmdlet,之后用户将能够从浏览器中的 SharePoint 2013 文档库打开 Office 文件。

如果不熟悉 Office Web 应用 Server 的功能,检查概述主题

本文内容:

  • 将 SharePoint 2013 配置为使用 Office Web 应用 Server 之前

  • 将 SharePoint 2013 配置为使用 Office Web 应用 Server

  • 对与 SharePoint 2013 结合使用时 Office Web Apps 中的错误进行故障排除

  • 断开 SharePoint 2013 与 Office Web 应用 Server 的连接

在将 SharePoint 2013 配置为使用 Office Web 应用 Server 之前

在开始之前检查几个事项:

  • 安装 SharePoint 2013。 有关指导,请参阅 安装 SharePoint 2013

  • 确保所有 SharePoint 2013 Web 应用程序都使用基于声明的身份验证。 Office Web 应用呈现和编辑不适用于使用经典模式身份验证的 SharePoint 2013 Web 应用程序。 有关详细信息,请参阅 Office Web 应用的 SharePoint 身份验证要求

  • 若要使用户能够在 Web 浏览器中编辑(而不仅仅是阅读)Office 文档,你需要一个编辑许可证。 此外,还需要在 Office Web 应用 服务器场上启用编辑。 有关许可要求的详细信息,请参阅许可 Office Web 应用编辑 Office 文件

  • 如果使用系统帐户登录到 SharePoint 2013,将无法测试 SharePoint 2013 与 Office Web 应用 Server 之间的连接。 使用其他帐户登录,以测试连接。

  • 内存不足可能会导致 Office Web 应用中的 Office 文档预览失败。 查看 SharePoint 2013 的硬件要求 - Web 服务器、应用程序服务器和单一服务器安装一文。 这些是 Office Web 应用 Server 使用的相同要求。

将 SharePoint 2013 配置为使用 Office Web 应用 Server

选择下列章节之一,具体取决于您要使用 HTTP 还是 HTTPS。 HTTP 通常仅建议用于测试环境。 在生产环境中,最好使用更为安全的 HTTPS 协议。

在使用 HTTP 的测试环境中

对于此配置,请确保已按照在测试环境中部署单服务器 Office Web 应用 服务器场中的步骤设置 Office Web 应用 Server。 请务必将 Office Web 应用 服务器场配置为使用内部 URL 和 HTTP。 视频:配置 Office Web 应用 for SharePoint 2013 演示了如何设置 Office Web 应用 Server 并将 SharePoint 2013 配置为在测试环境中使用 Office Web 应用 Server。

步骤 1:打开提升的 SharePoint 2013 命令行管理程序

选择与服务器操作系统对应的过程。

在 Windows Server 2008 R2 中

  1. 单击“ 启动>所有程序>”“Microsoft SharePoint 2013 产品”。

  2. 右键单击“ SharePoint 2013 命令行管理程序”,然后单击“ 以管理员身份运行”。

在 Windows Server 2012 中打开

  1. 按 Windows 徽标键 + Q,或从屏幕边缘向内轻扫以显示超级按钮,然后单击“ 搜索 ”查看计算机上安装的所有应用程序。

  2. 右键单击“ SharePoint 2013 命令行管理程序 ”以显示应用栏。

  3. 在应用栏中,单击“ 以管理员身份运行”。

步骤 2:在 SharePoint 2013 和 Office Web 应用 Server 之间创建绑定

运行以下命令,其中 <WacServerName> 是你为内部 URL 设置的 URL (FQDN) 完全限定的域名。 这是 Office Web 应用 服务器流量的入口点。 对于此测试环境,需要指定 –AllowHTTP 参数,以允许 SharePoint 2013 使用 HTTP 从 Office Web 应用 服务器场接收发现信息。 如果未指定 –AllowHTTP,SharePoint 2013 将尝试使用 HTTPS 与 Office Web 应用 服务器场通信,此命令将不起作用。

    New-SPWOPIBinding -ServerName <WacServerName> -AllowHTTP

运行此命令后,应会看到Windows PowerShell命令提示符处显示的绑定列表。

需要帮助? 请参阅 New-SPWOPIBinding

步骤 3:查看 SharePoint 绑定的 WOPI 区域

Office Web 应用 Server 使用区域来确定 (内部或外部) 的 URL,以及与主机(在本例中为 SharePoint 2013)通信时要使用的 HTTP 或 HTTPS) (协议。 默认情况下,SharePoint Server 2013 使用 内部 https 区域。 通过运行以下命令来确认这是当前区域:

    Get-SPWOPIZone

此命令显示的 WOPI 区域应为 internal-http。 如果正确显示,请跳到步骤 5。 如果不是,请参阅下一步。

需要帮助? 请参阅 Get-SPWOPIZone

步骤 4:将 WOPI 区域更改为 internal-http

如果通过执行步骤 3 获得的结果为 internal-https,则运行以下命令可将区域更改为 internal-http。 您需要进行此更改,因为 SharePoint 2013 的区域必须与 Office Web 应用 服务器场的区域匹配。

    Set-SPWOPIZone -zone "internal-http"

再次运行 Get-SPWOPIZone ,确认新的区域为 internal-http

需要帮助? 请参阅 Set-SPWOPIZoneGet-SPWOPIZone

步骤 5:将 SharePoint 2013 中的 AllowOAuthOverHttp 设置更改为 True

若要在测试环境中通过 HTTP 将 Office Web 应用与 SharePoint 2013 配合使用,需要将 AllowOAuthOverHttp 设置为 True。 否则,Office Web 应用将不起作用。 可通过运行以下示例来检查当前状态:

    (Get-SPSecurityTokenServiceConfig).AllowOAuthOverHttp

如果此命令返回 False,则运行下列命令可将其设置为 True

    $config = (Get-SPSecurityTokenServiceConfig)
    $config.AllowOAuthOverHttp = $true
    $config.Update()

再次运行以下命令来验证 AllowOAuthOverHttp 设置现在是否设置为 True

    (Get-SPSecurityTokenServiceConfig).AllowOAuthOverHttp

需要帮助? 请参阅 Get-SPSecurityTokenServiceConfig

步骤 6:验证 Office Web Apps 是否正常运行

在 SharePoint 2013 中,请确保未以系统帐户身份登录,因为无法使用 Office Web 应用编辑或查看文档。 转到包含 Office 文档的 SharePoint 2013 文档库,并查看Word、PowerPoint、Excel 或 OneNote 文件。 文档应在使用 Office Web 应用显示文件的浏览器中打开。

如果此步骤失败,请参阅排查 Office Web 应用 中的错误。

在使用 HTTPS 的生产环境中

在开始以下过程之前,请确保已按照部署使用 HTTPS 的单服务器 Office Web 应用 服务器场中的步骤或部署使用 HTTPS 的多服务器、负载均衡的 Office Web 应用 服务器场中的步骤设置 Office Web 应用 Server

步骤 1:打开 SharePoint 2013 命令行管理程序

选择与服务器操作系统对应的过程。

在 Windows Server 2008 R2 中

  1. 选择 “启动>所有程序>”“Microsoft SharePoint 2013 产品”。

  2. 右键单击“ SharePoint 2013 命令行管理程序 ”以显示快捷菜单,然后单击“ 以管理员身份运行”。

在 Windows Server 2012 中打开

  1. 按 Windows 徽标键 + Q,或从屏幕边缘向内轻扫以显示超级按钮,然后单击“ 搜索 ”查看计算机上安装的所有应用程序。

  2. 右键单击“ SharePoint 2013 命令行管理程序 ”以显示应用栏。

  3. 在应用栏中,单击“ 以管理员身份运行”。

步骤 2:在 SharePoint 2013 和 Office Web 应用 Server 之间创建绑定

运行以下命令,其中 <WacServerName> 是你为内部 URL 设置的 URL (FQDN) 完全限定的域名。 这是 Office Web 应用 服务器流量的入口点。

    New-SPWOPIBinding -ServerName <WacServerName> 

需要帮助? 请参阅 New-SPWOPIBinding

步骤 3:查看 SharePoint 2013 的 WOPI 区域

Office Web 应用 Server 使用区域来确定在与主机(在本例中为 SharePoint 2013)通信时 (内部或外部) 的 URL,以及 (HTTP 或 HTTPS) 使用的协议。 默认情况下,SharePoint Server 2013 使用 内部 https 区域。 通过运行以下命令来确认这是当前区域。

    Get-SPWOPIZone

请记下显示的 WOPI 区域。

需要帮助? 请参阅 Get-SPWOPIZone

步骤 4:如有必要,更改 WOPI 区域

根据您的环境,您可能需要更改 WOPI 区域。 如果您有一个既为内部又为外部的 SharePoint 场,则指定外部。 如果您有一个仅内部的 SharePoint 场,则指定内部。

如果步骤 3 的结果显示 internal-https 和 SharePoint 场仅限内部,则可以跳过此步骤。 如果具有既为内部又为外部的 SharePoint 场,则需要运行以下命令来将区域更改为 external-https

    Set-SPWOPIZone -zone "external-https"

需要帮助? 请参阅 Set-SPWOPIZone

步骤 5:验证 Office Web Apps 是否正常运行

在 SharePoint 2013 中,请确保未以系统帐户身份登录,因为无法使用 Office Web 应用编辑或查看文档。 转到包含 Office 文档的 SharePoint 2013 文档库,并查看Word、PowerPoint、Excel 或 OneNote 文件。 文档应在使用 Office Web 应用显示文件的浏览器中打开。

如果此步骤失败,请参阅排查 Office Web 应用 中的错误。

对与 SharePoint 2013 结合使用时 Office Web Apps 中的错误进行故障排除

如果 Office Web 应用与 SharePoint 2013 一起使用时无法正常工作,请找到以下症状,并展开标题以查找故障排除步骤。

下面是一些可尝试的故障排除选项。

验证用于创建新文档的 SharePoint Web 应用程序是否使用基于声明的身份验证

只有使用基于声明的身份验证的 Web 应用程序才能在 Office Web 应用中打开文件。 若要确定 Web 应用程序的身份验证提供程序,请执行以下步骤:

  1. 在 SharePoint 2013 管理中心中,单击“ 管理 Web 应用程序”。

  2. 选择要检查的 Web 应用程序,然后单击功能区上的“身份验证提供程序”。

身份验证提供程序必须显示为 Office Web 应用的基于声明的身份验证才能正确使用 Web 应用程序。 若要解决此问题,可以删除 Web 应用程序并使用基于声明的身份验证重新创建它,也可以更改 Web 应用程序的身份验证方法。 有关详细信息,请参阅 Office Web 应用的 SharePoint 身份验证要求

确保 SHAREPoint 2013 和 Office Web 应用 服务器场上的 WOPI 区域匹配。

为此,请在 SharePoint Server 上运行以下命令:

    Get-SPWopiZone 

结果将是以下选项之一:

  • internal-https

  • internal-http

  • external-https

  • external-http

接下来,在 SharePoint Server 上运行以下命令。

    Get-SPWOPIBinding

在输出中,查找 WopiZone: 区域。 如果 Get-SPWopiZone 的结果与 Get-SPWOPIBinding 返回的区域不匹配,请在 SharePoint Server 上运行 Set-SPWOPIZone -Zone cmdlet,以更改 WOPI 区域以匹配 Get-SPWOPIBinding 的结果。 有关使用这些 cmdlet 的帮助,请参阅 Get-SPWOPIBindingSet-SPWOPIBindingGet-SPWOPIZone

问题:尝试在 Office Web 应用中编辑 Office 文档时,收到“很抱歉,无法打开此文档进行编辑”错误。

在某些情况下,属于 Active Directory (AD) 安全组成员的用户可能无法在浏览器中编辑文档。 解决方案是确保正确配置用户配置文件服务应用程序 (UPA) 并与用户和组成员身份完全同步。 有关详细信息,请参阅知识库文章 SharePoint 2013 无法编辑具有安全组成员用户的 Office Web 应用 2013 文件

问题:尝试在 Office Web 应用中查看 Office 文档时,收到“抱歉,出现问题”错误。

请确保未以系统帐户身份登录,因为无法编辑或查看文档。 以其他用户身份登录,然后再次尝试访问 Office Web 应用。

问题:尝试在 Office Web 应用 中查看 Office 文档时,收到“抱歉,出现问题,无法打开此文档”错误。

如果在使用 HTTP 的测试环境中设置了 Office Web 应用,请确保将 AllowOAuthOverHttp 设置设置为 True,如步骤 5:将 SharePoint 2013 中的 AllowOAuthOverHttp 设置更改为 True 中所述。

如果使用 New-OfficeWebAppsHost cmdlet 将域添加到允许列表,请确保从允许列表中的主机域访问 Office Web 应用。 若要查看允许列表中的主机域,请在 Office Web 应用 服务器上以管理员身份打开Windows PowerShell提示并运行 Get-OfficeWebAppsHost cmdlet。 若要将域添加到允许列表,请使用 New-OfficeWebAppsHost cmdlet。

问题:收到“很抱歉,Word Web 应用无法打开此文档,因为服务正忙。 请尝试在 Office Web 应用 中查看 Office 文档时出现错误,请稍后重试。

  • 是否偶然在域控制器上安装 Office Web 应用 Server? 遗憾的是,Office Web 应用 Server 无法在域控制器上运行。 Office Web 应用 Server 必须安装在属于域的单独服务器上。 有关详细信息,请参阅 Office Web 应用 Server 的软件、硬件和配置要求

  • 请确保运行 SharePoint 2013 内部版本 15.0.4420.1017 或更高版本。 在 SharePoint 2013 服务器上,按照以下步骤验证内部版本号:

    1. 转到 启动>所有程序>Microsoft SharePoint 2013 产品>SharePoint 2013 管理中心

    2. 选择 “系统设置”“>管理此场中的服务器”。

    验证 配置数据库版本 是否为 15.0.4420.1017 或更高版本。 如果不是,请转到 Office、Office 服务器和相关产品的更新中心 了解详细信息。

问题:收到“找不到文件”。 原始文件的 URL 无效,或者文档不可公开访问。 验证 URL 是否正确,然后当你尝试使用用户生成的 URL 在 Office Web 应用中查看 Office 文档时,请与文档所有者联系“错误。

是否尝试从用户生成的 URL 打开文件大小大于 10 MB 的文档? 确保文档不超过 10 MB。

问题:Office 文档预览未显示在 SharePoint 2013 中。 而是显示“此内容不能显示在帧中”错误。

内存不足可能会导致 Office 文档预览出现问题。 查看 硬件要求 - Web 服务器、应用程序服务器和单一服务器安装 ,了解 SharePoint 2013 的内存要求。 这些是 Office Web 应用 Server 使用的相同要求。

问题:您收到“数据连接设置为始终使用连接文件,并且 {0:ExcelWebApp} 不支持外部连接文件。 以下连接无法刷新:数据连接“错误。

这是因为 Office Web 应用 Server 不支持存储数据连接信息的 Office 数据连接 (ODC) 文件。 若要解决此问题,请执行以下步骤:

  1. 在 Excel 客户端应用程序中打开工作簿。

  2. 单击“数据>Connections”。

  3. 选择消息中列出的数据连接,然后单击“ 属性”。

  4. 单击“ 定义 ”选项卡。

  5. 清除“始终对检查使用连接文件检查框

  6. 将工作簿重新上传到 SharePoint 文档库。

若要使用户能够在浏览器窗口中与包含数据模型或 Power View 视图的工作簿进行交互,请在 SharePoint Server 中配置Excel Services以显示工作簿。 这要求 SharePoint 管理员在安装 SharePoint Server 的服务器上运行 New-SPWOPISupressionSetting cmdlet。 有关详细信息,请参阅 New-SPWOPISuppressionSetting and Management Excel Services in SharePoint Server 2013

断开 SharePoint 2013 与 Office Web 应用 Server 的连接

如果出于任何原因想要断开 SharePoint 2013 与 Office Web 应用 Server 的连接,请使用以下命令示例。

    Remove-SPWOPIBinding -All:$true

需要帮助? 请参阅 Remove-SPWOPIBinding

另请参阅

New-SPWOPIBinding
Set-SPWOPIZone

Office Web Apps Server 内容指南
部署 Office Web Apps Server

部署 Office Web Apps Server