Freigeben über

Problembehandlung bei Agent-Installation und Serverregistrierung

Nach der Bereitstellung des Speichersynchronisierungsdiensts bestehen die nächsten Schritte bei der Bereitstellung der Azure-Dateisynchronisierung im Installieren des Azure-Dateisynchronisierungs-Agents und im Registrieren von Windows Server beim Speichersynchronisierungsdienst. Dieser Artikel hilft Ihnen bei der Behandlung und Behebung von Problemen, die bei diesen Schritten auftreten können.

Installation des Agenten

Überprüfen, ob eine Installation des Azure File Sync-Agents einen Neustart erfordert

Die Installation eines Azure-Dateisynchronisierung-Agents benötigt möglicherweise einen Neustart, um den Vorgang abzuschließen. Beispielsweise erfordert Azure-Dateisynchronisierung Agent Version 19.1.0.0 einen Neustart auf Servern, wenn eine Aktualisierung von einer früheren Version als 18.2.0.0 erforderlich ist.

Wenn der Agent mithilfe des Features für das automatische Upgrade aktualisiert wird, führen Sie die folgenden PowerShell-Befehle aus, um zu überprüfen, ob ein Neustart erforderlich ist, um das automatische Upgrade des Agents abzuschließen:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Get-StorageSyncServer

Wenn der Wert für die RebootNeeded Eigenschaft lautet True, ist ein Neustart erforderlich.

Agent-Update wird nicht abgeschlossen

Beim Upgrade des Azure File Sync-Agents treten möglicherweise eines der folgenden Symptome auf:

  • AfsUpdater.exe hängt bei "Installieren von Updates".
  • Die Agent-Installation hängt bei "Beenden des Überwachungs-Agents" auf.

Dieses Problem tritt auf, wenn die derzeit installierte Azure File Sync-Agent-Version vor v16.2 liegt und der Logman.exe Prozess nicht heruntergefahren wird.

Führen Sie die folgenden Schritte aus, um das Problem zu beheben:

  1. Öffnen Sie den Task-Manager.
  2. Klicken Sie mit der rechten Maustaste auf den LogMan-Prozess , und wählen Sie "Aufgabe beenden" aus. Wiederholen Sie diesen Schritt, bis alle LogMan-Prozesse beendet werden und die Agentaktualisierung erfolgreich abgeschlossen wurde.

Behandeln von Fehlern bei der Agentinstallation

Wenn die Azure-Dateisynchronisierung Agent-Installation fehlschlägt, suchen Sie die Installationsprotokolldatei, die sich im Agent-Installationsverzeichnis befindet. Wenn der Azure File Sync-Agent auf dem C: -Volume installiert ist, befindet sich die Installationsprotokolldatei unter "C:\Programme\Azure\StorageSyncAgent\InstallerLog".

Notiz

Wenn der Azure-Dateisynchronisierung-Agent über die Befehlszeile installiert und der /l\*v Switch verwendet wird, befindet sich die Protokolldatei im Pfad, in dem die Agentinstallation ausgeführt wurde.

Der Name der Protokolldatei für Agentinstallationen mit dem MSI-Paket lautet "AfsAgentInstall". Der Name der Protokolldatei für Agentinstallationen mit dem MSP-Paket (Updatepaket) ist AfsUpdater.

Nachdem Sie die Protokolldatei für die Agent-Installation gefunden haben, öffnen Sie die Datei, und suchen Sie am Ende des Protokolls nach dem Fehlercode. Wenn Sie nach "Fehlercode 1603" oder "Sandbox" suchen, sollten Sie den Fehlercode finden können.

Hier ist ein Codeausschnitt aus einer Agentinstallation, bei der ein Fehler aufgetreten ist:

CAQuietExec64:      + CategoryInfo          : SecurityError: (:) , PSSecurityException  
CAQuietExec64:      + FullyQualifiedErrorId : UnauthorizedAccess  
CAQuietExec64:  Error 0x80070001: Command line returned an error.  
CAQuietExec64:  Error 0x80070001: QuietExec64 Failed  
CAQuietExec64:  Error 0x80070001: Failed in ExecCommon64 method  
CustomAction SetRegPIIAclSettings returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)  
Action ended 12:23:40: InstallExecute. Return value 3.  
MSI (s) (0C:C8) [12:23:40:994]: Note: 1: 2265 2:  3: -2147287035

In diesem Beispiel ist die Agentinstallation mit dem Fehlercode -2147287035 (ERROR_ACCESS_DENIED) fehlgeschlagen.

Fehler bei der Agent-Installation mit fehler ERROR_NO_SYSTEM_RESOURCES und Fehlercode 0x800705AA

Fehler bei der Agent-Installation aufgrund unzureichender Systemressourcen. Um dieses Problem zu beheben, geben Sie Arbeitsspeicher auf dem Server frei, und wiederholen Sie die Installation.

Fehler bei der Agent-Installation: Setup-Assistent für den Speichersynchronisierungs-Agenten wurde aufgrund eines Fehlers vorzeitig beendet

Im Agent-Installationsprotokoll wird der folgende Fehler protokolliert:

CAQuietExec64:      + CategoryInfo          : SecurityError: (:) , PSSecurityException  
CAQuietExec64:      + FullyQualifiedErrorId : UnauthorizedAccess  
CAQuietExec64:  Error 0x80070001: Command line returned an error.  
CAQuietExec64:  Error 0x80070001: QuietExec64 Failed  
CAQuietExec64:  Error 0x80070001: Failed in ExecCommon64 method  
CustomAction SetRegPIIAclSettings returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)  
Action ended 12:23:40: InstallExecute. Return value 3.  
MSI (s) (0C:C8) [12:23:40:994]: Note: 1: 2265 2:  3: -2147287035

Dieses Problem tritt auf, wenn die PowerShell-Ausführungsrichtlinie mithilfe von Gruppenrichtlinien konfiguriert ist und die Richtlinieneinstellung "Nur signierte Skripts zulassen" lautet. Alle Skripts, die im Azure File Sync-Agent enthalten sind, sind signiert. Die Agent-Installation der Azure-Dateisynchronisierung wird mit einem Fehler abgebrochen, weil das Installationsprogramm die Skriptausführung mit der Ausführungsrichtlinieneinstellung „Umgehen“ durchführt.

Um dieses Problem zu beheben, deaktivieren Sie vorübergehend die Gruppenrichtlinieneinstellung " Skriptausführung aktivieren " auf dem Server. Nach Abschluss der Agent-Installation kann die Gruppenrichtlinieneinstellung erneut aktiviert werden.

Fehler bei der Agent-Installation auf dem Active Directory-Domänencontroller

Im Agent-Installationsprotokoll wird der folgende Fehler protokolliert:

CAQuietExec64:  Error 0x80070001: Command line returned an error.
CAQuietExec64:  Error 0x80070001: CAQuietExec64 Failed
CustomAction InstallHFSRequiredWindowsFeatures returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)
Action ended 8:51:12: InstallExecute. Return value 3.
MSI (s) (EC:B4) [08:51:12:439]: Note: 1: 2265 2:  3: -2147287035

Dieses Problem tritt auf, wenn Sie versuchen, den Synchronisierungs-Agent auf einem Active Directory-Domänencontroller zu installieren, auf dem sich der BESITZER der PDC-Rolle auf einer Windows Server 2008 R2 oder einer früheren Betriebssystemversion befindet.

Um dieses Problem zu beheben, übertragen Sie die PDC-Rolle auf einen anderen Domänencontroller unter Windows Server 2012 R2 oder höher und installieren dann den Synchronisierungsdienst.

Beim Zugriff auf ein Volume unter Windows Server 2012 R2 tritt ein Fehler auf: Der Parameter ist falsch.

Nachdem Sie einen Serverendpunkt unter Windows Server 2012 R2 erstellt haben, tritt beim Zugriff auf das Volume der folgende Fehler auf:

Auf „Laufwerkbuchstabe:\“ kann nicht zugegriffen werden.
„Der Parameter ist falsch.“

Um dieses Problem zu beheben, installieren Sie KB2919355 , und starten Sie den Server neu. Wenn dieses Update nicht installiert werden kann, da ein späteres Update bereits installiert ist, wechseln Sie zu Windows Update, installieren Sie die neuesten Updates für Windows Server 2012 R2, und starten Sie den Server neu.

Agent-Installation über die Azure Arc-Erweiterung

Informationen zum Installieren des Azure File Sync Agent für Windows finden Sie unter Installieren und Verwalten der Erweiterung des Azure File Sync-Agents auf Azure Arc-fähigen Windows-Servern.

Problembehandlung bei Installationsfehlern

  1. Navigieren Sie im Azure-Portal zu Ihrem Arc Server .
  2. Wechseln Sie im Server zum Bereich "Erweiterungen".
  3. Suchen Sie AzureFileSyncAgentExtension und wählen Sie 'Details anzeigen' unter der Spalte 'Status' aus.
  4. Überprüfen Sie das Feld "Fehlermeldung" auf detaillierte Informationen zur Ursache des Erweiterungsbereitstellungsfehlers.

Von Bedeutung

Die fehlgeschlagene Erweiterung muss deinstalliert und anschließend erneut installiert werden, nachdem die erforderlichen Korrekturschritte ausgeführt wurden. Speichern Sie Fehlermeldungsdetails zur Problembehandlung oder zum Kontaktieren des Azure File Sync-Supports, da die Deinstallation der fehlgeschlagenen Erweiterung diese Details löscht.

Fehlercodeverweis und -behebung

Fehlermeldung Fehlercode Korrekturschritte
Der Azure File Sync-Agent kann nicht installiert werden, da .NET Framework 4.7.2 oder höher erforderlich ist. Installieren Sie das neueste .NET Framework, und versuchen Sie es erneut. 206 Installieren Sie .NET Framework 4.7.2 oder höher, und starten Sie den Computer neu.
Der Azure File Sync-Agent ist bereits installiert. Es ist also keine weitere Aktion erforderlich. 0 Keine Aktion erforderlich. Die Erweiterung ist installiert, aber es wird keine Anpassung angewendet.
Der Azure File Sync-Agent wird nur für RTM-Versionen (Release to Manufacturing) von unterstützten Betriebssystemen unterstützt. 51 Der Azure File Sync-Agent und die Erweiterung werden nur in RTM-Versionen von Windows Server 2016, 2019, 2022 und 2025 unterstützt.
Fehler bei Proxyeinstellungen. UseCustomProxy ist aktiviert, aber ProxyAddress fehlt oder ist ungültig. ProxyAddress muss ohne Port angegeben werden, und die Länge muss kleiner als 255 Zeichen sein. 201 Stellen Sie sicher, dass ProxyAddress angegeben ist und die maximale Länge von 255 Zeichen nicht überschreitet.
Fehler bei Proxyeinstellungen. UseCustomProxy ist aktiviert, aber ProxyPort fehlt oder ist ungültig. Proxyport muss eine Zahl zwischen 1 und 65535 sein. 202 Geben Sie einen gültigen ProxyPort (numerischen Wert zwischen 1 und 65535) an, wenn UseCustomProxy aktiviert ist.
Fehler bei Proxyeinstellungen. ProxyAuthRequired ist aktiviert, aber ProxyUsername fehlt oder ist ungültig. ProxyUsername Die Länge muss zwischen 3 und 255 Zeichen betragen. 203 Stellen Sie sicher, dass ProxyUsername angegeben ist und seine Länge zwischen 3 und 255 Zeichen liegt.
Fehler bei Proxyeinstellungen. ProxyAuthRequired ist aktiviert, aber ProxyPassword fehlt oder leer. 204 Geben Sie ein nicht leeres ProxyPassword an, wenn ProxyAuthRequired aktiviert ist.
Ein Systemneustart steht aufgrund von Umbenennungsvorgängen der Speichersynchronisierungsdatei aus. Starten Sie den Server neu, bevor Sie den Azure File Sync-Agent installieren. 83 Es ist ein Neustart erforderlich. Starten Sie den Server neu, bevor Sie den Agent erneut installieren.
Die Dateisignatur ist ungültig. Fehler bei der Signaturüberprüfung für die heruntergeladene MSI-Datei. 86 Die Installationsdatei ist möglicherweise beschädigt oder manipuliert. Laden Sie die MSI-Datei erneut aus einer vertrauenswürdigen Quelle herunter.
Fehler bei der Überprüfung der Zertifikatkette. 86 Stellen Sie sicher, dass die erforderlichen Stammzertifikate installiert sind. Lesen Sie die Voraussetzungen für die Offlineinstallation von AKS Edge Essentials.

Stellen Sie bei Verwendung eines Proxys sicher, dass die folgenden Domänen umgangen werden:
login.microsoftonline.com, management.azure.com, go.microsoft.com, download.microsoft.com, download.windowsupdate.com, crl.microsoft.com, oneocsp.microsoft.com, , ocsp.msocsp.com. www.microsoft.com

Starten Sie den Computer neu, um alle Updates anzuwenden.
Fehler beim Herunterladen oder Konfigurieren des Azure File Sync-Agents. Details: Fehler beim Konfigurieren der Einstellungen für automatische Updates: Das Agentinstallationsverzeichnis wurde in der Registrierung nicht gefunden. Bitte überprüfen Sie die Installation. 214 Öffnen Sie eine PowerShell-Sitzung mit erhöhten Rechten, und überprüfen Sie, ob .NET 4.7.2 oder höher installiert ist:
$releaseKey = (Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" -ErrorAction SilentlyContinue).Release

Ist $releaseKey der Wert kleiner als 461808, ist .NET 4.7.2 nicht installiert. Laden Sie in diesem Fall .NET Framework 4.7.2 oder höher von der offiziellen .NET-Downloadwebsite herunter, und installieren Sie sie.

Serverregistrierung

Problembehandlung bei Serverregistrierungsfehlern

Wenn die Serverregistrierung fehlschlägt, öffnen Sie die Datei AfsSrvRegistration*.log unter %LocalAppData%\Temp , und suchen Sie nach "ErrorMessage", um die Fehlerdetails abzurufen.

Wenn Sie die Ursache basierend auf der Fehlermeldung nicht identifizieren können, verwenden Sie das Debug-StorageSyncServer Cmdlet, um zu diagnostizieren, ob die Serverregistrierung aufgrund eines Netzwerkproblems oder eines Serverzertifikats fehlschlägt.

Führen Sie für eine Diagnose auf dem Server die folgenden PowerShell-Befehle aus:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -Diagnose

Führen Sie die folgenden PowerShell-Befehle aus, um die Netzwerkkonnektivität auf dem Server zu testen:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -TestNetworkConnectivity

Fehler bei der Serverregistrierung mithilfe des Register-AzStorageSyncServer Cmdlets: Katastrophaler Fehler (0x8000FFFF)

Eine Serverregistrierung mit dem Register-AzStorageSyncServer Cmdlet schlägt mit dem folgenden Fehler fehl:

Katastrophaler Fehler (0x8000FFFF (E_UNEXPECTED)) "Für diese Ressource wurde keine vom System zugewiesene verwaltete Identität gefunden"

Dieses Problem tritt auf, wenn der Azure Files Sync-Agent von Version 17.x auf 18.x aktualisiert wird und der ServerType Registrierungswert auf einen unerwarteten Wert festgelegt ist.

Um dieses Problem zu beheben, löschen Sie den ServerType Registrierungswert, indem Sie die folgenden Befehle an einer Eingabeaufforderung mit erhöhten Rechten ausführen:

reg delete HKLM\SOFTWARE\Microsoft\Azure\StorageSync /v ServerType /f  
net stop filesyncsvc  
net start filesyncsvc

Nachdem der ServerType Registrierungswert gelöscht wurde, wiederholen Sie die Serverregistrierung.

Die Serverregistrierung listet nicht alle Azure-Abonnements auf

Beim Registrieren eines Servers mit ServerRegistration.exefehlen Abonnements, wenn Sie die Dropdownliste "Azure-Abonnement " auswählen.

Dieses Problem tritt auf, weil ServerRegistration.exe nur Abonnements aus den ersten fünf Microsoft Entra-Mandanten abruft.

Um den Mandantengrenzwert für die Serverregistrierung auf dem Server zu erhöhen, erstellen Sie einen DWORD-Wert, der mit ServerRegistrationTenantLimit einem Wert größer als 5 aufgerufen wirdHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync.

Sie können dieses Problem auch umgehen, indem Sie den Server mit den folgenden PowerShell-Befehlen registrieren:

Connect-AzAccount -Subscription "<guid>" -Tenant "<guid>"
Register-AzStorageSyncServer -ResourceGroupName "<your-resource-group-name>" -StorageSyncServiceName "<your-storage-sync-service-name>"

Die Serverregistrierung listet nicht alle Ressourcengruppen auf.

Beim Registrieren eines Servers mit ServerRegistration.exefehlen einige Ressourcengruppen, wenn Sie die Dropdownliste "Ressourcengruppe " auswählen.

Dieses Problem tritt aufgrund eines bekannten Problems auf, das in Dateisynchronisierung Agent v19.1 behoben wurde. Um dieses Problem zu beheben, installieren Sie die neueste Version des Agents.

Die Serverregistrierung zeigt die Meldung "System.Net.Http, Version=4.2.0.0, Culture=neutral, PublicKeyToken=..." an.

Dieser Fehler tritt auf, wenn auf dem Server die erforderliche .NET Framework-Version fehlt. Für die Serverregistrierung von Azure File Sync ist .NET Framework 4.7.2 oder eine höhere Version erforderlich, damit sie ordnungsgemäß funktionieren.

Gehen Sie folgendermaßen vor, um das Problem zu beheben:

  1. Laden Sie .NET Framework 4.7.2 oder eine höhere Version herunter, und installieren Sie sie.
  2. Starten Sie den Server nach der Installation neu.
  3. Wiederholen Sie die Serverregistrierung mithilfe der Serverregistrierungs-UI oder PowerShell.

Fehler bei der Serverregistrierung: Der Vorgang hat einen ungültigen Statuscode "Nicht autorisiert" zurückgegeben.

Während der Serverregistrierung tritt möglicherweise der folgende Fehler auf:

Der Vorgang hat einen ungültigen Statuscode "Nicht autorisiert" zurückgegeben.

Dieses Problem tritt aufgrund eines Fehlers im Azure File Sync v20-Agent auf. Um dieses Problem zu umgehen, registrieren Sie den Server manuell, indem Sie die folgenden PowerShell-Befehle ausführen:

Connect-AzAccount -Subscription "<your-subscription-guid>" -Tenant "<your-tenant-guid>"
Register-AzStorageSyncServer -ResourceGroupName "<your-resource-group-name>" -StorageSyncServiceName "<your-storage-sync-service-name>"

Notiz

Ersetzen Sie die Platzhalterwerte durch Ihre Abonnement-ID, Die Mandanten-ID, den Namen der Ressourcengruppe und den Namen des Speichersynchronisierungsdiensts.

Überprüfen Sie nach Abschluss der manuellen Registrierung, ob der Server unter registrierten Servern im Azure-Portal angezeigt wird.

Die Serverregistrierung zeigt die folgende Meldung an: "Dieser Server ist bereits registriert"

Screenshot des Dialogfelds

Diese Meldung mit Fehlercode 0x80C80064 wird angezeigt, wenn der Server zuvor bei einem Speichersynchronisierungsdienst registriert wurde. Um die Registrierung des Servers vom aktuellen Speichersynchronisierungsdienst aufzuheben und sich dann bei einem neuen Speichersynchronisierungsdienst zu registrieren, führen Sie die Schritte unter "Aufheben der Registrierung eines Servers mit Azure File Sync" aus.

Wenn der Server nicht unter registrierten Servern im Speichersynchronisierungsdienst aufgeführt ist, führen Sie auf dem Server, auf dem Sie die Registrierung aufheben möchten, die folgenden PowerShell-Befehle aus:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Reset-StorageSyncServer

Notiz

Wenn der Server Teil eines Clusters ist, wird mit dem Parameter Reset-StorageSyncServer-CleanClusterRegistration die Deregistrierung aller Server im Cluster durchgeführt.

Wenn ich einen Server registriere, sehe ich zahlreiche Antworten wie "Website ist nicht vertrauenswürdig". Warum?

Dieses Problem tritt auf, wenn die Erweiterte Internet Explorer-Sicherheitsrichtlinie während der Serverregistrierung aktiviert ist. Weitere Informationen zum ordnungsgemäßen Deaktivieren der Erweiterten Internetsicherheit des Internet Explorers Policy finden Sie unter Vorbereiten von Windows Server für die Verwendung mit Azure File Sync und Bereitstellen von Azure File Sync.

Der Server ist nicht unter registrierten Servern im Azure-Portal aufgeführt.

Wenn ein Server nicht unter registrierten Servern für einen Speichersynchronisierungsdienst aufgeführt ist:

  1. Melden Sie sich bei dem Server an, den Sie registrieren möchten.
  2. Öffnen Sie den Datei-Explorer, und wechseln Sie dann zum Installationsverzeichnis des Speichersynchronisierungs-Agents (der Standardspeicherort lautet "C:\Programme\Azure\StorageSyncAgent").
  3. Führen Sie ServerRegistration.exe aus und vervollständigen Sie den Assistenten, um den Server für einen Speichersynchronisierungsdienst zu registrieren.

Weitere Informationen

Kontaktieren Sie uns für Hilfe

Wenn Sie Fragen haben, können Sie den Azure-Communitysupport stellen. Sie können auch Produktfeedback an die Azure-Feedbackcommunity übermitteln.

  • Last updated on