Felsöka installation och serverregistrering av Azure File Sync-agenten

När du har distribuerat Tjänsten för synkronisering av lagring installeras Azure File Sync-agenten och Windows Server registreras med Tjänsten för synkronisering av lagring. Den här artikeln hjälper dig att felsöka och lösa problem som kan uppstå under de här stegen.

Agentinstallation

Så här kontrollerar du om en Azure File Sync-agentinstallation kräver en omstart

Installationen av en Azure File Sync-agent kan behöva startas om för att slutföras. Azure File Sync-agenten version 19.1.0.0 kräver till exempel en omstart på servrar om den uppdateras från en tidigare version än 18.2.0.0.

Om agenten uppdateras med funktionen för automatisk uppgradering kör du följande PowerShell-kommandon för att kontrollera om en omstart krävs för att slutföra agentens automatiska uppgradering:

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

Om värdet för egenskapen RebootNeeded är Truekrävs en omstart.

Agentuppdateringen slutförs inte

När du uppgraderar Azure File Sync-agenten kan det uppstå något av följande symptom:

• AfsUpdater.exe låser sig vid "installera uppdateringar".
• Agentinstallationen låser sig vid "Stoppa övervakningsagenten".

Det här problemet uppstår om den för närvarande installerade Azure File Sync-agentversionen är tidigare än v16.2 och Logman.exe processen inte kan stängas av.

Åtgärda problemet genom att följa dessa steg:

1. Öppna Aktivitetshanteraren.
2. Högerklicka på LogMan-processen och välj Avsluta uppgift. Upprepa det här steget tills alla LogMan-processer har stoppats och agentuppdateringen har slutförts.

Felsöka agentinstallationsfel

Om installationen av Azure File Sync-agenten misslyckas letar du upp installationsloggfilen som finns i agentinstallationskatalogen. Om Azure File Sync-agenten är installerad på C: -volymen finns installationsloggfilen under C:\Program Files\Azure\StorageSyncAgent\InstallerLog.

Loggfilens namn för agentinstallationer som använder MSI-paketet är AfsAgentInstall. Loggfilens namn för agentinstallationer med msp-paketet (uppdateringspaketet) är AfsUpdater.

När du har hittat agentinstallationens loggfil öppnar du filen och söker efter felkoden i slutet av loggen. Om du söker efter "felkod 1603" eller "sandbox-miljö" bör du kunna hitta felkoden.

Här är ett kodfragment från en agentinstallation som misslyckades:

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

I det här exemplet misslyckades agentinstallationen med felkoden -2147287035 (ERROR_ACCESS_DENIED).

Agentinstallationen misslyckas med fel ERROR_NO_SYSTEM_RESOURCES och felkod 0x800705AA

Agentinstallationen misslyckades på grund av otillräckliga systemresurser. Lös problemet genom att frigöra minne på servern och försöka installera igen.

Agentinstallationen misslyckas med fel: Installationsguiden för lagringssynkroniseringsagenten avslutades i förtid på grund av ett fel

I agentinstallationsloggen loggas följande fel:

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 

Det här problemet uppstår om PowerShell-körningsprincipen har konfigurerats med en grupprincip och principinställningen är "Tillåt endast signerade skript". Alla skript som ingår i Azure File Sync-agenten är signerade. Installationen av Azure File Sync-agenten misslyckas eftersom installationsprogrammet utför skriptkörningen med hjälp av principinställningen Kringgå körning.

Lös problemet genom att tillfälligt inaktivera grupprincipinställningen Aktivera skriptkörning på servern. När agentinstallationen är klar kan grupprincipinställningen återaktiveras.

Agenten kan inte installeras på en Active Directory-domänkontrollant

I agentinstallationsloggen loggas följande fel:

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

Det här problemet uppstår om du försöker installera synkroniseringsagenten på en Active Directory-domänkontrollant där PDC-rollägaren finns på en Windows Server 2008 R2 eller tidigare operativsystemversion.

Lös problemet genom att överföra PDC-rollen till en annan domänkontrollant som kör Windows Server 2012 R2 eller senare och installera sedan synkroniseringen.

Det går inte att komma åt en volym på Windows Server 2012 R2 med fel: Parametern är felaktig

När du har skapat en serverslutpunkt på Windows Server 2012 R2 uppstår följande fel vid åtkomst till volymen:

enhetsbeteckning:\ är inte tillgänglig.
Parametern är felaktig.

Lös problemet genom att installera KB2919355 och starta om servern. Om den här uppdateringen inte kan installeras eftersom en senare uppdatering redan har installerats går du till Windows Update, installerar de senaste uppdateringarna för Windows Server 2012 R2 och startar om servern.

Agentinstallation via Azure Arc-tillägget

Mer information om hur du installerar Azure File Sync Agent för Windows finns i Installera och hantera Azure File Sync-agenttillägget på Azure Arc-aktiverade Windows-servrar.

Felsöka installationsfel

1. Gå till Arc Server i Azure-portalen.
2. Gå till bladet Tillägg för servern.
3. Leta upp AzureFileSyncAgentExtension och välj Visa information under kolumnen Status .
4. I fältet Felmeddelande finns detaljerad information om orsaken till tilläggets distributionsfel.

Felkodsreferens och reparation

Serverregistrering

Felsöka fel vid serverregistrering

Om serverregistreringen misslyckas öppnar du filen AfsSrvRegistration*.log under %LocalAppData%\Temp och söker efter "ErrorMessage" för att hämta felinformationen.

Om du inte kan identifiera orsaken baserat på felmeddelandet använder du cmdleten Debug-StorageSyncServer för att diagnostisera om serverregistreringen misslyckas på grund av ett nätverksproblem eller servercertifikat.

Kör följande PowerShell-kommandon för att köra diagnostik på servern:

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

Testa nätverksanslutningen på servern genom att köra följande PowerShell-kommandon:

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

Serverregistreringen med cmdleten Register-AzStorageSyncServer misslyckas med felet: Oåterkalleligt fel (0x8000FFFF)

En serverregistrering med cmdleten Register-AzStorageSyncServer misslyckas med följande fel:

Oåterkalleligt fel (0x8000FFFF (E_UNEXPECTED)) "Ingen systemtilldelad hanterad identitet hittades för den här resursen"

Det här problemet uppstår när Azure Files Sync-agenten uppgraderas från version 17.x till 18.x och ServerType registervärdet anges till ett oväntat värde.

Lös problemet genom att ta bort ServerType registervärdet genom att köra följande kommandon från en upphöjd kommandotolk:

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

ServerType När registervärdet har tagits bort gör du ett nytt försök med serverregistreringen.

Serverregistrering visar inte alla Azure-prenumerationer

När du registrerar en server med ServerRegistration.exe saknas prenumerationer när du väljer listrutan Azure-prenumeration.

Det här problemet beror på att ServerRegistration.exe endast hämtar prenumerationer från de fem första Microsoft Entra-klienterna.

Om du vill öka klientgränsen för serverregistrering på servern skapar du ett DWORD-värde som anropas ServerRegistrationTenantLimit under HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync med ett värde som är större än 5.

Du kan också kringgå problemet genom att använda följande PowerShell-kommandon till att registrera servern:

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

Serverregistrering visar inte alla resursgrupper

När du registrerar en server med ServerRegistration.exe saknas vissa resursgrupper när du väljer listrutan Resursgrupp.

Det här problemet uppstår på grund av ett känt problem som har åtgärdats i File Sync Agent v19.1. Lös problemet genom att installera den senaste versionen av agenten.

Serverregistrering visar meddelandet: "System.Net.Http, Version=4.2.0.0, Culture=neutral, PublicKeyToken=..."

Det här felet uppstår när servern saknar den nödvändiga .NET Framework-versionen. Azure File Syncs serverregistrering kräver .NET Framework 4.7.2 eller en senare version för att fungera korrekt.

Följ dessa anvisningar för att lösa problemet:

1. Ladda ned och installera .NET Framework 4.7.2 eller en senare version.
2. Starta om servern efter installationen.
3. Försök igen med serverregistreringen med hjälp av användargränssnittet för serverregistrering eller PowerShell.

Serverregistreringen misslyckas med fel: åtgärden returnerade en ogiltig statuskod "Obehörig"

Under serverregistreringen kan det uppstå följande fel:

Åtgärden returnerade en ogiltig statuskod "Obehörig"

Det här problemet uppstår på grund av en bugg i Azure File Sync v20-agenten. Du kan undvika det här problemet genom att registrera servern manuellt genom att köra följande PowerShell-kommandon:

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

När du har slutfört den manuella registreringen kontrollerar du att servern visas under Registrerade servrar i Azure-portalen.

Serverregistrering visar följande meddelande: ”Den här servern är redan registrerad”

Det här meddelandet med felkoden 0x80C80064 visas om servern tidigare har registrerats med en tjänst för synkronisering av lagring. Om du vill avregistrera servern från den aktuella tjänsten för synkronisering av lagring och sedan registrera dig med en ny tjänst för synkronisering av lagring slutför du stegen i Avregistrera en server med Azure File Sync.

Om servern inte visas under Registrerade servrar i Tjänsten för synkronisering av lagring kör du följande PowerShell-kommandon på den server som du vill avregistrera:

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

När jag registrerar en server ser jag många svar om att webbplatsen inte är betrodd. Varför?

Det här problemet uppstår när den förbättrade Internet Explorer-säkerhetsprincipen är aktiverad under serverregistreringen. Mer information om hur du inaktiverar säkerhetsprincipen för Utökad Internet Explorer finns i Förbereda Windows Server för användning med Azure File Sync och Så här distribuerar du Azure File Sync.

Servern visas inte under registrerade servrar i Azure-portalen

Om en server inte visas under Registrerade servrar för en synkroniseringstjänst för lagring:

1. Logga in på den server som du vill registrera.
2. Öppna Utforskaren och gå sedan till installationskatalogen för Storage Sync Agent (standardplatsen är C:\Program Files\Azure\StorageSyncAgent).
3. Kör ServerRegistration.exe och slutför guiden för att registrera servern med en synkroniseringstjänst för lagring.

Se även

• Felsöka grupphantering för Azure File Sync-synkronisering
• Felsöka synkroniseringsfel för Azure File Sync
• Felsöka azure file sync-molnnivåindelning
• Övervaka Azure File Sync
• Felsöka Problem med Azure Files

Kontakta oss för att få hjälp

Om du har frågor eller behöver hjälp skapar du en supportförfrågan eller frågar Azure community support. Du kan också skicka produktfeedback till Azure-feedbackcommunityn.