Zimbra Connector for Outlook 管理员指南

ZCO 向后兼容同一主要版本中受支持的 Zimbra Collaboration 版本。建议使用 最新版本的 ZCO 将受益于最新的功能和安全更新。 例如，最新的 ZCO 8.x.x 版本应与任何 Zimbra Collaboration 8.x.x 一起使用。

以下 Microsoft 操作系统支持 ZCO：

以下 Microsoft Outlook 版本支持 ZCO：

ZCO 包含以下 3 个文件。第一个供最终用户使用，另外两个供您（管理员）使用：

ZCO 文件位于 Zimbra 协作服务器上的：

Zimbra 通过https://www.zimbra.com.cn/downloads/zimbra-connector-for-outlook/定期发布 ZCO 更新。 您可以下载这些并使用

将最新版本的 ZCO 上传到上述位置。

新用户通常通过浏览至以下位置获取 ZCO 安装程序：

或者，您可以选择在计算机上的其他位置提供 MSI 网络。

安装后，ZCO 具有自动升级功能，可用于让用户保持最新版本。 当 Outlook 启动时，自动升级会检查上述位置是否有更新版本的 ZCO，如果找到新版本，用户就有机会升级到该版本。

可以通过自定义 MSI 来禁用自动升级。

作为管理员，您还可以从 Zimbra Collaboration 管理控制台的 Zimbra 实用程序下载页面获取 MSI：

未签名的 MSI 位于：

/opt/zimbra/jetty-distribution-<version>/webapps/zimbra/downloads

生成新的 index.html 文件 以下是如何自定义 MSI 以指定服务器名称、端口和安全连接详细信息的简单示例。 在使用生成的 MSI 时，用户只需在创建配置文件时添加其帐户名和密码。

现在，您可以将自定义的 MSI 文件放回服务器上，以供用户使用。

您可以控制帐户密码是否存储在配置文件中。

使用-pw开关后跟1或0.

Zimbra Connector for Outlook (ZCO) 提供了一种获取忙/闲信息的新方法：Zimbra 忙/闲提供程序。 新的提供程序正确显示暂定、不在办公室、在其他地方工作以及类似的其他状态。

要将 Zimbra 忙/闲提供程序设置为默认，请使用开关--usezimbrafreebusy或-zfb后跟0或1.

默认情况下， MSI 将--usezimbrafreebusy或-zfb设置为0。 您需要将其设置为1才能为用户激活 Zimbra 忙/闲。

要回滚到互联网忙/闲状态，

当您第一次根据配置文件启动 Outlook 时，ZCO 会从服务器下载所有邮件数据。 它还下载全局地址列表 (GAL)。 所有下载的数据与服务器数据保持同步。

邮件数据通常需要频繁同步，但在大多数组织中，GAL 很少更改。 此-gsm开关可用于控制 GAL 同步何时发生。

要设置 GAL 同步模式，请使用-gsm开关后跟 0、1 或 2。

请参阅下面有关何时发生自动 GAL 同步的讨论

（GAL 同步仅在用户选择Zimbra 功能区 → 同步全局地址列表 → 更新全局地址列表 → 更新全局地址列表

当GAL 同步模式为自动，ZCO 在以下时间启动 GAL 同步：

在所有情况下，GAL 同步频率均受到限制因此，在成功进行 GAL 同步后，仅在指定的时间间隔后才允许进行后续同步。 该间隔默认为4小时（240 分钟）。 通过更改 Windows 注册表项来修改单个用户的值GasSyncMinutesBetween。 要自定义整个组织的行为，请使用-gsl开关配置自定义安装程序。

后面的数字-gslswitch 是成功的 GAL 同步之间必须经过的分钟数。 默认值为0，相当于240 分钟。 例如，将此值设置为 480 将防止 GAL 同步发生频率超过每 8 小时一次。

如果 ZCO 在同步过程中遇到问题，它会生成本地失败消息。 这些本地失败消息不会同步到服务器。 默认情况下，它们是在收件箱中创建的，但您可以使用--inbox-failures-off开关在Sync Issues文件夹中创建它们。

配置 SSO 时，用户无需输入用户名和密码即可创建配置文件。 在这种情况下，身份验证是使用他们用于登录 Windows 的用户名和密码完成的。

要使用此功能，用户勾选使用我的 Windows 登录凭据进行连接创建配置文件时，在服务器配置属性页上选中复选框。 但是，通过使用--single-signon开关，您可以减轻他们的负担。 该值可以是 0、1 或 2：

0：使用我的 Windows 登录凭据进行连接复选框已隐藏。

该值适用于不使用 SSO 的组织。

1：该复选框显示在 Zimbra 属性页中，默认情况下未选中。

2：默认情况下会显示并勾选该复选框。

例子：

要通过组策略设置 SSO，需要以下注册表设置：

有关详细信息，请参阅附录 B，为 Zimbra Collaboration 配置 SPNEGO 单点登录Zimbra Collaboration 管理员指南.

当用户启动 Outlook 时，默认情况下，ZCO 会检查 Zimbra Collaboration 是否有较新版本的 ZCO。 如果有更新版本可用，用户会收到带有升级选项的提示。

您可以使用--disable-autoupgrade开关禁用自动升级功能。

Zimbra 管理员现在可以压缩大型 ZCO 数据库以解决碎片问题并减小大小。此过程可提高性能。

每次 Outlook 启动时，ZCO 都会检查数据库的状况以确定数据库是否需要压缩。 以下条件会触发自动压缩。 这些条件中的每一个都是可配置的。

ZCO 在本地存储 GAL 的副本，并将其作为通讯簿提供给 Outlook。

默认情况下，具有备用电子邮件地址（称为别名）的帐户会在 GAL 中产生多个条目。

如果您不希望别名出现在 GAL 中，可以使用--galsync-disablealiases 1开关禁用此选项。

禁用此功能后，用户在寻址邮件时无法搜索别名。

请注意，只有在用户重置其 GAL 后，对此值的更改才会在特定客户端上生效。 要重置 GAL：

默认情况下，ZCO 将其显示语言设置为 Outlook 显示语言。

您可以使用-lang <LCID>开关覆盖此设置，其中 <LCID> 是您要显示的语言的十进制 LCID 值（美国英语为 1033，日语为 1041 等）。

例如，如果您想使用 ZCO 的加拿大法语翻译（因为没有相应的加拿大法语版本的 Outlook），则此覆盖至关重要，在这种情况下，LCID 应为 3084。

个人用户还可以通过 ZCO 高级设置对话框上的语言选项设置显示语言。

其他支持的语言包括阿拉伯语、巴斯克语、加泰罗尼亚语、中文（简体中华人民共和国、繁体香港和繁体台湾）、丹麦语、荷兰语、英语、法语、加拿大法语、德语、希伯来语、印地语、匈牙利语、印度尼西亚语、意大利语、日语、韩语、老挝语、马来语、挪威语、波兰语、葡萄牙语（巴西和葡萄牙）、罗马尼亚语、俄语、斯洛文尼亚语、西班牙语、瑞典语、泰语、土耳其语、乌克兰语和越南语。

您可以将 ZCO 中的 Zimbra 品牌更改为您的公司名称或品牌。

在用户用于安装 ZCO 的 ZCO.msi文件上运行以下脚本：

如果目标计算机上安装了以前版本的 ZCO，请在运行新品牌安装之前卸载 ZCO。

您的公司名称或值现在取代了 Zimbra 品牌，并且 Zimbra 图标也被通用图标取代。

管理员可以启用报告问题ZCO 中的功能通过使用--reportissue-adminemailid或-riaeid转变。

例子：

此功能使 ZCO 用户可以向其电子邮件 ID 出现在--reportissue-adminemailid转变。 当用户使用此功能报告问题时，管理员用户会收到两封电子邮件：

简化支持视图隐藏了 ZCO UI 上的一些 Zimbra 支持组按钮。 默认情况下，所有 Zimbra 支持组按钮都会显示在 ZCO UI 上。

使用--simplifiedsupportview或-ssview开关后跟 0 或 1：

示例：

ZCO 增强了地址簿搜索功能。现在，搜索包括在名称字段中查找子字符串。当字段包含多个单词时，它特别有效。

对于下面的示例，此功能使人们能够搜索单词 Azam，尽管它是名字的一部分：

可以使用-imn开关后跟 0 或 1 在安装程序中启用或禁用此功能：

示例：

如果没有修改MSI，则用户需要以下服务器配置 信息以创建 Outlook 配置文件。请务必将此信息提供给您的用户 在安装 ZCO 之前，他们可以完成 ZCO 的安装：

默认情况下，ZCO 与服务器建立的所有连接都将使用 SSL 来验证服务器并加密数据。

需要进行一些服务器配置才能正常工作：

当 Outlook 启动时，ZCO 根据配置文件中指定的服务器帐户进行身份验证。 ZCO 支持 4 种身份验证

可以通过两步身份验证为个人用户帐户启用两步身份验证Zimbra 管理控制台的高级设置部分。

通过此增强功能，用户可以使用以下方式进行身份验证：

可用方法和首选方法通过服务器配置进行控制。每当 ZCO 登录 Zimbra 服务器时，系统都会提示用户在 Outlook 中输入密码。

用户只需几分钟即可在计算机上安装 ZCO 并配置连接 Zimbra 协作。您必须为用户提供临时管理权限和 服务器配置信息。

在没有现有 MAPI 配置文件的计算机上安装 ZCO 会导致创建一个名为Zimbra的新配置文件 （或者其他，如果这是使用 ZmCustomizeMsi.js 的--profile-name选项设置的）。

安装不会删除任何以前的 Outlook 配置文件或帐户。用户可以查看之前的 通过导航至配置文件开始 > 设置 > 控制面板 > 邮件 > 显示配置文件.

邮件配置文件可以将 Zimbra 帐户与 IMAP、Exchange 或 POP 帐户结合起来，但可以在 个人资料中最多有一个 Zimbra 帐户。

要添加新配置文件，用户在显示配置文件对话框中选择添加并按照提示进行操作。

有关 ZCO 安装过程的更多信息，请参阅Zimbra Connector for Microsoft Outlook 用户指南.

一般来说，当在现有 ZCO 安装上安装新版本的 ZCO 时，配置文件将自动升级。

安装 ZCO 后用户首次打开 Outlook 时，用户的 Outlook 邮箱必须同步 与 Zimbra 合作。如果用户一直在使用 Zimbra Web 客户端并有电子邮件， Zimbra 上的文件夹、标签、签名、联系人、个人日历、约会提醒和任务 协作时，此信息会与 Outlook 中的 Zimbra 个人资料同步。

初始同步可能需要几分钟或更长时间，具体取决于邮箱的大小 和网络速度。对于慢速网络和/或大型邮箱，初始同步可能需要几个小时。它是 在使用快速可靠的有线公司网络时安装 ZCO 是有利的。也是强烈的 建议在初始同步期间禁用防病毒软件，否则防病毒软件可能会 当消息放置在 ZDB 中时，通过病毒检查消息来延长初始化时间。

如果用户使用默认的 Zimbra 配置文件，其同步数据将保存在zimbra.zdb文件中 位于用户的AppData\Local\Microsoft\Outlook文件夹中。

ZCO 在以下时间自动同步：

要获得对使用旧版本 ZCO 创建的配置文件的联系人组的全面支持， 有必要在您的 ZCO 客户端上执行完整的 GAL 重置，以确保联系人组及其 成员与 Zimbra Collaboration 正确同步。

有关 ZCO 同步的更多信息，请参阅 Zimbra Connector forMicrosoft Outlook 用户指南.

如果用户长时间（例如超过 3 个月）不访问其 ZCO 配置文件，则该配置文件将变得过时。在这种情况下，当用户启动 Outlook 时，会弹出一条消息“您的邮箱太旧，无法与 [ZIMBRA] 服务器同步。您想在下次启动 Outlook 时下载最新的邮箱数据吗？”显示为带有 YES/NO 按钮。

如果用户单击“YES”按钮，它将删除过时的配置文件数据文件（zdb、.db 等），并且在下次 Outlook 启动时，ZCO 将从服务器获取所有新数据。 （就像配置新配置文件一样）

如果用户单击“否”按钮，则下次 ZCO 配置文件启动时将显示相同的错误消息。

ZCO 支持使用 S/MIME 发送/接收签名和加密消息。这些操作所需的公钥 可以存储在 GAL 和个人联系人中。

这些 GAL 在 GAL 同步期间传播到存储在用户计算机上的全局地址列表。它们是只读的。

个人联系人中的联系人与 Zimbra Collaboration 双向同步。

用户可以通过“高级”按钮修改以下高级设置，可从以下位置获取：

如果 Zimbra 协作服务器 CA 证书是自签名的，则 Outlook 中的忙/闲查找失败 出现错误

要解决此问题，请将 CA 证书添加到 Internet Explorer 的受信任根证书颁发机构。

Outlook 的自动存档功能不会从服务器中删除文件。它只会将文件添加到 PST 存档中。

为了更好地管理 Outlook 上的存储，ZCO 用户现在可以使用自动存档功能。该功能控制 Outlook 收件箱和文件夹，并通过将旧项目转移到要维护的存档来帮助管理存储。

有关 ZCO 自动存档功能以及如何启用它的更多信息，请参阅用户指南中的自动存档部分。

如果您将会议邀请转发给其他用户，则会向原始会议发送通知 组织者，因为您现在已向新受邀者发出邀请。

ZCO 包括多种故障排除辅助工具：

安装过程中偶尔会发生冲突，因此如果这是新安装 从未正常运行过，请考虑卸载 ZCO，重新启动并重新安装。

安装 ZCO 后，会在用户的 Outlook 中创建Sync Issues文件夹及其子文件夹 文件夹列表。如果 Outlook 与服务器同步时发现错误，则同步失败 通知将发送到用户的收件箱和同步问题文件夹。这些消息是 创建的目的是帮助 Zimbra 技术支持和工程调试和修复错误。

要查看同步问题文件夹，请单击 Outlook 导航窗格中的文件夹列表图标。 同步问题文件夹显示在文件夹列表中。用户可以知道新消息何时出现 当文件夹以粗体显示并且显示未读消息的数量时，这些文件夹。

要防止将本地失败消息放入收件箱，请取消选择：

查看失败消息。问题可能很容易解决， 例如超出配额消息。如果您无法根据消息解决错误， 将消息连同支持案例一起提交给 Zimbra 支持。

安装 ZCO 时，会创建 Zimbra 功能区，其中包含一个名为支持的组。如果用户是 如果特定电子邮件或文件夹出现问题，您可以使用此组来收集信息以帮助调试问题。

Zimbra 支持组按钮解释如下。

如果 Outlook 意外关闭（例如，出现警告Outlook…​需要关闭），请查看 核心转储的 ZCOLogs 目录指示为 *.DMP 文件，并将这些文件提供给 Zimbra 支持。

如果 Outlook 挂起，Zimbra 支持可能会要求您进行挂起转储。生成一个最简单的方法 hang-dump 是右键单击任务管理器的“进程”选项卡上的 OUTLOOK.EXE，然后选择“创建转储文件”。

用户收到一条本地失败消息，指出.zdb文件已损坏。为了解决这个问题， 您必须修复.zdb文件。这.zdb文件包含.pst中 Zimbra Collaboration 的所有 Outlook 数据 格式：消息、联系人、约会、任务等。

使用 scanpst.exe 工具修复 Outlook/ZCO 无法打开的任何.zdb文件。

ZCO 在运行第三方 Outlook 加载项或防病毒软件时遇到问题并不罕见。 在重试使用 ZCO 之前尝试禁用加载项。要报告问题，请使用 Zimbra 记录错误，列出 已安装的所有 Outlook 加载项，并指出您认为导致冲突的加载项。

要在计算机上删除 ZCO，包括除 Zimbra 配置文件之外的所有组件，请使用 Windows 控制面板的“添加或删除程序”部分。

如果用户的邮箱无法接收新邮件、变得不同步或.zdb文件损坏，它可能会很有用 创建另一个配置文件以查看问题是否仍然存在。

在某些情况下，可能需要卸载 ZCO、删除配置文件和 .zdb，然后重新开始。

对于联系人组支持，请在 ZCO 客户端上执行完整的 GAL 重置，以确保联系人组及其成员与 ZCS 正确同步。

当您使用即点即用版本的 Outlook启动 ZCO 时，您可能会看到一个消息框，要求授予更改注册表设置的权限。 如果最近的 Microsoft Office 更新删除了 ZCO 创建的注册表项（Outlook 搜索正常工作所需），就会发生这种情况。 允许 ZCO 重置注册表设置。如果被拒绝，Outlook 搜索可能无法正常工作。

如何确定您是否有即点即用版本：