Résoudre les problèmes de Azure File Sync

  • Article

Vous pouvez utiliser Azure File Sync pour centraliser les partages de fichiers de votre organization dans Azure Files, tout en conservant la flexibilité, les performances et la compatibilité d’un serveur de fichiers local. Cet article est conçu pour vous aider à résoudre les problèmes que vous pouvez rencontrer avec votre déploiement Azure File Sync. Nous décrivons également comment collecter des journaux importants à partir du système si une investigation plus approfondie du problème est nécessaire.

Documentation de dépannage courante

En fonction du problème que vous rencontrez, consultez la documentation de résolution des problèmes appropriée :

Problèmes Documentation de résolution des problèmes
Problèmes d’installation de l’agent ou d’inscription de serveur Résoudre les problèmes d’installation et d’inscription de serveur Azure File Sync agent
Problèmes de création de point de terminaison de serveur ou de point de terminaison cloud, ou le serveur inscrit est hors connexion Résoudre les problèmes de gestion des groupes de synchronisation Azure File Sync
Le point de terminaison de serveur présente une erreur status ou la synchronisation des fichiers échoue Résoudre les problèmes d’intégrité et d’erreurs de synchronisation Azure File Sync
Échec de hiérarchisation ou de rappel des fichiers Résoudre les problèmes de hiérarchisation cloud Azure File Sync

Si vous ne savez pas par où commencer, consultez Les premières étapes de résolution des problèmes généraux.

Premières étapes de résolution des problèmes généraux

Si vous rencontrez des problèmes avec Azure File Sync, commencez par effectuer les étapes suivantes :

  1. Recherchez les erreurs à l’aide du Portail Azure ou des journaux des événements sur le serveur. Pour plus d’informations sur la façon d’afficher l’intégrité de votre environnement Azure File Sync à l’aide des journaux d’Portail Azure ou des événements, consultez Surveiller les Azure File Sync.
  2. Vérifiez que le service Azure File Sync est en cours d’exécution sur le serveur :
    • Ouvrez le composant logiciel enfichable MMC Services et vérifiez que le service Agent de synchronisation de stockage (FileSyncSvc) est en cours d’exécution.
  3. Vérifiez que les pilotes de filtre Azure File Sync (StorageSync.sys et StorageSyncGuard.sys) s’exécutent sur le serveur :
    • À une invite de commandes avec élévation de privilèges, exécutez fltmc. Vérifiez que les pilotes de filtre de système de fichiersStorageSync.syset StorageSyncGuard.sys sont répertoriés.
  4. Utilisez l’applet de commande Debug-StorageSyncServer sur le serveur pour case activée des problèmes courants.

applet de commande Debug-StorageSyncServer

L’applet Debug-StorageSyncServer de commande diagnostiquera les problèmes courants sur le serveur Azure File Sync, tels que la configuration incorrecte du certificat et l’heure incorrecte du serveur. Nous avons également simplifié Azure File Sync résolution des problèmes en fusionnant les fonctionnalités de certains scripts et applets de commande existants (AFSDiag.ps1, FileSyncErrorsReport.ps1et Test-StorageSyncNetworkConnectivity) dans l’applet Debug-StorageSyncServer de commande.

Pour exécuter 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

Pour identifier les fichiers qui ne parviennent pas à se synchroniser sur le serveur, exécutez les commandes PowerShell suivantes :

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

Pour collecter les journaux et les traces sur le serveur, exécutez les commandes PowerShell suivantes :

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -AFSDiag -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose

Comment collecter des journaux et des traces sur le serveur Azure File Sync

Si votre problème n’est pas résolu après avoir suivi les étapes décrites dans la documentation de résolution des problèmes, exécutez l’outil AFSDiag et envoyez sa sortie de fichier .zip à l’ingénieur du support technique affecté à votre cas pour un diagnostic plus approfondi.

Pour exécuter AFSDiag, procédez comme suit :

  1. Ouvrez une fenêtre PowerShell avec élévation de privilèges, puis exécutez les commandes suivantes ( appuyez sur Entrée après chaque commande) :

    Remarque

    AFSDiag crée le répertoire de sortie et un dossier temporaire dans celui-ci avant de collecter les journaux et supprime le dossier temporaire après l’exécution. Spécifiez un emplacement de sortie qui ne contient pas de données.

    Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -AFSDiag -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose

  2. Reproduisez le problème. Lorsque vous avez terminé, entrez D.

  3. Un fichier .zip qui contient des journaux et des fichiers de trace est enregistré dans le répertoire de sortie que vous avez spécifié.

Voir aussi

Contactez-nous pour obtenir de l’aide

Pour toute demande ou assistance, créez une demande de support ou posez une question au support de la communauté Azure. Vous pouvez également soumettre des commentaires sur les produits à la communauté de commentaires Azure.