Risolvere gli errori di installazione e configurazione guidata dello strumento di sincronizzazione di Azure Active Directory

Articolo
04/13/2024

Questo articolo descrive come risolvere i problemi relativi all'installazione dello strumento di sincronizzazione di Azure Active Directory e alla Configurazione guidata strumento di sincronizzazione directory.

Versione originale del prodotto: Microsoft Entra ID, Microsoft Intune, Backup di Azure, Office 365 Identity Management
Numero KB originale: 2684395

Introduzione

Questo articolo fornisce soluzioni e cause comuni dei messaggi di errore che possono verificarsi quando si installa o si configura lo strumento Sincronizzazione directory.

Controllare i requisiti di sistema

Lo strumento di sincronizzazione di Azure Active Directory può essere installato in un computer se si verificano tutte le condizioni seguenti:

Windows PowerShell 1.0 è installato nel computer.
Si è connessi al computer come membro del gruppo Administrators locale.
Il computer ha un processore a 64 bit.
Il computer esegue uno dei sistemi operativi seguenti:
- Windows Server 2003 x64 con Service Pack 2 (SP2) o versione successiva
- Una versione basata su x64 di Windows Server 2008
Il computer non è un controller di dominio.
Il computer è aggiunto a un dominio di Active Directory. Si trova nella foresta con cui si vuole eseguire la sincronizzazione con Microsoft Entra ID.
Nel computer viene installato Microsoft .NET Framework 3.5 o una versione successiva.

Controllare le autorizzazioni.

Per avviare correttamente la Configurazione guidata strumento di sincronizzazione directory, gli utenti che accedono al computer in cui è installato lo strumento Sincronizzazione directory devono essere membri del gruppo di amministratori di Microsoft Identity Integration Server (MIIS) locale aggiunto durante l'installazione dello strumento.

Quando si esegue la Configurazione guidata strumento di sincronizzazione directory, è necessario fornire le informazioni seguenti:

Credenziali di amministratore dell'organizzazione per lo schema di Active Directory locale
Credenziali di amministratore globale per il servizio cloud Microsoft

Controllare la connettività del dominio usando nltest

Nltest è uno strumento da riga di comando integrato in Windows Server. È disponibile come parte degli strumenti di amministrazione remota del server per Windows 10.

Per controllare i controller di dominio del dominio, eseguire il comando seguente al prompt dei comandi:

nltest /dsgetdc:<FQDN of the domain>

Nota

Lo nltest strumento richiede l'installazione degli strumenti di supporto di Windows Server 2003.

Se le impostazioni sono corrette, l'output è simile all'esempio seguente:

DC: \DC.contoso.com 
Address:\ <IP Address> 
Dom Guid: <GUID> 
Dom Name: contoso.com 
Forest Name: contoso.com 
DC Site Name: Default-First-Site-Name 
Our Site Name: Default-First-Site-Name 
Flags: PDC GC DS LDAP KDC TIMESERV GTIMESERV WRITABLE DNS_DC DNS_DOMAIN DNS_FOREST CLOSE_SITE 
The command completed successfully

Per controllare l'appartenenza al sito del computer, eseguire il comando seguente al prompt dei comandi:
```
nltest /dsgetsite
```
Un risultato riuscito è simile all'esempio seguente:
```
Default-First-Site-Name 
The command completed successfully
```

Errore 1: Il computer deve essere aggiunto a un dominio

Per risolvere questo problema, controllare l'appartenenza al dominio del computer seguendo questa procedura:

Accedere al computer.
Fare clic con il pulsante destro del mouse su Risorse del computer, quindi selezionare Proprietà.
Selezionare la scheda Nome computer . Se il computer è un membro di dominio, il nome completo del computer è simile ComputerName.Domain.xxx. Il nome di dominio viene visualizzato accanto a Dominio.

Se il computer è un membro di dominio e viene comunque visualizzato il messaggio di errore, verificare che:

Il computer può comunicare con il dominio.
Il computer può individuare il controller di dominio.

A tale scopo, seguire questa procedura:

Usare lo strumento da ipconfig riga di comando per controllare le impostazioni DNS (Domain Name System) nel server.
Verificare che sia possibile effettuare il ping del server DNS elencato nelle proprietà di rete nel computer con problemi.
Eseguire lo strumento da nslookup riga di comando. Se il server DNS non è raggiungibile, viene visualizzato un messaggio di errore. Ad esempio, viene visualizzato un messaggio di errore simile all'esempio seguente:

Timeout della richiesta DNS.
il timeout è stato di 2 secondi.
Non è possibile trovare il nome del server per l'indirizzo IP dell'indirizzo<>: timeout
Server predefinito: UnKnown
Indirizzo: <Indirizzo IP>

In alcuni casi, l'aggiunta del computer a un gruppo di lavoro e l'aggiunta del computer al dominio possono risolvere questo messaggio di errore. Se il computer non è in grado di aggiungere il dominio, indica uno dei problemi seguenti:

Il computer sta riscontrando un problema durante il contatto con i controller di dominio.
Il dominio di Active Directory rifiuta la richiesta.

Errore 2: Lo strumento di sincronizzazione di Azure Active Directory è già installato

In questo caso, lo strumento Sincronizzazione directory potrebbe non essere installato a causa di un'installazione in sospeso precedente. Il pacchetto di installazione installa anche il software in background durante l'installazione. Per risolvere il problema, seguire la procedura seguente:

In Pannello di controllo verificare se Microsoft Identity Integration Server è elencato in Installazione applicazioni o Programmi e funzionalità. Se è presente, è necessario rimuoverlo.
Verificare che la cartella Programmi contenga una sottocartella denominata Microsoft Identity Integration Server. Se la sottocartella esiste, è necessario rinominare la cartella in Microsoft Identity Integration Server_Old.
Eseguire di nuovo il programma di installazione.

Risolvere altri messaggi di errore

Tutta la registrazione della sincronizzazione della directory è visualizzabile in Visualizzatore eventi. Per visualizzare tutti gli eventi correlati alla sincronizzazione della directory, seguire questa procedura:

Aprire Visualizzatore eventi.
Espandere Log di Windows e quindi Applicazione.
Nel riquadro Azioni selezionare Filtra log corrente.
Nella casella Origini eventi selezionare la casella di controllo Sincronizzazione directory .
Seleziona OK. Nella tabella seguente sono elencati il nome dell'errore, i dettagli dell'errore, l'origine degli errori e i passaggi per risolvere l'errore.

Nome errore	Dettagli	Origine	Risoluzione
AdminRequired	Le autorizzazioni di amministratore locale sono necessarie per installare la sincronizzazione della directory	Visualizzatore eventi/Richiesta di errore
DirSyncAlreadyInstalled	Lo strumento Sincronizzazione directory è già installato. Versione {0}	Visualizzatore eventi	Disinstallare tutte le versioni precedenti dello strumento Sincronizzazione directory prima di provare a installare la versione più recente.
DirSyncInstallKeyNotRemoved	Windows Installer non è riuscito a rimuovere la chiave del Registro di sistema di disinstallazione dall'identità del servizio sincronizzazione di Azure Active Directory. Ripetere la disinstallazione o contattare il supporto tecnico Microsoft Online.	Visualizzatore eventi	Rimuovere manualmente le chiavi del Registro di sistema per completare l'installazione.
DirSyncNotInstalledError	Non è stata rilevata un'installazione completa dello strumento di sincronizzazione di Azure Active Directory nel computer. Disinstallare tutte le versioni di questo strumento e quindi reinstallare la versione più recente.	Visualizzatore eventi	Disinstallare tutte le versioni precedenti dello strumento Sincronizzazione directory prima di provare a installare la versione più recente.
ErrorReRunConfigWizard	Impossibile avviare la sincronizzazione a causa di problemi di configurazione. Per risolvere i problemi, provare a eseguire la Configurazione guidata. Se l'errore persiste, contattare il supporto tecnico Microsoft Online.	Visualizzatore eventi	Eseguire la Configurazione guidata strumento di sincronizzazione directory.
WindowsInstaller45Required	Microsoft Windows Installer 4.5 è necessario per l'installazione. Installare Microsoft Windows Installer 4.5 e riprovare.	Visualizzatore eventi	Assicurarsi che il server in cui viene installato lo strumento di sincronizzazione directory soddisfi i requisiti minimi.
ErrorClearRunHistory	Impossibile cancellare la cronologia di esecuzione nel server MIIS. L'errore restituito è '{0}'. Contattare il supporto tecnico microsoft online.	Visualizzatore eventi
ErrorNoStartConnection	Impossibile avviare la sincronizzazione a causa di problemi di connessione o non è stato possibile contattare i controller di dominio dal server. Verificare di essere connessi al server e che tutti i controller di dominio configurati siano connessi alla rete. Se il dominio o il contesto di denominazione sono stati eliminati di recente, eseguire di nuovo la Configurazione guidata.	Visualizzatore eventi	Verificare che sia possibile accedere ai controller di dominio Active Directory locali dal server che esegue lo strumento Sincronizzazione directory.
ErrorNoStartCredentials	Impossibile avviare la sincronizzazione a causa di problemi di credenziali. Rieseguire la Configurazione guidata per aggiornare le credenziali per la sincronizzazione.	Visualizzatore eventi	Eseguire la Configurazione guidata strumento di sincronizzazione directory e immettere nuovamente le credenziali. Verificare inoltre che le credenziali abbiano accesso come amministratore al portale.
ErrorNoStartNoDomainController	Impossibile avviare la sincronizzazione perché il controller di dominio non è stato contattato dal server. Verificare che il controller di dominio sia connesso alla rete.	Visualizzatore eventi	Verificare che sia possibile accedere ai controller di dominio Active Directory locali dal server che esegue lo strumento Sincronizzazione directory.
ErrorStoppedConnectivity	La sincronizzazione è stata arrestata a causa della perdita di connettività. Ripristinare la connettività al server.		Verificare che il computer locale possa accedere a Internet. Fare in modo che l'utente provi a effettuare il ping `provisioning.microsoftonline.com` per verificare che il computer possa raggiungere il sistema di autenticazione Microsoft Entra.
ErrorStoppedDatabaseDiskFull	La sincronizzazione è stata arrestata perché il database SQL Server usato dal server di sincronizzazione è pieno. Creare spazio nel database SQL Server.	Visualizzatore eventi	Liberare spazio nell'archiviazione usata per contenere il database SQL di sincronizzazione della directory. Se il problema non viene risolto, lo strumento Sincronizzazione directory non sarà in grado di essere eseguito correttamente e il database SQL potrebbe essere danneggiato definitivamente.
InstallNotAllowedOnDomainController	La coesistenza di Microsoft Online Services non può essere installata in un controller di dominio.	Visualizzatore eventi	Lo strumento Sincronizzazione directory può essere installato solo nei computer aggiunti a un dominio che non sono controller di dominio.
InstallPathLengthTooLong	Il percorso di installazione è troppo lungo. Specificare un percorso di almeno 116 caratteri e riprovare.	Visualizzatore eventi	Se si usa un percorso personalizzato per l'installazione dello strumento Sincronizzazione directory, il percorso totale deve contenere meno di 116 caratteri.
InsufficientDiskSpace	Spazio su disco insufficiente	Visualizzatore eventi	Spazio insufficiente per installare lo strumento Sincronizzazione directory nella workstation locale.
InvalidPlatform	Lo strumento di sincronizzazione di Azure Active Directory deve essere installato in un computer che esegue Windows Server 2003 Service Pack 2 o versione successiva.	Visualizzatore eventi	Assicurarsi che il server in cui viene installato lo strumento di sincronizzazione directory soddisfi i requisiti minimi.
InvalidUPNFormat	Nome entità utente (UPN) è il nome di accesso. Questo errore viene visualizzato quando l'utente immette le credenziali per Microsoft Online che non contengono un carattere "@".	Visualizzatore eventi	Immettere credenziali valide.
ADCredsNotValid	Le credenziali di amministratore dell'organizzazione specificate non sono valide. Specificare credenziali valide e riprovare.	Visualizzatore eventi	L'installazione guidata non è riuscita a verificare che l'account utente usato per installare lo strumento sia un amministratore dell'organizzazione.
MachineIsDomainJoinedUserIsNot	Il computer è aggiunto a un dominio, ma le credenziali utente correnti non dispongono delle autorizzazioni di accesso per il dominio.	Visualizzatore eventi	Accedere come utente di dominio usando un account che soddisfi i requisiti minimi prima di provare a installare lo strumento Sincronizzazione directory.
MachineIsNotDomainJoined	Il computer non è aggiunto ad alcun dominio.	Visualizzatore eventi	Assicurarsi che il server in cui è installato lo strumento di sincronizzazione directory soddisfi i requisiti minimi.
MachineNotDomainJoined	Il computer deve essere aggiunto a un dominio.	Visualizzatore eventi	Assicurarsi che il server in cui è installato lo strumento di sincronizzazione directory soddisfi i requisiti minimi.
MIISSyncIsInProgressError	Il motore di sincronizzazione è occupato. Ripetere l'operazione al termine della sessione di sincronizzazione.	Visualizzatore eventi	È in corso il completamento di un'operazione esistente da parte di MIIS. Qualsiasi nuova operazione può essere completata solo dopo il completamento dell'operazione corrente.
MIISUserAddRight_AccountNotFound	Impossibile trovare il nome dell'account:'{0}''. Codice errore:{1}	Visualizzatore eventi	Lo strumento Sincronizzazione directory non è riuscito ad aggiungere l'account locale usato per completare l'installazione al gruppo di Amministrazione MIIS. Aggiungere manualmente l'utente al gruppo per continuare con l'installazione.
MIISUserAddRight_AddFailed	Impossibile aggiungere '{0}' ai diritti dell'account per '{1}'. Codice di errore:{2}	Visualizzatore eventi	Lo strumento Sincronizzazione directory non è riuscito ad aggiungere l'account locale usato per completare l'installazione al gruppo di Amministrazione MIIS. Aggiungere manualmente l'utente al gruppo per continuare con l'installazione.
MIISUserAddRight_PolicyHandleNotFound	Impossibile ottenere l'handle dei criteri. Codice errore:{0}	Visualizzatore eventi	Lo strumento Sincronizzazione directory non è riuscito ad aggiungere l'account locale usato per completare l'installazione al gruppo di Amministrazione MIIS. Aggiungere manualmente l'utente al gruppo per continuare con l'installazione.
PowerShellRequired	PowerShell deve essere installato.	Visualizzatore eventi	Assicurarsi che il server in cui è installato lo strumento di sincronizzazione directory soddisfi i requisiti minimi.
UnsupportedNameFormat	Il formato del nome non è supportato. Due esempi dei formati di nome utente supportati sono: `someone@example.com` o `example\someone`.	Visualizzatore eventi	Immettere credenziali valide.
UserNotAMemberOfMIISAdmins	L'utente corrente non è membro del gruppo di Amministrazione Microsoft Identity Integration Server (MIIS). Se di recente è stato installato lo strumento di sincronizzazione di Azure Active Directory, potrebbe essere necessario disconnettersi e quindi accedere.	Visualizzatore eventi	Aggiungere manualmente l'account utente locale di Active Directory usato per eseguire lo strumento Sincronizzazione directory al gruppo di Amministrazione MIIS.
UserNotAnEnterpriseAdmin	L'utente '{0}' non è membro del gruppo Enterprise Admins.	Visualizzatore eventi	Aggiungere manualmente l'account utente di Active Directory locale usato per eseguire lo strumento Sincronizzazione directory al gruppo di Amministrazione Active Directory Enterprise.
UnsupportedClientVersion	Questa versione dello strumento Sincronizzazione directory non è più supportata. Rimuovere questa versione e quindi installare la versione più recente dalla pagina Sincronizzazione directory della scheda Migrazione nell'Interfaccia di amministrazione di Microsoft Online Services.	Visualizzatore eventi	Scaricare la versione più recente dello strumento Sincronizzazione directory. A tale scopo, passare a Installare o aggiornare lo strumento Sincronizzazione directory.
InternetQueryOptionError	Le impostazioni proxy di Internet Explorer non sono state lette. La configurazione iniziale tramite la configurazione guidata potrebbe non essere in grado di accedere alla Guida online. Errore di WinInet {0}	Visualizzatore eventi	L'installazione guidata non è riuscita a leggere o modificare le impostazioni proxy in Internet Explorer. Verificare che le impostazioni proxy impostate in Internet Explorer siano formattate correttamente.
InternetSetOptionError	Le impostazioni proxy di Internet Explorer non sono state impostate. La configurazione iniziale tramite la configurazione guidata potrebbe non essere in grado di accedere alla Guida online. Errore di WinInet {0}	Visualizzatore eventi	L'installazione guidata non è riuscita a leggere o modificare le impostazioni proxy in Internet Explorer. Verificare che le impostazioni proxy impostate in Internet Explorer siano formattate correttamente.
RichCoexistenceNotAllowed	Nella directory locale corrente non è installato Exchange 2010. La coesistenza avanzata non è consentita.	Visualizzatore eventi	Installare tutti i prerequisiti per una distribuzione ibrida prima di provare a installare lo strumento Sincronizzazione directory.

Contattaci per ricevere assistenza

In caso di domande o bisogno di assistenza, creare una richiesta di supporto tecnico oppure formula una domanda nel Supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.