synchronizationRule 资源类型

命名空间:microsoft.graph

重要

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

定义应如何为同步引擎执行同步,包括要同步的对象和方向、源目录中的对象应如何与目标目录中的对象匹配,以及属性从源目录同步到目标目录时应如何转换。

注意: 同步规则定义从源目录到目标目录的一个方向同步。 源目录和目标目录定义为规则属性的一部分。

同步规则作为 同步架构的一部分进行更新。

属性

属性 类型 说明
containerFilter containerFilter 同步规则范围内的组织单位的名称和标识符。 containerFiltergroupFilter 是不能在同一请求中配置的互斥属性。 目前仅支持 Azure AD Connect 云同步方案。
编辑 布尔值 true 如果同步规则可以自定义,则为 ; false 如果此规则是只读的且不应更改,则为 。
groupFilter groupFilter 同步规则范围内的组的名称和标识符。 containerFiltergroupFilter 是不能在同一请求中配置的互斥属性。 目前仅支持 Azure AD Connect 云同步方案。
id String 同步规则标识符。 必须是同步引擎识别的标识符之一。 可以在 API 返回的同步模板中找到支持的规则标识符。
stringKeyStringValuePair 集合 其他扩展属性。 除非支持团队明确指示,否则不应更改元数据值。
name String 同步规则的用户可读名称。 不可为 null。
objectMappings objectMapping 集合 规则支持的对象映射的集合。 告知同步引擎应同步哪些对象。
priority 整数 相对于 synchronizationSchema 中其他规则的优先级。 将首先处理优先级编号最低的规则。
sourceDirectoryName String 源目录的名称。 必须与 synchronizationSchema 中的目录定义之一匹配。
targetDirectoryName String 目标目录的名称。 必须与 synchronizationSchema 中的目录定义之一匹配。

JSON 表示形式

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

{
  "containerFilter": {
    "@odata.type": "microsoft.graph.containerFilter"
  },
  "editable": true,
  "groupFilter": {
    "@odata.type": "microsoft.graph.groupFilter"
  },
  "id": "String",
  "metadata": [
    {
      "@odata.type": "microsoft.graph.stringKeyStringValuePair"
    }
  ],
  "name": "String",
  "objectMappings": [
    {
      "@odata.type": "microsoft.graph.objectMapping"
    }
  ],
  "priority": 1024,
  "sourceDirectoryName": "String",
  "targetDirectoryName": "String"
}