使用 Outlook Web App Web 部件
适用于：Exchange Server 2013
可以使用 Microsoft Office Outlook Web App Web 部件来指定要打开的邮箱、要打开的邮箱内的文件夹以及要使用的内容视图。
使用 Outlook Web App Web 部件可以直接通过 URL 访问 Outlook Web App 内容。 URL 可以在 Web 浏览器中输入，也可以嵌入应用程序。 通常不以手动方式创建 Web 部件。 而是根据在用户界面 (UI) 中作出的选择以编程方式创建 Web 部件，或直接将其嵌入应用程序（如 SharePoint Server 页）中。 然后，UI 后面的代码创建 URL。 Outlook Web App Web 部件的一项用途是在 Sharepoint 页上显示用户的收件箱或日历。
注意
若要使用 Outlook Web App Web 部件，用户的邮箱和通过 Web 部件打开的邮箱必须位于同一 Active Directory 林中。
使用Outlook Web App Web 部件的权限
若要使用 Outlook Web App Web 部件，必须至少向你委派对所打开内容的"审阅者"访问权限。 如果向应用程序嵌入了要求进行身份验证的 Outlook Web App Web 部件，则必须将身份验证信息与对 Web 部件的请求一起传递。 这样做的一种方法是将 Outlook Web App 虚拟目录配置为使用集成 Windows 身份验证。 通过集成 Windows 身份验证，已使用 Active Directory 帐户登录的用户不必重新输入其凭据即可使用 Outlook Web App。
Outlook Web App Web 部件语法
Exchange 2013 中的 Outlook Web App 对 /owa 虚拟目录请求使用 URL 格式。 可通过直接向 Web 浏览器中键入 URL 或将 URL 嵌入 Web 应用程序（如 SharePoint Server 页）中，发出这些请求。
可以使用 Outlook Web App Web 部件创建不同复杂程度的 URL。 可以使用简单的 Web 部件 URL 打开任意邮箱的收件箱。 可以使用更复杂的 Web 部件 URL 指定要打开的邮箱、该邮箱中要打开的文件夹以及要使用的内容视图。
根据网络上采用的安全措施，可能必须配置 Web 部件 URL 的编码。 配置编码后，UI 后面的代码将使用 URL 编码的参数创建 URL。 URL 编码的参数使用 %20 代替空格，使用 %2f 代替路径分隔符"/"。 本主题中的所有示例都使用编码的参数。
下表列出 Web 部件的参数以及如何使用这些参数的示例。
注意
Exchange 2016、Exchange 2019 和 Exchange Online不再包含对 Web 部件的支持。
Web 部件参数及其使用方法
| URL 参数 | 说明 | 值和示例 |
|---|---|---|
| 服务器名称和目录（必需） | Outlook Web App 虚拟目录的 URL。 | 此 URL 可以与用户登录到 Outlook Web App 时所使用的 URL 相同，例如：https://<server name>/owa |
| Exchange 2013 明确的登录邮箱标识（可选） | 与要打开的邮箱关联的任何 SMTP 地址。 如果 URL 缺少此部分，将打开经过身份验证的用户的默认邮箱。 如果未指定任何其他参数，默认行为将是打开收件箱。 |
若要打开 SMTP 地址 tsmith@fourthcoffee.com为 的邮箱，请使用以下 URL：https://<server name>/owa/tsmith@fourthcoffee.com |
| cmd（如果指定的参数不是明确的登录邮箱标识，则是必需的） | ?cmd=contents显示参数指定的Outlook Web App Web 部件，而不是完整的Outlook Web App用户界面。 |
如果未指定邮箱，则 cmd 参数跟在登录地址后面，如下所示：https://<server name>/owa/?cmd=contents 如果指定了邮箱，则 cmd 参数跟在明确的邮箱标识后面，如下所示： https://<server name>/owa/<SMTP address>/?cmd=contents 如果未指定任何其他参数，默认行为将是打开收件箱。 |
| exsvurl | 使用 LiveID 身份验证时必须包含此参数 如果 "exsvurl=1" 不存在，则 LiveID 身份验证期间将丢弃所有参数。 此参数仅适用于 Microsoft 365 和 Office 365 邮箱。 |
https://<server name>/owa/?cmd=contents&exsvurl=1 |
| fpath（可选） | 可能必须使用 URL 编码编写此部分 URL，以便可以通过防火墙。 使用 URL 编码时，空格变为 %20，路径分隔符 (/) 变为 %2f。 文件夹层次结构应从邮箱根目录开始。 此文件夹路径可以指向普通文件夹或搜索文件夹。 |
若要打开收件箱中的子文件夹 Projects，请使用以下 URL：https://<server name>/owa/?cmd=contents&fpath=inbox%2fprojects |
| module（可选） | 可以使用此参数指定默认文件夹中的任意一个，而不必了解本地化名称。 | 模块参数的值不区分大小写，并包含以下值：
若要打开邮箱的日历（与本地化无关），请使用以下 URL： |
| view（可选） | 此参数指定文件夹要显示的视图。 没有此参数时的默认视图如下：
注意：默认视图的字符串会自动进行 URL 编码。 |
可用视图根据文件夹类型的不同而有所不同。 日历视图：
邮件视图：
|
| d, m, y（可选） | 指定应显示日历的日期。 这些参数可以按任意顺序输入，可以单独使用，也可以一起使用。 如果未指定其中的任何参数，默认值为当前日、月和年的值。 例如，如果当前日期为 2016 年 5 月 3 日，并且将月的值指定为"9"（代表九月），显示的日期将为 September 3, 2016。 |
数据参数的有效值如下： d=[1-31] m=[1-12] y=[四位数年份] 若要打开日期为 2016 年 5 月 3 日的日历，请使用以下 URL： https://<server name>/owa/?cmd=content&fpath=calendar&view=daily&d=3&m=5&y=2016 |
| part（可选） | 指定 Outlook Web App 应显示更小的 Web 部件。 | 使用 Web 部件访问 Outlook Web App 内容时，显示的 UI 将小于整个 Outlook Web App UI。 part 参数可以进一步减小 UI。 以下 URL 示例以最小的 Web 部件格式显示任务列表：https://<server name>/owa/?cmd=contents&part=1 部件参数不适用于日历模块。 |
| FolderList | 此 part 参数包括用户用于在子文件夹之间进行切换的文件夹列表控件。 此操作仅适用于电子邮件文件夹。 | https://<server name>/owa/?cmd=contents&folderlist=1 |
手动输入 Outlook Web App Web 部件
也可以在 Web 浏览器中手动输入 Outlook Web App Web 部件。 例如，用户可以使用 Outlook Web App Web 部件 URL 打开另一个用户的日历。
以下示例显示如何直接访问常见的 Outlook Web App 视图：
- 收件箱：
https://<server name>_/owa/?cmd=contents\&module=inbox - 日历 (今天) ：
https://<server name>/owa/?cmd=contents\&module=calendar\&exsvurl=1 - 日历 (每周) ：
https://<server name>/owa/?cmd=contents\&module=calendar\&view=weekly\&exsvurl=1 - 日历 (每月) ：
https://<server name>/owa/?cmd=contents\&module=calendar\&view=monthly\&exsvurl=1