Risoluzione dei problemi relativi a un oggetto che non esegue la sincronizzazione in Azure ADTroubleshoot an object that is not synchronizing to Azure AD

Se un oggetto non esegue la sincronizzazione come previsto in Azure AD, le cause possono essere diverse.If an object is not synchronizing as expected to Azure AD, then it can be because of several reasons. Se si riceve un'email di errore da Azure AD o viene visualizzato l'errore in Azure AD Connect Health, leggere l'articolo sulla risoluzione degli errori di esportazione.If you have received an error email from Azure AD or you see the error in Azure AD Connect Health, then read troubleshoot export errors instead. Tuttavia se si vuole risolvere un problema per cui l'oggetto non è in Azure AD, questo è l'argomento adatto.But if you are troubleshooting a problem where the object is not in Azure AD, then this topic is for you. Viene descritto come individuare gli errori di sincronizzazione nella componente locale di Azure AD Connect.It describes how to find errors in the on-premises component Azure AD Connect sync.

Per individuare gli errori è necessario esaminare vari punti nell'ordine seguente:To find the errors, you are going to look at a few different places in the following order:

  1. I registri delle operazioni per cercare gli errori rilevati dal motore di sincronizzazione durante l'importazione e la sincronizzazione.The operation logs for finding errors identified by the sync engine during import and synchronization.
  2. Lo spazio connettore per cercare gli oggetti mancanti e gli errori di sincronizzazione.The connector space for finding missing objects and synchronization errors.
  3. Metaverse per individuare i problemi relativi ai dati.The metaverse for finding data-related problems.

Avviare Synchronization Service Manager prima di iniziare questa procedura.Start Synchronization Service Manager before you begin these steps.

OperazioniOperations

La risoluzione dei problemi deve essere avviata dalla scheda Operazioni in Synchronization Service Manager.The operations tab in the Synchronization Service Manager is where you should start your troubleshooting. La scheda Operazioni mostra i risultati delle ultime operazioni.The operations tab shows the results from the most recent operations.
Sync Service Manager

Nella metà superiore sono mostrate tutte le esecuzioni in ordine cronologico.The top half shows all runs in chronic order. Per impostazione predefinita, il log delle operazioni mantiene le informazioni relative agli ultimi sette giorni, ma è possibile modificare questa impostazione tramite l' utilità di pianificazione.By default, the operations log keeps information about the last seven days, but this setting can be changed with the scheduler. Si vogliono cercare le esecuzioni che non hanno lo stato di operazione riuscita.You want to look for any run that does not show a success status. È possibile modificare l'ordinamento facendo clic sulle intestazioni.You can change the sorting by clicking the headers.

La colonna Status (Stato) visualizza le informazioni più importanti e segnala il problema più grave di un'esecuzione.The Status column is the most important information and shows the most severe problem for a run. Ecco un breve riepilogo degli stati disponibili, ordinati in base alla priorità con cui vanno analizzati (dove * indica diverse stringhe di errore possibili).Here is a quick summary of the most common statuses in order of priority to investigate (where * indicate several possible error strings).

StatusStatus CommentoComment
stopped-stopped- Impossibile completare l'esecuzione.The run could not complete. Ad esempio se il sistema remoto è inattivo e non può essere contattato.For example, if the remote system is down and cannot be contacted.
stopped-error-limitstopped-error-limit Sono presenti più di 5.000 errori.There are more than 5,000 errors. L'esecuzione è stata arrestata automaticamente a causa dell'elevato numero di errori.The run was automatically stopped due to the large number of errors.
completato-*-erroricompleted-*-errors L'esecuzione è stata completata, ma sono presenti errori (meno di 5.000) che devono essere analizzati.The run completed, but there are errors (fewer than 5,000) that should be investigated.
completato-*-avvisicompleted-*-warnings L'esecuzione è stata completata, ma alcuni dati non si trovano nello stato previsto.The run completed, but some data is not in the expected state. Se sono presenti errori, questo messaggio è in genere solo un sintomo.If you have errors, then this message is usually only a symptom. Evitare di analizzare gli avvisi fino a quando gli errori non sono stati risolti.Until you have addressed errors, you should not investigate warnings.
esito positivosuccess Non sono presenti problemi.No issues.

Quando si seleziona una riga, la parte inferiore viene aggiornata per visualizzare i dettagli di quella esecuzione.When you select a row, the bottom updates to show the details of that run. All'estrema sinistra della parte inferiore è possibile avere un elenco con voci del tipo Step #(Passaggio [n.]).To the far left of the bottom, you might have a list saying Step #. L'elenco è mostrato solo quando nella foresta sono presenti più domini e ogni dominio è rappresentato da un passaggio.This list only appears if you have multiple domains in your forest where each domain is represented by a step. Il nome di dominio è visibile sotto l'intestazione Partition(Partizione).The domain name can be found under the heading Partition. In Synchronization Statistics(Statistiche di sincronizzazione) sono presenti altre informazioni sul numero delle modifiche elaborate.Under Synchronization Statistics, you can find more information about the number of changes that were processed. È possibile fare clic sui collegamenti per ottenere un elenco degli oggetti modificati.You can click the links to get a list of the changed objects. Se alcuni oggetti presentano errori, questi verranno visualizzati in Synchronization Errors(Errori di sincronizzazione).If you have objects with errors, those errors show up under Synchronization Errors.

Risolvere gli errori nella scheda OperazioniTroubleshoot errors in operations tab

Sync Service Manager
In caso di errori, sia l'oggetto con l'errore che l'errore stesso appaiono sotto forma di collegamenti per la visualizzazione di altre informazioni.When you have errors, both the object in error and the error itself are links that provide more information.

Per iniziare, fare clic su una stringa di errore. Nella figura si tratta di sync-rule-error-function-triggered.Start by clicking the error string (sync-rule-error-function-triggered in the picture). Verrà prima presentata una panoramica dell'oggetto.You are first presented with an overview of the object. Per visualizzare l'errore effettivo, fare clic sul pulsante Stack Trace (Analisi dello stack).To see the actual error, click the button Stack Trace. Questa analisi indica informazioni di debug relative all'errore.This trace provides debug level information for the error.

È possibile fare clic con il pulsante destro del mouse nella casella delle call stack information (Informazioni sullo stack delle chiamate), scegliere Seleziona tutto e quindi Copia.You can right-click in the call stack information box, choose select all, and copy. Si può quindi copiare lo stack ed esaminare l'errore nell'editor preferito, ad esempio il Blocco note.You can then copy the stack and look at the error in your favorite editor, such as Notepad.

  • Se l'errore proviene da SyncRulesEngine, le informazioni sullo stack delle chiamate visualizzano prima di tutto un elenco di tutti gli attributi dell'oggetto.If the error is from SyncRulesEngine, then the call stack information first has a list of all attributes on the object. Scorrere verso il basso fino all'intestazione InnerException =>.Scroll down until you see the heading InnerException =>.
    Sync Service ManagerSync Service Manager
    L'errore è visualizzato nella riga successiva.The line after shows the error. Nell'immagine precedente l'errore proviene da una regola di sincronizzazione personalizzata creata da Fabrikam.In the picture above, the error is from a custom Sync Rule Fabrikam created.

Se l'errore non fornisce informazioni sufficienti, è necessario esaminare i dati.If the error itself does not give enough information, then it is time to look at the data itself. È possibile fare clic sul collegamento con l'identificatore dell'oggetto e continuare la risoluzione dei problemi dell'oggetto importato spazio connettore.You can click the link with the object identifier and continue troubleshooting the connector space imported object.

Proprietà dell’oggetto spazio connettoreConnector space object properties

Se nella scheda Operazioni non sono stati rilevati errori, il passaggio successivo consiste nel seguire l'oggetto spazio connettore da Active Directory, in Metaverse e in Azure AD.If you do not have any errors found in the operations tab, then the next step is to follow the connector space object from Active Directory, to the metaverse, and to Azure AD. In questo percorso, è necessario trovare il problema.In this path, you should find where the problem is.

Ricerca di un oggetto in CSSearch for an object in the CS

In Synchronization Service Manager, fare clic su Connettori, selezionare il connettore di Active Directory e scegliere Search Connector Space (Ricerca spazio connettore).In Synchronization Service Manager, click Connectors, select the Active Directory Connector, and Search Connector Space.

In Ambito selezionare RDN (quando si desidera eseguire la ricerca dell'attributo CN) o DN o ancoraggio (quando si desidera eseguire la ricerca nell'attributo distinguishedName).In Scope, select RDN (when you want to search on the CN attribute) or DN or anchor (when you want to search on the distinguishedName attribute). Immettere un valore e fare clic su Cerca.Enter a value and click Search.
Ricerca spazio connettoreConnector Space search

Se non si trova l'oggetto che si sta cercando, questo potrebbe essere stato filtrato con il filtro basato su dominio o con il filtro basato sull'unità organizzativa.If you do not find the object you are looking for, then it might have been filtered with domain-based filtering or OU-based filtering. Leggere l'argomento su come configurare il filtro per verificare che il filtro sia configurato come previsto.Read the configure filtering topic to verify that the filtering is configured as expected.

Un'altra ricerca utile consiste nel selezionare il connettore Azure AD: nell'Ambito selezionare Importazione in sospeso e quindi la casella di controllo Aggiungi.Another useful search is to select the Azure AD Connector, in Scope select Pending Import, and select the Add checkbox. Questa ricerca restituisce tutti gli oggetti sincronizzati in Azure AD che non possono essere associati a un oggetto locale.This search gives you all synchronized objects in Azure AD that cannot be associated with an on-premises object.
Orfano ricerca spazio connettoreConnector Space search orphan
Tali oggetti sono stati creati da un altro motore di sincronizzazione o da un motore di sincronizzazione con una diversa configurazione filtro.Those objects have been created by another sync engine or a sync engine with a different filtering configuration. Questa vista contiene un elenco di oggetti orfani non più gestiti.This view is a list of orphan objects no longer managed. È opportuno esaminare questo elenco e considerare la possibilità di rimuovere questi oggetti tramite il cmdlet Azure AD PowerShell.You should review this list and consider removing these objects using the Azure AD PowerShell cmdlets.

Importazione CSCS Import

Quando si apre un oggetto cs, nella parte superiore sono presenti diverse schede.When you open a cs object, there are several tabs at the top. La scheda Import (Importa) visualizza i dati di gestione temporanea dopo l'importazione.The Import tab shows the data that is staged after an import.
Oggetto CS CS object
La colonna Valore precedente mostra ciò che è attualmente memorizzato in Connect, mentre Nuovo valore ciò che è stato ricevuto dal sistema di origine e che non è stato ancora applicato.The Old Value shows what currently is stored in Connect and the New Value what has been received from the source system and has not been applied yet. Se si verifica un errore sull'oggetto, le modifiche non vengono elaborate.If there is an error on the object, then changes are not processed.

ErroreError
Oggetto CSCS object
La scheda Errore di sincronizzazione è visibile solo se si è verificato un problema con l'oggetto.The Synchronization Error tab is only visible if there is a problem with the object. Per altre informazioni, vedere l'articolo su come risolvere gli errori di sincronizzazione.For more information, see troubleshoot synchronization errors.

Derivazione CSCS Lineage

La scheda Lineage (Derivazione) visualizza la correlazione fra l'oggetto spazio connettore e l'oggetto metaverse.The lineage tab shows how the connector space object is related to the metaverse object. È possibile vedere l'ultima volta in cui il connettore ha importato una modifica dal sistema connesso e quali regole sono state applicate per popolare i dati nel metaverse.You can see when the Connector last imported a change from the connected system and which rules applied to populate data in the metaverse.
Derivazione CSCS lineage
Nella colonna Action (Azione) è presente una regola di sincronizzazione Inbound (In ingresso) con l'azione Provision (Provisioning).In the Action column, you can see there is one Inbound sync rule with the action Provision. Questo indica che l'oggetto metaverse rimarrà fino a quando sarà presente l'oggetto spazio connettore.That indicates that as long as this connector space object is present, the metaverse object remains. Se nell'elenco delle regole di sincronizzazione è invece visualizzata una regola di sincronizzazione con direzione Outbound (In uscita) e l'azione Provision (Provisioning), questo oggetto viene eliminato alla rimozione dell'oggetto metaverse.If the list of sync rules instead shows a sync rule with direction Outbound and Provision, it indicates that this object is deleted when the metaverse object is deleted.
Sync Service ManagerSync Service Manager
Si noti anche che nella colonna PasswordSync (Sincronizzazione password) lo spazio connettore in ingresso può apportare modifiche alla password poiché una regola di sincronizzazione ha il valore True.You can also see in the PasswordSync column that the inbound connector space can contribute changes to the password since one sync rule has the value True. Questa password viene poi inviata ad Azure AD attraverso la regola in uscita.This password is then sent to Azure AD through the outbound rule.

Dalla scheda Lineage (Derivazione) è possibile accedere al metaverse facendo clic su Metaverse Object Properties(Proprietà oggetto metaverse).From the lineage tab, you can get to the metaverse by clicking Metaverse Object Properties.

In fondo a tutte le schede sono disponibili due pulsanti: Preview (Anteprima) e Log (Log).At the bottom of all tabs are two buttons: Preview and Log.

PreviewPreview

La pagina Preview (Anteprima) viene usata per sincronizzare un solo oggetto.The preview page is used to synchronize one single object. È utile mentre si risolvono problemi relativi alle regole di sincronizzazione personalizzate e si vuole vedere l'effetto di una modifica su un singolo oggetto.It is useful if you are troubleshooting some custom sync rules and want to see the effect of a change on a single object. È possibile scegliere tra Sincronizzazione completa e Sincronizzazione delta. È anche possibile scegliere tra Genera anteprima, per mantenere semplicemente la modifica in memoria, ed Esegui commit anteprima, per inserire tutte le modifiche negli spazi connettore di destinazione.You can select between Full sync and Delta sync. You can also select between Generate Preview, which only keeps the change in memory, and Commit Preview, which updated the metaverse and stages all changes to target connector spaces.
Sync Service ManagerSync Service Manager
Si può esaminare l'oggetto e individuare la regola applicata per un particolare flusso di attributi.You can inspect the object and which rule applied for a particular attribute flow.
Sync Service ManagerSync Service Manager

LogLog

La pagina Log consente di visualizzare lo stato e la cronologia di sincronizzazione della password.The Log page is used to see the password sync status and history. Per altre informazioni, vedere Risolvere i problemi di sincronizzazione delle password.For more information, see Troubleshoot password synchronization.

Proprietà dell'oggetto MetaverseMetaverse object properties

In genere è preferibile iniziare la ricerca dallo spazio connettore di origine di Active Directory.It is usually better to start searching from the source Active Directory connector space. Ma è anche possibile avviare la ricerca da metaverse.But you can also start searching from the metaverse.

Ricerca di un oggetto in MVSearch for an object in the MV

In Synchronization Service Manager, fare clic su Metaverse Search (Cerca Metaverse).In Synchronization Service Manager, click Metaverse Search. Creare una query che rileva l'utente.Create a query you know finds the user. È possibile cercare gli attributi comuni, ad esempio accountName (sAMAccountName) e userPrincipalName.You can search for common attributes, such as accountName (sAMAccountName) and userPrincipalName. Per altre informazioni, vedere Cerca Metaverse.For more information, see Metaverse search. Sync Service ManagerSync Service Manager

Nella finestra Risultati della ricerca, fare clic sull'oggetto.In the Search Results window, click the object.

Se l'oggetto non è stato trovato, non ha ancora raggiunto metaverse.If you did not find the object, then it has not yet reached the metaverse. Continuare la ricerca dell'oggetto nello spazio connettore di Active Directory.Continue to search for the object in the Active Directory connector space. Potrebbe essersi verificato un errore di sincronizzazione che non consente all'oggetto di raggiungere metaverse oppure potrebbe essere stato applicato un filtro.There could be an error from synchronization that is blocking the object from coming to the metaverse or there might be a filter applied.

Attributi MVMV Attributes

Nella scheda Attributes (Attributi) è possibile visualizzare i valori e il connettore che li ha indicati.On the attributes tab, you can see the values and which Connector contributed it.
Sync Service Manager

Se un oggetto non viene sincronizzato, esaminare i seguenti attributi in metaverse:If an object is not synchronizing, then look at the following attributes in the metaverse:

  • L'attributo cloudFiltered è presente e impostato su vero?Is the attribute cloudFiltered present and set to true? In questo caso, è stato filtrato in base ai passaggi in attribute based filtering (Filtri basati sugli attributi).If it is, then it has been filtered according to the steps in attribute based filtering.
  • L'attributo sourceAnchor è presente?Is the attribute sourceAnchor present? Se non lo è, si dispone di una topologia di foresta account-risorse?If not, do you have an account-resource forest topology? Se un oggetto viene identificato come cassetta postale collegata (l'attributo msExchRecipientTypeDetails ha il valore 2), l'attributo sourceAnchor viene fornito dalla foresta con un account di Active Directory abilitato.If an object is identified as a linked mailbox (the attribute msExchRecipientTypeDetails has the value 2), then the sourceAnchor is contributed by the forest with an enabled Active Directory account. Assicurarsi che l'account principale sia stato importato e sincronizzato correttamente.Make sure the master account has been imported and synchronized correctly. L'account principale deve essere elencato tra i connettori dell'oggetto.The master account must be listed in the connectors for the object.

Connettori MVMV Connectors

La scheda Connectors (Connettori) visualizza tutti gli spazi connettore che hanno una rappresentazione dell'oggetto.The Connectors tab shows all connector spaces that have a representation of the object.
Sync Service Manager
È necessario disporre di un connettore per:You should have a connector to:

  • Ogni foresta di Active Directory in cui l'utente viene rappresentato.Each Active Directory forest the user is represented in. Questa rappresentazione può includere foreignSecurityPrincipals e gli oggetti Contatto.This representation can include foreignSecurityPrincipals and Contact objects.
  • Un connettore in Azure AD.A connector in Azure AD.

Se manca il connettore in Azure AD, leggere Attributi MV per verificare i criteri per il provisioning in Azure AD.If you are missing the connector to Azure AD, then read MV attributes to verify the criteria for being provisioned to Azure AD.

Questa scheda consente anche di passare all'oggetto spazio connettore.This tab also allows you to navigate to the connector space object. Selezionare una riga e fare clic su Proprietà.Select a row and click Properties.

Passaggi successiviNext steps

Ulteriori informazioni sulla configurazione della sincronizzazione di Azure AD Connect.Learn more about the Azure AD Connect sync configuration.

Ulteriori informazioni su Integrazione delle identità locali con Azure Active Directory.Learn more about Integrating your on-premises identities with Azure Active Directory.