Freigeben über

Beheben von Problemen mit dem Microsoft Entra Connect-Upgrade

In diesem Artikel wird beschrieben, wie Sie Probleme beheben, die auftreten können, wenn Sie von früheren Installationen von Microsoft Entra Connect, Azure AD Sync oder DirSync auf die neueste Version von Microsoft Entra Connect aktualisieren.

Warnung

Möglicherweise finden Sie einige Onlinedokumentationen, die Schritte zum direkten Bearbeiten der Windows-Registrierung enthalten. Das Bearbeiten der Registrierung kann jedoch schwerwiegende Probleme verursachen, wenn Sie die Registrierung falsch ändern. Das Microsoft Entra Connect-Produktteam unterstützt die Bearbeitung der Windows-Registrierung nicht.

Ursprüngliche Produktversion: Microsoft Entra ID
Ursprüngliche KB-Nummer: 4051210

Symptome

Jedes Mal, wenn Sie den Microsoft Entra Connect-Setup-Assistenten starten, wertet das Programm alle zugehörigen Produkte und Windows Installer-Pakete (.msi) aus, die derzeit installiert sind. Führen Sie die folgenden Schritte aus, um diese Aktivität zu verfolgen:

  1. Starten Sie den Microsoft Entra Connect-Assistenten, und warten Sie, bis die erste Seite geöffnet ist.

  2. Öffnen Sie den %ProgramData%\AADConnect\ Ordner, und analysieren Sie das neueste Installationsablaufverfolgungsprotokoll.

  3. Suchen Sie die Einträge für , für GetInstalledPackagesByUpgradeCodedie der Assistent alle zugehörigen Windows Installer-Pakete auswertet, die in Windows installiert sind. Zum Beispiel:

    [10:44:23.095] [ 1] [INFO ] Performing direct lookup of upgrade codes for: Azure AD Sync Engine
[10:44:23.095] [ 1] [VERB ] Getting list of installed packages by upgrade code
[10:44:23.095] [ 1] [INFO ] GetInstalledPackagesByUpgradeCode {545334d7-13cd-4bab-8da1-2775fa8cf7c2}: verified product code {7c4397b7-9008-4c23-8cda-3b3b8faf4312}.
[10:44:23.095] [ 1] [INFO ] GetInstalledPackagesByUpgradeCode {dc9e604e-37b0-4efc-b429-21721cf49d0d}: no registered products found.
[10:44:23.095] [ 1] [INFO ] GetInstalledPackagesByUpgradeCode {bef7e7d9-2ac2-44b9-abfc-3335222b92a7}: no registered products found.

Sie finden zwei ähnliche Symptome in der Nähe dieses Teils des Ablaufverfolgungsprotokolls:

Produkt wurde deinstalliert, aber ein inkonsistenter Produktcode ist weiterhin in Windows vorhanden. Der Assistent erkennt eine alte Installation des Synchronisierungsmoduls: "Produkt Azure AD-Synchronisierungsmodul (Version 1.1.343.0) ist installiert, muss auf Version 1.1.380.0 aktualisiert werden." 
[10:44:23.095] [ 1] [VERB ] Package=Microsoft Azure AD Connect synchronization services, Version=1.1.343.0, ProductCode=7c4397b7-9008-4c23-8cda-3b3b8faf4312, UpgradeCode=545334d7-13cd-4bab-8da1-2775fa8cf7c2
[10:44:23.095] [ 1] [INFO ] Determining installation action for Azure AD Sync Engine (545334d7-13cd-4bab-8da1-2775fa8cf7c2)
[10:44:23.298] [ 1] [VERB ] Check product code installed: {4e67cad2-d71b-4f06-a7ae-bb49c566bb93}
[10:44:23.298] [ 1] [INFO ] GetProductInfoProperty({4e67cad2-d71b-4f06-a7ae-bb49c566bb93}, VersionString): unknown product
[10:44:23.298] [ 1] [INFO ] AzureADSyncEngineComponent: Product Azure AD Sync Engine (version 1.1.343.0) is installed, needs to be upgraded to version 1.1.380.0.

Die Windows Installer-Informationen sind jedoch möglicherweise inkonsistent, nachdem dieses Produkt deinstalliert wurde und das Synchronisierungsmodul nicht mehr vorhanden ist.

Da der Setup-Assistent weiterhin einen alten Produktcode erkennt, entscheidet er sich, das Azure AD-Synchronisierungsmodul zu aktualisieren, anstatt eine Neuinstallation durchzuführen. Später im Upgradeprozess schlägt die Installation fehl, während das Installationsprogramm auf den aktuellen Dienststatus überprüft, da der ADSync-Dienst nicht vorhanden ist:

[10:44:28.260] [ 1] [INFO ] ServiceControllerProvider: verifying ADSync is in state (Running)
[10:44:28.291] [ 1] [ERROR] Caught an exception while creating the initial page set on the root page.
Exception Data (Raw): System.InvalidOperationException: Service ADSync was not found on computer '.'. ---> System.ComponentModel.Win32Exception: The specified service does not exist as an installed service
Produkt wurde deinstalliert, aber ein veralteter Produktcode ist in Windows noch vorhanden.

Ein veralteter Produktcode, den Sie in Windows Installer-Paketen finden, kann auch Upgradeprobleme verursachen.

[15:29:06.958] [ 1] [INFO ] Performing direct lookup of upgrade codes for: Azure AD Sync Engine
[15:29:06.959] [ 1] [VERB ] Getting list of installed packages by upgrade code
[15:29:06.959] [ 1] [INFO ] GetProductInfoProperty({7c4397b7-9008-4c23-8cda-3b3b8faf4312}, VersionString): unrecognized error (1608)
[15:29:06.959] [ 1] [INFO ] GetInstalledPackagesByUpgradeCode {545334d7-13cd-4bab-8da1-2775fa8cf7c2}: stale product code {7c4397b7-9008-4c23-8cda-3b3b8faf4312}.
[15:29:06.959] [ 1] [INFO ] GetInstalledPackagesByUpgradeCode {545334d7-13cd-4bab-8da1-2775fa8cf7c2}: no registered products found.
[15:29:06.959] [ 1] [INFO ] GetInstalledPackagesByUpgradeCode {dc9e604e-37b0-4efc-b429-21721cf49d0d}: no registered products found.
[15:29:06.959] [ 1] [INFO ] GetInstalledPackagesByUpgradeCode {bef7e7d9-2ac2-44b9-abfc-3335222b92a7}: no registered products found.
[15:29:06.963] [ 1] [INFO ] Determining installation action for Azure AD Sync Engine (545334d7-13cd-4bab-8da1-2775fa8cf7c2)
[15:29:07.059] [ 1] [INFO ] Product Azure AD Sync Engine is not installed.

Der Microsoft Entra Connect-Setup-Assistent kann nicht erkennen, dass ein Azure AD-Synchronisierungsmodul installiert ist. Setup schlägt fehl und gibt die folgende Fehlermeldung zurück:

[15:52:17.674] [ 13] [ERROR] PerformConfigurationPageViewModel: Caught exception while installing synchronization service.
Exception Data (Raw): System.Exception: Unable to install the Synchronization Service. Please see the event log for additional details. ---> Microsoft.Azure.ActiveDirectory.Client.Framework.ProcessExecutionFailedException: Error installing msi package 'Synchronization Service.msi'. Full log is available at 'C:\ProgramData\AADConnect\Synchronization Service_Install-20170525-155217.log'.
...
MSI (s) (C0!08) [15:52:17:605]: Product: Microsoft Azure AD Connect synchronization services -- Error 25019.The Microsoft Azure AD Connect synchronization services setup wizard cannot open registry key SYSTEM\CurrentControlSet\Services\ADSync\Parameters. Try verifying the key and running this wizard again. The system cannot find the file specified.
CustomAction DetectStoreServer returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)
Action ended 15:52:17: DetectStoreServer.
---> Microsoft.Azure.ActiveDirectory.Client.Framework.ProcessExecutionFailedException: Exception: Execution failed with errorCode: 1603.

Dieser Fehler tritt auf, da der MSIEXEC-Prozess weiterhin versucht, das Azure AD-Synchronisierungsmodul zu aktualisieren, wie in der Datei "Synchronisierung Service_Install-20170525-155217.log " dargestellt:

MSI (s) (C0:0C) [15:52:17:386]: PROPERTY CHANGE: Adding WIX_UPGRADE_DETECTED property. Its value is '{7C4397B7-9008-4C23-8CDA-3B3B8FAF4312}'.
MSI (s) (C0:0C) [15:52:17:386]: PROPERTY CHANGE: Adding MIGRATE property. Its value is '{7C4397B7-9008-4C23-8CDA-3B3B8FAF4312}'.
...
MSI (s) (C0:D4) [15:52:17:598]: Invoking remote custom action. DLL: C:\Windows\Installer\MSI1D9A.tmp, Entrypoint: DetectStoreServer
Action start 15:52:17: DetectStoreServer.
MSI (s) (C0!08) [15:52:17:605]: Product: Microsoft Azure AD Connect synchronization services -- Error 25019.The Microsoft Azure AD Connect synchronization services setup wizard cannot open registry key SYSTEM\CurrentControlSet\Services\ADSync\Parameters. Try verifying the key and running this wizard again. The system cannot find the file specified.

Wie im vorherigen Fall schlägt der Upgradevorgang von Windows Installer fehl, da die ADSync-Diensteinträge in der Registrierung nicht vorhanden sind. Das Produkt wurde zuvor deinstalliert, sodass die Windows Installer-Datenbank inkonsistent bleibt.

Lösung

Sie können die Inkonsistenz in der Windows Installer-Datenbank für den Im Ablaufverfolgungsprotokoll identifizierten Azure AD-Synchronisierungsmodul-Produktcode bereinigen. (Der Produktcode kann variieren. Für die vorherigen Beispiele ist der problematische Produktcode 7c4397b7-9008-4c23-8cda-3b3b8faf4312.)

Nachdem Sie den problematischen Produktcode aus dem Ablaufverfolgungsprotokoll identifiziert haben, verwenden Sie gegebenenfalls die folgenden Methoden.

Beheben von Windows Installer-Problemen (falls zutreffend) Der KB3139923 Windows-Hotfix kann diese Windows Installer-Probleme verursachen. Daher wird empfohlen, sie zu deinstallieren.

Um zu überprüfen, ob KB3139923 installiert ist, wechseln Sie zum Windows>Update-Einstellungsverlauf.> Oder verwenden Sie PowerShell, um eine Liste aller installierten Hotfixes zu exportieren:

Get-Hotfix |
Select-Object HotFixID, InstalledOn, Description, InstalledBy |
Sort-Object –Property InstalledOn –Descending |
Out-File –FilePath ".\$env:COMPUTERNAME-HotFixes.txt"

  1. Wenn der KB3139923 Hotfix vorhanden ist, deinstallieren Sie ihn, und starten Sie den Server neu.

  2. Laden Sie den KB3072630 Windows-Hotfix herunter, und installieren Sie es, und starten Sie dann erneut.

Verwenden des Befehlszeilentools für Windows Installer zum Deinstallieren von Produktcode

Um den Produktcode für das Azure AD-Synchronisierungsmodul zu deinstallieren, führen Sie das Windows Installer-Befehlszeilentool (MsiExec.exe) wie folgt aus:

  1. Identifizieren Sie den inkonsistenten oder veralteten Produktcode aus dem Ablaufverfolgungsprotokoll (GUID), wie im Abschnitt "Symptome" dargestellt.

  2. Öffnen Sie ein administratives Eingabeaufforderungsfenster.

  3. Geben Sie die folgende Zeile ein, indem Sie die tatsächliche GUID des problematischen Produktcodes angeben:

    SET productcode={<12345678-0000-abcd-0000-0123456789ab>}

  4. Geben Sie den folgenden Befehl ein, wiederholen Sie den Befehl, und starten Sie dann den Server neu.

    Notiz

    Möglicherweise werden zahlreiche gemeldete Fehler aufgrund der beschädigten Windows Installer-Datenbank angezeigt. Wählen Sie für jedes angezeigte Dialogfeld "Ja" aus.

    SET /a counter+=1
& MSIEXEC /x %productcode% /qn /norestart /l*v "%ProgramData%\AADConnect\AADConnect_Uninstall-ForcedUninstall_%counter%.log" EXECUTE_UNINSTALL="1"

  5. Starten Sie den Microsoft Entra Connect-Assistenten, und warten Sie, bis die erste Seite geöffnet ist.

  6. Öffnen Sie den %ProgramData%\AADConnect\ Ordner, und analysieren Sie das neueste Installationsablaufverfolgungsprotokoll.

  7. Wenn der inkonsistente oder veraltete Produktcode nicht mehr in der Protokolldatei vorhanden ist, fahren Sie mit dem Assistenten fort, und schließen Sie die Installation ab. Wechseln Sie andernfalls zur nächsten Lösung.

Programminstallations- und Deinstallations-Problembehandlungstool verwenden

Die Programminstallations- und Deinstallationsproblembehandlung hilft Ihnen dabei, Probleme automatisch zu reparieren, wenn Sie daran gehindert sind, Programme zu installieren oder zu entfernen. Außerdem werden beschädigte Registrierungsschlüssel behoben.

Beheben von Problemen, die verhindern, dass Programme installiert oder entfernt werden (microsoft.com)

Nachdem Sie das Tool ausgeführt haben, starten Sie den Server neu, und führen Sie dann die folgenden Schritte aus:

  1. Starten Sie den Microsoft Entra Connect-Assistenten, und warten Sie, bis die erste Seite geöffnet ist.

  2. Öffnen Sie den %ProgramData%\AADConnect\ Ordner, und analysieren Sie das neueste Installationsablaufverfolgungsprotokoll.

  3. Wenn der inkonsistente oder veraltete Produktcode nicht mehr in der Protokolldatei vorhanden ist, fahren Sie mit dem Assistenten fort, und schließen Sie die Installation ab. Wenn der veraltete Produktcode vorhanden ist, empfehlen wir, das Windows-Betriebssystem neu zu installieren, da Sie die Windows Installer-Datenbank nicht aus einem inkonsistenten Zustand wiederherstellen können.

Kontaktieren Sie uns für Hilfe

Wenn Sie Fragen haben oder Hilfe mit Ihren Azure-Gutschriften benötigen, dann erstellen Sie beim Azure-Support eine Support-Anforderung oder fragen Sie den Azure Community-Support. Sie können auch Produktfeedback an die Azure Feedback Community senden.