Partager via

Résoudre les problèmes liés à l’installation de l’agent Azure File Sync et à l’inscription du serveur

Après avoir déployé le service de synchronisation de stockage, les étapes suivantes du déploiement d’Azure File Sync installent l’agent Azure File Sync et inscrivent Windows Server auprès du service de synchronisation de stockage. Cet article est destiné à vous aider à dépanner et à résoudre les problèmes que vous pouvez rencontrer dans ces étapes.

Installation de l’agent

Comment vérifier si une installation de l’agent Azure File Sync nécessite un redémarrage

L’installation d’un agent Azure File Sync peut nécessiter un redémarrage. Par exemple, l’agent Azure File Sync version 19.1.0.0 nécessite un redémarrage sur les serveurs si la mise à jour à partir d’une version antérieure à la version 18.2.0.0.

Si l’agent est mis à jour à l’aide de la fonctionnalité de mise à niveau automatique, exécutez les commandes PowerShell suivantes pour vérifier si un redémarrage est nécessaire pour terminer la mise à niveau automatique de l’agent :

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

Si la valeur de la RebootNeeded propriété est True, un redémarrage est requis.

La mise à jour de l’agent ne se termine pas

Lors de la mise à niveau de l’agent Azure File Sync, vous pouvez rencontrer l’un des symptômes suivants :

  • AfsUpdater.exe se bloque lors de l'« installation des mises à jour ».
  • L’installation de l’agent se bloque sur « Arrêt de l’agent de surveillance ».

Ce problème se produit si la version de l’agent Azure File Sync actuellement installée est antérieure à la version v16.2 et que le processus deLogman.exe ne parvient pas à s’arrêter.

Pour résoudre ce problème, procédez comme suit :

  1. Ouvrez le Gestionnaire des tâches.
  2. Cliquez avec le bouton droit sur le processus LogMan et sélectionnez Terminer la tâche. Répétez cette étape jusqu’à ce que tous les processus LogMan soient arrêtés et que la mise à jour de l’agent se termine correctement.

Résoudre les problèmes d’installation de l’agent

Si l’installation de l’agent Azure File Sync échoue, recherchez le fichier journal d’installation situé dans le répertoire d’installation de l’agent. Si l’agent Azure File Sync est installé sur le volume C : , le fichier journal d’installation se trouve sous C :\Program Files\Azure\StorageSyncAgent\InstallerLog.

Remarque

Si l’agent Azure File Sync est installé à partir de la ligne de commande et que le /l\*v commutateur est utilisé, le fichier journal se trouve dans le chemin d’accès où l’installation de l’agent a été exécutée.

Le nom du fichier journal pour les installations de l’agent à l’aide du package MSI est AfsAgentInstall. Le nom du fichier journal pour les installations de l’agent à l’aide du package MSP (package de mise à jour) est AfsUpdater.

Une fois que vous avez localisé le fichier journal d’installation de l’agent, ouvrez le fichier et recherchez le code d’échec à la fin du journal. Si vous recherchez « code d’erreur 1603 » ou « bac à sable », vous devriez être en mesure de localiser le code d’erreur.

Voici un extrait de code d’une installation de l’agent qui a échoué :

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

Pour cet exemple, l’installation de l’agent a échoué avec le code d’erreur -2147287035 (ERROR_ACCESS_DENIED).

L’installation de l’agent échoue avec l'erreur ERROR_NO_SYSTEM_RESOURCES et le code d’erreur 0x800705AA

L’installation de l’agent a échoué en raison de ressources système insuffisantes. Pour résoudre ce problème, libérez de la mémoire sur le serveur et réessayez l’installation.

Échec de l’installation de l’agent en raison de l'erreur suivante : l’Assistant d'installation de l’agent de synchronisation de stockage s’est terminé prématurément en raison d’une erreur

Dans le journal d’installation de l’agent, l’erreur suivante est consignée :

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

Ce problème se produit si la stratégie d’exécution PowerShell est configurée à l’aide de la stratégie de groupe et que le paramètre de stratégie est « Autoriser uniquement les scripts signés ». Tous les scripts inclus avec l’agent Azure File Sync sont signés. L’installation de l’agent Azure File Sync échoue, car le programme d’installation exécute le script avec le paramètre de stratégie Contourner l’exécution.

Pour résoudre ce problème, désactivez temporairement le paramètre de stratégie Activer l’exécution de script sur le serveur. Une fois l’installation de l’agent terminée, vous pouvez réactiver le paramètre de stratégie de groupe.

L’installation de l’agent échoue sur le contrôleur de domaine Active Directory

Dans le journal d’installation de l’agent, l’erreur suivante est consignée :

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

Ce problème se produit si vous essayez d’installer l’agent de synchronisation sur un contrôleur de domaine Active Directory où le propriétaire du rôle PDC se trouve sur une version de système d’exploitation Windows Server 2008 R2 ou antérieure.

Pour résoudre cela, transférez le rôle de contrôleur de domaine principal à un autre contrôleur de domaine avec Windows Server 2012 R2 ou une version plus récente, puis synchronisez.

L’accès à un volume sur Windows Server 2012 R2 échoue avec une erreur : le paramètre est incorrect

Après la création d’un point de terminaison de serveur sur Windows Server 2012 R2, l’erreur suivante se produit lors de l’accès au volume :

lettre de lecteur :\ n’est pas accessible.
Le paramètre est incorrect.

Pour résoudre ce problème, installez KB2919355 et redémarrez le serveur. Si cette mise à jour ne peut pas être installée, car une mise à jour ultérieure est déjà installée, accédez à Windows Update, installez les dernières mises à jour pour Windows Server 2012 R2 et redémarrez le serveur.

Enregistrement du serveur

Résoudre les échecs d’enregistrement du serveur

Si l’inscription du serveur échoue, ouvrez le fichier AfsSrvRegistration*.log situé sous %LocalAppData%\Temp et recherchez « ErrorMessage » pour obtenir les détails de l’erreur.

Si vous ne pouvez pas identifier la cause en fonction du message d’erreur, utilisez l’applet Debug-StorageSyncServer de commande pour diagnostiquer si l’inscription du serveur échoue en raison d’un problème réseau ou d’un certificat de serveur.

Pour exécuter les diagnostics sur le serveur, exécutez les commandes PowerShell suivantes :

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

Pour tester la connectivité réseau sur le serveur, exécutez les commandes PowerShell suivantes :

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

L’inscription du serveur à l’aide de l’applet Register-AzStorageSyncServer de commande échoue avec l’erreur : Échec catastrophique (0x8000FFFF)

Une inscription de serveur à l’aide de l’applet Register-AzStorageSyncServer de commande échoue avec l’erreur suivante :

Échec catastrophique (0x8000FFFF (E_UNEXPECTED)) « Aucune identité managée affectée par le système n’a été trouvée pour cette ressource »

Ce problème se produit lorsque l’agent Azure Files Sync est mis à niveau de la version 17.x vers la version 18.x et que la valeur du ServerType Registre est définie sur une valeur inattendue.

Pour résoudre ce problème, supprimez la valeur de ServerType Registre en exécutant les commandes suivantes à partir d’une invite de commandes avec élévation de privilèges :

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

Une fois la valeur de ServerType Registre supprimée, réessayez l’inscription du serveur.

L’inscription du serveur ne répertorie pas tous les abonnements Azure

Lors de l’inscription d’un serveur à l’aide de ServerRegistration.exe, les abonnements sont manquants lorsque vous sélectionnez la liste déroulante Abonnement Azure .

Ce problème se produit car ServerRegistration.exe récupère uniquement les abonnements des cinq premiers locataires Microsoft Entra.

Pour augmenter la limite du locataire d’inscription du serveur sur le serveur, créez une valeur DWORD appelée ServerRegistrationTenantLimit sous HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync avec une valeur supérieure à 5.

Vous pouvez également contourner ce problème en utilisant les commandes PowerShell suivantes pour inscrire le serveur :

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

L’inscription du serveur ne répertorie pas tous les groupes de ressources

Lors de l’inscription d’un serveur à l’aide de ServerRegistration.exe, certains groupes de ressources sont manquants lorsque vous sélectionnez la liste déroulante Groupe de ressources.

Ce problème se produit en raison d’un problème connu qui a été résolu dans File Sync Agent v19.1. Pour résoudre ce problème, installez la dernière version de l’agent.

L’inscription du serveur affiche le message : « System.Net.Http, Version=4.2.0.0, Culture=neutral, PublicKeyToken=... »

Cette erreur se produit lorsque le serveur ne dispose pas de la version requise du .NET Framework. L’inscription du serveur d’Azure File Sync nécessite .NET Framework 4.7.2 ou une version ultérieure pour fonctionner correctement.

Pour résoudre ce problème, procédez comme suit :

  1. Téléchargez et installez .NET Framework 4.7.2 ou une version ultérieure.
  2. Redémarrez le serveur après l’installation.
  3. Réessayez l’inscription du serveur à l’aide de l’interface utilisateur d’inscription du serveur ou de PowerShell.

Échec de l’inscription du serveur avec erreur : l’opération a retourné un code d’état non valide « Non autorisé »

Pendant l’inscription du serveur, vous pouvez rencontrer l’erreur suivante :

L’opération a retourné un code d’état non valide « Non autorisé »

Ce problème se produit en raison d’un bogue dans l’agent Azure File Sync v20. Pour contourner ce problème, inscrivez manuellement le serveur en exécutant les commandes PowerShell suivantes :

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

Remarque

Remplacez les valeurs de l'espace réservé avec votre ID d'abonnement, votre ID de locataire, le nom du groupe de ressources et le nom du service de synchronisation de stockage.

Une fois l’inscription manuelle terminée, vérifiez que le serveur apparaît sous Serveurs inscrits dans le portail Azure.

L’inscription du serveur affiche le message suivant : « Ce serveur est déjà inscrit »

Capture d’écran montrant la boîte de dialogue Inscription du serveur avec le message d’erreur « Le serveur est déjà inscrit ».

Ce message avec le code d’erreur 0x80C80064 s’affiche si le serveur a été précédemment inscrit auprès d’un service de synchronisation de stockage. Pour annuler l’inscription du serveur à partir du service de synchronisation de stockage actuel, puis s’inscrire auprès d’un nouveau service de synchronisation de stockage, effectuez les étapes décrites dans Annuler l’inscription d’un serveur auprès d’Azure File Sync.

Si le serveur n’est pas répertorié sous Serveurs inscrits dans le service de synchronisation de stockage, sur le serveur que vous souhaitez désinscrire, exécutez les commandes PowerShell suivantes :

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

Remarque

Si le serveur fait partie d’un cluster, le Reset-StorageSyncServer-CleanClusterRegistration paramètre annule l’inscription de tous les serveurs du cluster.

Lorsque j’inscrit un serveur, je vois de nombreuses réponses « site web non approuvés ». Pourquoi?

Ce problème se produit lorsque la stratégie de sécurité Internet Explorer améliorée est activée lors de l’inscription du serveur. Pour plus d’informations sur la désactivation correcte de la stratégie de sécurité d’Internet Explorer améliorée , consultez Préparer Windows Server à utiliser avec Azure File Sync et Comment déployer Azure File Sync.

Le serveur n’est pas répertorié sous les serveurs inscrits dans le portail Azure

Si un serveur n’est pas répertorié sous Serveurs inscrits pour un service de synchronisation de stockage :

  1. Connectez-vous au serveur que vous souhaitez inscrire.
  2. Ouvrez l’Explorateur de fichiers, puis accédez au répertoire d’installation de l’Agent de synchronisation de stockage (l’emplacement par défaut est C :\Program Files\Azure\StorageSyncAgent).
  3. Exécutez ServerRegistration.exe, puis terminez l’assistant pour inscrire le serveur auprès d’un service de synchronisation du stockage.

Voir aussi

Contactez-nous pour obtenir de l’aide

Si vous avez des questions ou avez besoin d’aide, créez une demande de support ou demandez le support de la communauté Azure. Vous pouvez également envoyer des commentaires sur le produit à la communauté de commentaires Azure.