Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Define quais objetos serão sincronizados e como eles são sincronizados. O esquema de sincronização contém a maioria das informações de instalação para um trabalho de sincronização específico. Normalmente, você personaliza alguns dos mapeamentos de atributo ou adiciona um filtro de escopo para sincronizar apenas objetos que atendem a uma determinada condição.
As seções a seguir descrevem os componentes de alto nível do esquema de sincronização. Para obter mais informações, consulte Entender o mapeamento de esquemas e atributos do Microsoft Entra– Active Directory para o Microsoft Entra ID.
Definições de diretório
As definições de diretório fornecem ao mecanismo de sincronização informações sobre diretórios e seus objetos. Por exemplo, a definição de diretório informa ao mecanismo de sincronização que um diretório do Microsoft Entra tem objetos chamados usuário e grupo, quais atributos têm suporte para esses objetos e os tipos para esses atributos. Para que um determinado objeto e atributo sejam usados em regras de sincronização/mapeamentos de objetos, eles devem ser definidos como parte da definição de diretório.
Regras de sincronização
As regras de sincronização são o núcleo da configuração da sincronização. Eles definem para o mecanismo de sincronização como a sincronização deve ser executada, incluindo quais objetos devem ser sincronizados, como os objetos do diretório de origem devem ser combinados com objetos no diretório de destino e como os atributos devem ser transformados quando eles são sincronizados da origem para o diretório de destino.
Mapeamentos de objetos
Os mapeamentos de objetos são a parte principal da regra de sincronização. Cada mapeamento de objeto define como um determinado objeto deve ser sincronizado do diretório de origem para o de destino. Em particular, o mapeamento define como um objeto no diretório de origem deve ser correspondido a um objeto no diretório de destino, quais filtros de escopo (se houver) devem ser usados para decidir se um objeto deve ser provisionado e como os atributos de objeto devem ser transformados quando eles são sincronizados do diretório de origem para o diretório de destino.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Get | synchronizationSchema | Leia as propriedades e as relações do objeto synchronizationSchema . |
| Atualizar | Nenhum(a) | Atualize o esquema de sincronização. |
| Reset | Nenhum | Exclua o esquema personalizado, redefinindo o esquema para a configuração padrão. |
| Obter operadores do filtro de esquema | coleção filterOperatorSchema | Liste todos os operadores com suporte nos filtros de escopo. |
| Obter funções de esquema | coleção attributeMappingFunctionSchema | Liste todas as funções com suporte nas expressões de mapeamento de atributos. |
| Analisar expressão de mapeamento de atributos | parseExpressionResponse | Analise uma expressão de cadeia de caracteres em um objeto attributeMappingSource . |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | Cadeia de caracteres | Identificador exclusivo para o esquema. |
| synchronizationRules | coleção synchronizationRule | Uma coleção de regras de sincronização configuradas para synchronizationJob ou synchronizationTemplate. |
| versão | Cadeia de caracteres | A versão do esquema, atualizada automaticamente a cada alteração de esquema. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| diretórios | coleção directoryDefinition | Contém a coleção de diretórios e todos os seus objetos. |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.synchronizationSchema",
"id": "String (identifier)",
"synchronizationRules": [
{
"@odata.type": "microsoft.graph.synchronizationRule"
}
],
"version": "String"
}