排查Azure 文件同步问题

  • 项目

可以使用Azure 文件同步将组织的文件共享集中到Azure 文件存储中，同时保持本地文件服务器的灵活性、性能和兼容性。 本文旨在帮助排查和解决Azure 文件同步部署时可能遇到的问题。 我们还介绍了如果需要对问题进行更深入的调查，如何从系统收集重要日志。

常见故障排除文档

根据遇到的问题，查看相应的故障排除文档：

问题 故障排除文档
代理安装或服务器注册问题 排查Azure 文件同步代理安装和服务器注册问题
云终结点或服务器终结点创建问题，或已注册的服务器脱机 排查Azure 文件同步同步组管理问题
服务器终结点出现错误状态，或文件无法同步 排查Azure 文件同步同步运行状况和错误
文件无法分层或召回 排查Azure 文件同步云分层问题

如果不确定从何处开始，请参阅 常规故障排除第一步。

常规故障排除的第一步

如果遇到Azure 文件同步问题，请首先完成以下步骤：

  1. 使用服务器上的Azure 门户或事件日志检查是否有任何错误。 有关如何使用Azure 门户或事件日志查看Azure 文件同步环境的运行状况的信息，请参阅监视Azure 文件同步。
  2. 验证Azure 文件同步服务是否在服务器上运行：
    • 打开服务 MMC 管理单元并验证存储同步代理服务 (FileSyncSvc) 是否正在运行。
  3. 验证Azure 文件同步筛选器驱动程序 (StorageSync.sys 和 StorageSyncGuard.sys) 是否在服务器上运行：
    • 在提升的命令提示符下，运行 fltmc。 验证 是否列出了StorageSync.sys 和 StorageSyncGuard.sys 文件系统筛选器驱动程序。
  4. 使用服务器上的 Debug-StorageSyncServer cmdlet 检查常见问题。

Debug-StorageSyncServer cmdlet

cmdlet Debug-StorageSyncServer 将诊断Azure 文件同步服务器上的常见问题，例如证书配置错误和服务器时间不正确。 我们还通过将一些现有脚本和 cmdlet (AFSDiag.ps1、 FileSyncErrorsReport.ps1和 Test-StorageSyncNetworkConnectivity) 的功能合并到 cmdlet 中来Debug-StorageSyncServer简化Azure 文件同步故障排除。

若要在服务器上运行诊断，请运行以下 PowerShell 命令：

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

若要测试服务器上的网络连接，请运行以下 PowerShell 命令：

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

若要识别服务器上无法同步的文件，请运行以下 PowerShell 命令：

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

若要收集服务器上的日志和跟踪，请运行以下 PowerShell 命令：

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

如何在 Azure 文件同步 服务器上收集日志和跟踪

如果在按照故障排除文档中的步骤操作后问题未得到解决，请运行 AFSDiag 工具，并将其 .zip 文件输出发送给分配给案例的支持工程师，以便进一步诊断。

若要运行 AFSDiag，请执行以下步骤：

  1. 打开提升的 PowerShell 窗口，然后在每个命令) 后 (按 Enter 运行以下命令：

    注意

    AFSDiag 将在收集日志之前创建输出目录和其中一个临时文件夹，并在执行后删除临时文件夹。 指定不包含数据的输出位置。

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

  2. 重现问题。 完成后，输入 D。

  3. 包含日志和跟踪文件的 .zip 文件将保存到指定的输出目录。

另请参阅

联系我们寻求帮助

如果你有任何疑问或需要帮助，请创建支持请求或联系 Azure 社区支持。 还可以向 Azure 反馈社区提交产品反馈。