tipo de recurso synchronizationSchema

Espacio de nombres: microsoft.graph

Define qué objetos se sincronizarán y cómo se sincronizan. El esquema de sincronización contiene la mayor parte de la información de configuración de un trabajo de sincronización determinado. Normalmente, se personalizan algunas de las asignaciones de atributos o se agrega un filtro de ámbito para sincronizar solo los objetos que cumplen una condición determinada.

En las secciones siguientes se describen los componentes de alto nivel del esquema de sincronización.

Definiciones de directorio

Las definiciones de directorio proporcionan la información del motor de sincronización sobre los directorios y sus objetos. Por ejemplo, la definición de directorio indica al motor de sincronización que un directorio de Microsoft Entra tiene objetos denominados usuario y grupo, qué atributos se admiten para esos objetos y los tipos de esos atributos. Para que un objeto y atributo determinados se usen en reglas de sincronización o asignaciones de objetos, deben definirse como parte de la definición de directorio.

Reglas de sincronización

Las reglas de sincronización son el núcleo de la configuración de sincronización. Definen para el motor de sincronización cómo se debe realizar la sincronización, incluidos los objetos que se deben sincronizar, cómo deben coincidir los objetos del directorio de origen con los objetos del directorio de destino y cómo se deben transformar los atributos cuando se sincronizan del origen al directorio de destino.

Asignaciones de objetos

Las asignaciones de objetos son la parte principal de la regla de sincronización. Cada asignación de objetos define cómo se debe sincronizar un objeto determinado desde el origen al directorio de destino. En concreto, la asignación define cómo debe coincidir un objeto del directorio de origen con un objeto del directorio de destino, qué filtros de ámbito (si existe) se deben usar para decidir si se debe aprovisionar un objeto y cómo se deben transformar los atributos de objeto cuando se sincronizan desde el origen al directorio de destino.

Métodos

Método	Tipo de valor devuelto	Descripción
Get	synchronizationSchema	Lea las propiedades y las relaciones del objeto synchronizationSchema .
Actualizar	Ninguno	Actualice el esquema de sincronización.
Reset	Ninguno	Elimine el esquema personalizado y restablezca el esquema a la configuración predeterminada.
Obtener operadores de filtro de esquema	colección filterOperatorSchema	Enumere todos los operadores admitidos en los filtros de ámbito.
Obtener funciones de esquema	attributeMappingFunctionSchema (colección)	Enumera todas las funciones admitidas en las expresiones de asignación de atributos.
Análisis de la expresión de asignación de atributos	parseExpressionResponse	Analice una expresión de cadena en un objeto attributeMappingSource .

Propiedades

Propiedad	Tipo	Descripción
id	Cadena	Identificador único del esquema.
synchronizationRules	colección synchronizationRule	Colección de reglas de sincronización configuradas para synchronizationJob o synchronizationTemplate.
version	Cadena	La versión del esquema, actualizada automáticamente con cada cambio de esquema.

Relaciones

Relación	Tipo	Descripción
Directorios	colección directoryDefinition	Contiene la colección de directorios y todos sus objetos.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "@odata.type": "#microsoft.graph.synchronizationSchema",
  "id": "String (identifier)",
  "synchronizationRules": [
    {
      "@odata.type": "microsoft.graph.synchronizationRule"
    }
  ],
  "version": "String"
}