Freigeben über


Microsoft Entra Connect: Automatisches Upgrade

Das automatische Upgrade von Microsoft Entra Connect ist ein Feature, das regelmäßig überprüft, ob neuere Versionen von Microsoft Entra Connect vorhanden sind. Wenn Ihr Server für automatische Upgrades aktiviert und eine neuere Version verfügbar ist, führt er ein automatisches Upgrade auf die neuere Version durch. Aus Sicherheitsgründen überprüft der Agent, der das automatische Upgrade durchführt, den neuen Build von Microsoft Entra Connect anhand der digitalen Signatur der heruntergeladenen Version.

Hinweis

Microsoft Entra Connect folgt der Modern Lifecycle-Richtlinie. Änderungen für Produkte und Dienstleistungen im Rahmen der Modern Lifecycle-Azure Policy können häufiger sein und erfordern, dass Kunden auf bevorstehende Änderungen an ihrem Produkt oder ihrer Dienstleistung achten.

Produkte, die der Modern Policy unterliegen, folgen einem kontinuierlichen Support- und Wartungsmodell. Kunden müssen das neueste Update verwenden, um weiterhin unterstützt zu werden.

Für Produkte und Dienste, die der Modern Lifecycle-Azure Policy unterliegen, sieht die Richtlinie von Microsoft vor, Kunden mindestens 30 Tage im Voraus zu benachrichtigen, wenn Maßnahmen ergriffen werden müssen, um eine erhebliche Beeinträchtigung der normalen Nutzung des Produkts oder Dienstes zu vermeiden.

Überblick

Noch nie konnten Sie so leicht sicherstellen, dass Ihre Microsoft Entra Connect-Installation immer auf dem neuesten Stand ist – mit dem automatischen Upgradefeature . Dieses Feature ist standardmäßig für Express-Installationen und DirSync-Upgrades aktiviert. Wenn eine neue Version veröffentlicht wird, erfolgt ein automatisches Upgrade Ihrer Installation. Das automatische Upgrade ist in folgenden Fällen standardmäßig aktiviert:

  • Installationen mit Express-Einstellungen und DirSync-Upgrades.
  • Verwendung von SQL Express LocalDB (wird bei Express-Einstellungen immer verwendet). DirSync mit SQL Express verwendet ebenfalls LocalDB.
  • Das AD-Konto ist das MSOL_-Standardkonto, das mit den Express-Einstellungen und DirSync erstellt wird
  • Es sind weniger als 100.000 Objekte im Metaverse enthalten.

Der aktuelle Zustand des automatischen Upgrades kann über das PowerShell-Cmdlet Get-ADSyncAutoUpgradeangezeigt werden. Folgende Zustände sind möglich:

State Comment
Aktiviert Das automatische Upgrade ist aktiviert.
Ausgesetzt Nur vom System festgelegt. Das System ist derzeit nicht zum Erhalten automatischer Upgrades berechtigt.
Disabled Das automatische Upgrade ist deaktiviert.

Mit Set-ADSyncAutoUpgrade können Sie zwischen aktiviert und deaktiviert wechseln. Nur das System sollte den Zustand Ausgesetztfestlegen. Vor Version 1.1.750.0 hat das Cmdlet „Set-ADSyncAutoUpgrade“ das automatische Upgrade blockiert, wenn der Status für automatische Upgrades auf „Angehalten“ festgelegt war. Diese Funktion wurde so aktualisiert, dass automatische Upgrades nicht blockiert werden.

Das automatische Upgrade verwendet Microsoft Entra Connect Health als Upgrade-Infrastruktur. Damit das automatische Upgrade funktioniert, müssen Sie unbedingt die URLs in Ihrem Proxyserver für Microsoft Entra Connect Health zulassen, wie unter Microsoft 365-URLs und -IP-Adressbereiche beschrieben.

Wenn auf dem Server die Synchronization Service Manager -Benutzeroberfläche geöffnet ist, wird das Upgrade angehalten, bis die Benutzeroberfläche geschlossen wird.

Hinweis

Nicht alle Versionen von Microsoft Entra Connect werden für automatische Aktualisierungen zur Verfügung gestellt. Aus dem Releasestatus geht hervor, ob für ein Release das automatische Upgrade oder nur der Download verfügbar ist. Wenn das automatische Upgrade auf Ihrem Microsoft Entra Connect-Server aktiviert ist und Ihre Konfiguration für das automatische Upgrade berechtigt ist, wird dieser Server automatisch auf die neueste Version von Microsoft Entra Connect aktualisiert, die für das automatische Upgrade veröffentlicht wird. Weitere Informationen zu diesem Update finden Sie unter Microsoft Entra Connect: Verlauf der Versionsveröffentlichungen.

Berechtigung für automatische Upgrades

Das automatische Upgrade kann nicht fortgesetzt werden, wenn eine der folgenden Bedingungen erfüllt ist:

Ergebnismeldung BESCHREIBUNG
UpgradeNotSupportedCustomizedSyncRules In Microsoft Entra Connect sind benutzerdefinierte Synchronisierungsregeln konfiguriert.
Hinweis: Nach Version 2.2.1.0 verhindert diese Bedingung automatische Upgrades nicht mehr.
UpgradeNotSupportedInvalidPersistedState Die Installation ist keine Express-Einstellung und kein DirSync-Upgrade.
UpgradeNotSupportedNonLocalDbInstall Sie verwenden keine SQL Server Express LocalDB-Datenbank.
UpgradeNotSupportedLocalDbSizeExceeded Lokale Datenbank ist größer als oder gleich 8 GB
UpgradeNotSupportedAADHealthUploadDisabled Uploads von Integritätsdaten sind derzeit über das Portal deaktiviert.

Problembehandlung

Wenn das automatische Upgrade Ihrer Connect-Installation nicht wie erwartet funktioniert, befolgen Sie diese Schritte, um herauszufinden, wo der Fehler liegen könnte.

Zunächst einmal sollten Sie nicht erwarten, dass direkt am Erscheinungstag einer neuen Version versucht wird, ein automatisches Upgrade durchzuführen. Upgrades unterliegen einer beabsichtigten Zufälligkeit – Sie müssen sich also keine Sorgen machen, wenn Ihre Installation nicht sofort aktualisiert wird.

Wenn Sie der Meinung sind, dass ein Fehler vorliegt, führen Sie zuerst Get-ADSyncAutoUpgrade aus, um sicherzustellen, dass automatische Upgrades aktiviert sind.

Wenn der Status „Angehalten“ lautet, können Sie den Grund mit dem Befehl Get-ADSyncAutoUpgrade -Detail anzeigen. Der Grund für das Anhalten kann einen beliebigen Zeichenfolgenwert enthalten, in der Regel wird jedoch der Zeichenfolgenwert von UpgradeResult angegeben, d. h. UpgradeNotSupportedNonLocalDbInstall oder UpgradeAbortedAdSyncExeInUse. Es kann auch ein zusammengesetzter Wert zurückgegeben werden, z. B. UpgradeFailedRollbackSuccess-GetPasswordHashSyncStateFailed.

Es kann auch sein, dass ein Ergebnis angezeigt wird, das nicht dem Wert von UpgradeResult entspricht, d. h. AADHealthEndpointNotDefined oder DirSyncInPlaceUpgradeNonLocalDb.

Stellen Sie dann sicher, dass Sie die erforderlichen URLs in Ihrem Proxy oder in der Firewall zulassen. Die automatische Aktualisierung verwendet Microsoft Entra Connect Health wie in der Übersichtbeschrieben. Wenn Sie einen Proxy verwenden, vergewissern Sie sich, dass Health für die Verwendung eines Proxyservers konfiguriert ist. Testen Sie außerdem die Integritätskonnektivität bei Microsoft Entra ID.

Nachdem Sie die Konnektivität mit Microsoft Entra ID überprüft haben, sehen Sie sich nun die Ereignisprotokolle an. Starten Sie die Ereignisanzeige, und sehen Sie sich das Ereignisprotokoll für die Anwendung an. Fügen Sie einen Ereignisprotokollfilter für die Quelle Microsoft Entra Connect Upgrade und den Ereignis-ID-Bereich 300-399 hinzu.
Screenshot des Fensters „Aktuelles Protokoll filtern“, auf dem das Feld „Ereignisquellen“ sowie das Feld „Einschließen/ausschließen“ für die Event-ID hervorgehobenen werden.

So können Sie alle Ereignisprotokolle anzeigen, die dem Status für das automatische Upgrade zugeordnet sind.
Ereignisprotokollfilter für das automatische Upgrade

Der Ergebniscode hat ein Präfix mit einer Übersicht über den Status.

Ergebniscodepräfix BESCHREIBUNG
Erfolg Das Upgrade der Installation wurde erfolgreich durchgeführt.
UpgradeAborted Das Upgrade wurde durch ein temporäres Problem angehalten. Es erfolgt ein erneuter Versuch, und es wird davon ausgegangen, dass das Upgrade später erfolgreich durchgeführt werden kann.
UpgradeNotSupported Die Konfiguration des Systems blockiert das automatische Upgrade. Es erfolgt ein erneuter Upgradeversuch, um zu ermitteln, ob sich der Status ändert. Es ist jedoch damit zu rechnen, dass das Upgrade für das System manuell durchgeführt werden muss.

Im Folgenden finden Sie eine Liste der Meldungen, die am häufigsten angezeigt werden. Es sind nicht alle Meldungen aufgeführt, aber aus den Ergebnismeldungen sollte klar hervorgehen, was das Problem ist.

Ergebnismeldung BESCHREIBUNG
UpgradeAborted
UpgradeAbortedCouldNotSetUpgradeMarker Das Schreiben in der Registrierung war nicht möglich.
UpgradeAbortedInsufficientDatabasePermissions Die integrierte Administratorengruppe verfügt nicht über die erforderlichen Berechtigungen für die Datenbank. Führen Sie ein manuelles Upgrade auf die aktuelle Version von Microsoft Entra Connect aus, um dieses Problem zu beheben.
UpgradeAbortedInsufficientDiskSpace Es ist nicht genügend Speicherplatz für ein Upgrade vorhanden.
UpgradeAbortedSecurityGroupsNotPresent Es konnten nicht alle Sicherheitsgruppen gefunden und aufgelöst werden, die von der Synchronisierungs-Engine verwendet werden.
UpgradeAbortedServiceCanNotBeStarted Der NT-Dienst Microsoft Entra ID Sync konnte nicht gestartet werden.
UpgradeAbortedServiceCanNotBeStopped Der NT-Dienst Microsoft Entra ID Sync konnte nicht angehalten werden.
UpgradeAbortedServiceIsNotRunning Der NT-Dienst Microsoft Entra ID Sync wird nicht ausgeführt.
UpgradeAbortedSyncCycleDisabled Die SyncCycle-Option im Planer ist derzeit deaktiviert.
UpgradeAbortedSyncExeInUse Die Synchronization Service Manager-Benutzeroberfläche ist auf dem Server geöffnet.
UpgradeAbortedSyncOrConfigurationInProgress Der Installations-Assistent wird ausgeführt, oder es wurde eine Synchronisierung außerhalb des Schedulers geplant.
UpgradeNotSupported
UpgradeNotSupportedCustomizedSyncRules In Microsoft Entra Connect sind benutzerdefinierte Synchronisierungsregeln konfiguriert.
UpgradeNotSupportedInvalidPersistedState Die Installation ist keine Express-Einstellung und kein DirSync-Upgrade.
UpgradeNotSupportedNonLocalDbInstall Sie verwenden keine SQL Server Express LocalDB-Datenbank.
UpgradeNotSupportedLocalDbSizeExceeded Lokale Datenbank ist größer als oder gleich 8 GB
UpgradeNotSupportedAADHealthUploadDisabled Uploads von Integritätsdaten sind derzeit über das Portal deaktiviert.

Nächste Schritte

Weitere Informationen finden Sie unter Integrieren Ihrer lokalen Identitäten in Microsoft Entra ID.