大网数据广告活动
Microsoft Graph 接口

Microsoft Graph 数据连接中的用户选择和筛选功能

· 52CE 我爱测

了解如何使用 Microsoft Graph Data Connect 选择要为其提取数据的用户,并包括筛选器以限制返回的数据。

你可以使用 Microsoft Graph 数据连接来选择要提取其数据的用户,并包含筛选器以限制返回的数据。 本文介绍数据连接提供的用户选择选项,以及它支持的筛选功能。

用户选择

可以针对一组用户运行管道。 下面是适用于用户选择的选项:

  • 组织内的所有用户
  • 组织内最多有 10 个用户组
  • 基于由 Azure Active Directory 用户属性组成的谓词的一组用户。

在 Azure 数据工厂复制活动的 SourceDataSet 中指定用户选择。 若要针对组列表运行,请在 typeProperties 下添加一个新字段 allowedGroups,并将此字段设置为最多 10 个组的列表,对象 Id 由逗号分隔。 如果默认情况下未指定组,则为整个组织提取数据。

若要指定针对整个租户运行的谓词,请在 typeProperties 下添加一个新字段 userScopeFilterUri,并将此字段设置为该谓词。 谓词格式应与 Microsoft Graph API 的查询格式匹配。 例如,如果要仅选择在财务部门工作的用户,你可以使用 https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'。 如果要仅选择一个用户,可使用 https://graph.microsoft.com/v1.0/users?$filter=mail eq 'contosouser1@contoso.com'。

查询仅返回你所查询的 Microsoft 365 组织内的用户。 不会返回来宾用户和非用户邮箱。

筛选

可以使用日期时间属性来限制查询提取到的结果。 根据所请求数据的类型,可能需要日期时间筛选器。 日期时间筛选器使用的属性由 Azure 数据工厂复制活动的 SourceDataSet 提供。 若要指定日期时间筛选器,请在 typeProperties 下添加一个新字段 dateFilterColumn,并将此字段设置为下表中支持筛选的属性之一。 接着,添加表示日期时间值的 startTime 和 endTime,系统将依据这些值对属性进行筛选。

以下数据集需要针对相应的其中一个日期时间属性提供筛选器。

数据集名称 支持筛选的属性
BasicDataSet_v0.Event_v0BasicDataSet_v0.Event_v1 CreatedDateTimeLastModifiedDateTime
BasicDataSet_v0.Message_v0BasicDataSet_v0.Message_v1 CreatedDateTimeLastModifiedDateTimeReceivedDateTimeSentDateTime
BasicDataSet_v0.SentItem_v0BasicDataSet_v0.SentItem_v1 CreatedDateTimeLastModifiedDateTimeReceivedDateTimeSentDateTime

Note: 请求 BasicDataSet_v0.CalendarView_v0 的管道也需要日期时间筛选器,但 SourceDataSet 中未指定 dateFilterColumn。 但是,需要 startTime 和 endTime,且只提供了在 startTime 之后开始并在 endTime 之前完成的事件。

另请参阅

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 fercobo-msft)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。