Freigeben über

Problembehandlung bei Agent-Installation und Serverregistrierung

  • Artikel

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 enthält Informationen zur Behebung von Fehlern und Lösung von Problemen, die möglicherweise bei diesen Schritten auftreten.

Installation des Agenten

So überprüfen Sie, ob eine Azure-Dateisynchronisierung Agent-Installation 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.

Agentupdate nicht abgeschlossen

Beim Upgrade des Azure-Dateisynchronisierung Agents können Sie eines der folgenden Symptome feststellen:

  • 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-Dateisynchronisierung 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.

Beheben von Fehlern bei der Agent-Installation

Wenn die Azure-Dateisynchronisierung Agent-Installation fehlschlägt, suchen Sie die Installationsprotokolldatei, die sich im Agent-Installationsverzeichnis befindet. Wenn der Azure-Dateisynchronisierung-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 Agent-Installation mit dem Fehlercode „-2147287035 (ERROR_ACCESS_DENIED)“ fehlgeschlagen.

Fehler bei der Agent-Installation: Setup-Assistent für Speichersynchronisierungs-Agent 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 Richtlinie PowerShell-Ausführung mithilfe einer Gruppenrichtlinie konfiguriert ist und die Richtlinieneinstellung "Nur signierte Skripts zulassen" lautet. Alle im Azure File Sync-Agent enthaltenen Skripte 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.

Deaktivieren Sie zum Beheben dieses Problems vorübergehend die Gruppenrichtlinieneinstellung Skriptausführung aktivieren auf dem Server. Nach Abschluss der Agent-Installation kann die Gruppenrichtlinieneinstellung erneut aktiviert werden.

Bei der Agent-Installation tritt ein Fehler auf dem Active Directory-Domänencontroller auf.

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.“

Installieren Sie zum Beheben des Fehlers 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.

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.

Bei der Serverregistrierung werden nicht alle Azure-Abonnements aufgelistet.

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

Dieses Problem tritt auf, da 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 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync einem Wert größer als 5 aufgerufen wirdServerRegistrationTenantLimit.

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 zeigt die folgende Meldung an: „Dieser Server ist bereits registriert.“

Screenshot des Dialogfelds

Diese Meldung wird angezeigt, wenn der Server zuvor bei einem Speichersynchronisierungsdienst registriert wurde. Wenn Sie die Registrierung des Servers beim aktuellen Speichersynchronisierungsdienst aufheben und ihn bei einem neuen Speichersynchronisierungsdienst registrieren möchten, führen Sie die unter Aufheben der Registrierung eines Servers bei der Azure-Dateisynchronisierung beschriebenen Schritte 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, verwenden Sie den Reset-StorageSyncServer -CleanClusterRegistration Parameter, um den Server aus dem Azure-Dateisynchronisierung Clusterregistrierungsdetail zu entfernen.

Beim Registrieren eines Servers erhalte ich zahlreiche Antworten, dass eine Website nicht vertrauenswürdig sei. Warum?

Dieses Problem tritt auf, wenn die Richtlinie Erhöhte Internet Explorer-Sicherheit bei der Serverregistrierung aktiviert war. Weitere Informationen zum ordnungsgemäßen Deaktivieren der Richtlinie Erhöhte Internet Explorer-Sicherheit finden Sie unter Vorbereiten von Windows Server für die Verwendung mit der Azure-Dateisynchronisierung und Bereitstellen der Azure-Dateisynchronisierung (Vorschau).

Der Server ist im Azure-Portal nicht unter „Registrierte Server“ 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 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 schließen Sie den Assistenten ab, um den Server bei einem Speichersynchronisierungsdienst zu registrieren.

Weitere Informationen

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.