orgContact 资源类型

命名空间:microsoft.graph

表示组织联系人。 组织联系人由组织的管理员管理,不同于 个人联系人。 此外,组织联系人要么从本地目录同步,要么从Exchange Online同步,并且在 Microsoft Graph中是只读的。

继承自 directoryObject

该资源支持通过提供 delta 函数使用增量查询跟踪增量添加、删除和更新。 此资源是允许传入其他属性的开放类型。

Methods

方法 返回类型 说明
组织联系人
列出组织联系人 orgContact 列出组织联系人的属性。
获取组织联系人 orgContact 读取组织联系人的属性和关系。
组织层次结构
获取经理 directoryObject 获取组织联系人的经理。
List directReports directoryObject collection 列出组织联系人的直接报告。
List memberOf directoryObject collection 列出组织联系人所属的组。
列出 transitiveMemberOf directoryObject 集合 列出组织联系人所属的组,包括组织联系人嵌套在其中的组。
checkMemberGroups String collection 检查组成员身份。
getMemberGroups String collection 返回指定组织联系人所属的所有组。
getMemberObjects String collection 返回组织联系人所属的 directoryObjects 的列表。

属性

重要

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

属性 类型 说明
地址 physicalOfficeAddress 集合 此组织联系人的邮政地址。 目前,联系人只能有一个物理地址。
CompanyName String 此组织联系人所属的公司名称。 支持 $filtereqnenotgeleinstartsWithnull 值上的 eq)。
部门 String 联系人所在的部门的名称。 支持 $filtereqnenotgeleinstartsWithnull 值上的 eq)。
displayName 字符串 此组织联系人的显示名称。 支持 $filter (eqnenotgeleinstartsWithnull 值上的 eq)、$search$orderBy
givenName String 此组织联系人的名字。 支持 $filtereqnenotgeleinstartsWithnull 值上的 eq)。
id 字符串 此组织联系人的唯一标识符。 支持 $filtereqnenotin)。
jobTitle String 此组织联系人的职务。 支持 $filtereqnenotgeleinstartsWithnull 值上的 eq)。
mail String 联系人的 SMTP 地址,例如“jeff@contoso.onmicrosoft.com”。 支持 $filtereqnenotgeleinstartsWithnull 值上的 eq)。
mailNickname String 电子邮件别名 (电子邮件地址的一部分,预先挂起此组织联系人的 @符号) 。 支持 $filtereqnenotgeleinstartsWithnull 值上的 eq)。
onPremisesLastSyncDateTime DateTimeOffset 上次从本地 AD 同步此组织联系人的日期和时间。 此日期和时间信息使用 ISO 8601 格式,并且始终处于 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 支持 $filtereqnenotgelein)。
onPremisesProvisioningErrors onPremisesProvisioningError 集合 此组织联系人的任何同步预配错误的列表。 支持 $filtereqnot)。
onPremisesSyncEnabled Boolean true如果此对象是从本地目录同步的,false如果此对象最初是从本地目录同步的,但不再同步,现在已在Exchange中掌握;null如果此对象从未从本地目录同步, (默认) 。

支持 $filtereqnenotinnull 值上的 eq)。
phones phone collection 此组织联系人的电话列表。 电话类型可以是移动、商业和 BusinessFax。 集合中只能存在每种类型之一。
proxyAddresses String collection 例如:“SMTP:bob@contoso.com”、“smtp:bob@sales.contoso.com”。 需要多值属性筛选器表达式的 any 运算符。 支持$filter (eqnotgele``startsWith计数空集合) 。
surname String 此组织联系人的姓氏。 支持 $filtereqnenotgeleinstartsWithnull 值上的 eq)。

关系

关系 类型 说明
directReports directoryObject collection 联系人的直接报告。 (其管理器属性设置为此联系人的用户和联系人。) 只读。 可为 NULL。 支持 $expand
manager directoryObject 此联系人的经理的用户或联系人。 只读。 支持 $expand
memberOf directoryObject 集合 此联系人所属的组。 只读。 可为 NULL。 支持 $expand
transitiveMemberOf directoryObject collection 此联系人所属的组,包括联系人嵌套在其中的组。 只读。 可为 Null。

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"],
  "surname": "string"
}