通过

orgContact 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示组织联系人。 组织联系人由组织的管理员管理，与 个人联系人不同。 此外，从本地目录或从Exchange Online同步组织联系人，在 Microsoft Graph 中是只读的。

继承自 directoryObject。

该资源支持通过提供 delta 函数使用增量查询跟踪增量添加、删除和更新。 此资源是一种开放类型，它允许除此处所述的属性之外的其他属性。

方法

方法 返回类型 说明
组织联系人
List orgContact 集合 列出组织联系人的属性。
Get orgContact 读取 orgContact 对象的属性和关系。
获取增量 orgContact 集合 获取新创建、更新或删除的组织联系人，而无需执行整个集合的完整读取。
获取目录对象的增量 direcyoryObject 集合 通过目录对象集合获取新创建、更新或删除的组织联系人，而无需执行整个集合的完整读取。
列出隶属于 字符串集合 检索联系人所属的组和管理单元的列表。 检查是可传递的。
列出 的可传递成员 directoryObject collection 列出组织联系人所属的组，包括组织联系人嵌套的组。
检查成员组 字符串集合 检查组列表中的组织联系人的成员身份。 检查是可传递的。
获取成员组 字符串集合 返回组织联系人所属的所有组。 检查是可传递的。
检查成员对象 字符串集合 检查组、目录角色或管理单元对象列表中的组织联系人的成员身份。
获取成员对象 字符串集合 返回组织联系人所属的所有组、管理单元和目录角色。 检查是可传递的。
重试服务预配 无 重试 orgContact 服务预配。
获取可传递报表 整数 从 transitiveReports 导航属性获取组织联系人的可传递报表计数。
本地同步行为 (颁发机构源)
Get onPremisesSyncBehavior 检查联系人对象的授权来源 (SOA) 是云还是本地 Active Directory。
更新 onPremisesSyncBehavior 将联系人对象的授权来源 (SOA) 更新到云或本地 Active Directory。
组织层次结构
获取管理器 directoryObject 获取联系人的经理。
列出直接下属 directoryObject collection 列出联系人的直接下属。

属性

重要

仅当使用设置为 eventual 和 $count 的 ConsistencyLevel 标头时，才支持 $filter 和 $search 查询参数的特定用法。 有关详细信息，请参阅 目录对象的高级查询功能。

属性 类型 说明
地址 physicalOfficeAddress 集合 此组织联系人的邮政地址。 目前，一个联系人只能有一个物理地址。
CompanyName String 此组织联系人所属的公司名称。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull
department String 联系人所在的部门的名称。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull
displayName String 此组织联系人的显示名称。 最大长度为 256 个字符。 not eq in startsWith le ne ge) 、 和 nulleq 的值支持 $filter (、、$search、 和 。$orderby
givenName String 此组织联系人的名字。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull
id String 此组织联系人的唯一标识符。 支持 $filter （eq、 ne、 not、 in）。
jobTitle String 此组织联系人的职务。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull
mail String 联系人的 SMTP 地址，例如“jeff@contoso.com”。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull
mailNickname String Email别名 (电子邮件地址的一部分，此组织联系人的 @ 符号) 之前挂起。 支持 $filter) neeqnot值 (、、ge、instartsWithle、、 和 。eqnull
onPremisesLastSyncDateTime DateTimeOffset 上次从本地 AD 同步此组织联系人的日期和时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 支持 $filter （eq、 ne、 not、 ge、 le、 in）。
onPremisesProvisioningErrors onPremisesProvisioningError 集合 此组织联系人的任何同步预配错误列表。 支持 $filter (eq，not用于类别和属性CausingError) 、 /$count eq 0。 /$count ne 0
onPremisesSyncEnabled Boolean 如果此对象从本地目录同步，则为 true;如果此对象最初从本地目录同步，但不再同步，现在已在 Exchange 中主控，则为 false;如果从未从本地目录同步此对象，则为 null， (默认) 。

支持 $filter (eq、 ne、 not、 in和 eq 值 null) 。
phones phone collection 此组织联系人的电话列表。 手机类型可以是移动、商务和商务Fax。 集合中只能存在每种类型中的一种。 支持 $filter （eq、 ne、 not、 in）。
proxyAddresses String collection 例如：“SMTP： bob@contoso.com”， “smtp： bob@sales.contoso.com”。 需要多值属性筛选器表达式的 any 运算符。 支持 $filter （eq、 not、 ge、 le、 startsWith、 /$count eq 0、 /$count ne 0）。
serviceProvisioningErrors serviceProvisioningError 集合 联合服务发布的错误，描述有关 orgContact 对象 中的属性或链接的非暂时性特定于服务的错误。
对于 isResolved 和 serviceInstance) eqnot，支持 $filter (、、 。
surname String 此组织联系人的姓氏。 支持$filter对值 (eq、ne、not、 inlestartsWithge和) eqnull

关系

关系 类型 说明
directReports directoryObject collection 联系人的直接下属。 (将经理属性设置为此 contact 的用户和联系人。) 只读。 可为 NULL。 支持 $expand。
manager directoryObject 此联系人的经理的用户或联系人。 只读。 支持 $expand 并 $filter (eq 按 id) 。
memberOf directoryObject collection 此联系人所属的组。 只读。 可为 NULL。 支持 $expand。
onPremisesSyncBehavior onPremisesSyncBehavior 指示云和本地 Active Directory之间的组织Contact的同步状态。 仅支持 $filter 高级查询功能，例如 $filter=onPremisesSyncBehavior/isCloudManaged eq true&$count=true。
transitiveReports directoryObject 集合 联系人的可传递报告。 只读。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "addresses": [{"@odata.type": "microsoft.graph.physicalOfficeAddress"}],
  "companyName": "string",
  "department": "string",
  "displayName": "string",
  "givenName": "string",
  "id": "string (identifier)",
  "jobTitle": "string",
  "mail": "string",
  "mailNickname": "string",
  "onPremisesLastSyncDateTime": "string (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSyncEnabled": true,
  "phones": [{"@odata.type": "microsoft.graph.phone"}],
  "proxyAddresses": ["string"],
  "serviceProvisioningErrors": [{"@odata.type": "microsoft.graph.serviceProvisioningXmlError"}],
  "surname": "string"
}
  • Last updated on