排查Azure 文件同步同步组管理问题

  • 项目

同步组定义一组文件的同步拓扑。 同步组中的终结点彼此保持同步。 同步组必须包含一个表示 Azure 文件共享的云终结点，以及一个或多个服务器终结点（表示已注册服务器上的路径）。 本文旨在帮助排查和解决管理同步组时可能遇到的问题。

云终结点创建错误

云终结点创建失败，出现以下错误：“MgmtInternalError”

如果由于服务器消息块 (SMB) 安全设置，Azure 文件同步服务无法访问存储帐户，则会发生此错误。 若要使Azure 文件同步访问存储帐户，存储帐户上的 SMB 安全设置必须允许 SMB 3.1.1 协议版本、NTLM v2 身份验证和 AES-128-GCM 加密。 若要检查存储帐户上的 SMB 安全设置，请参阅 SMB 安全设置。

云终结点创建失败，出现以下错误：“MgmtForbidden”

如果Azure 文件同步服务无法访问存储帐户，则会发生此错误。

若要解决此问题，请执行以下步骤：

  • 验证是否已在存储帐户上选中“允许受信任的 Microsoft 服务访问此存储帐户”设置。 若要了解详细信息，请参阅 限制对存储帐户公共终结点的访问。
  • 验证存储帐户上的 SMB 安全设置。 若要使Azure 文件同步访问存储帐户，存储帐户上的 SMB 安全设置必须允许 SMB 3.1.1 协议版本、NTLM v2 身份验证和 AES-128-GCM 加密。 若要检查存储帐户上的 SMB 安全设置，请参阅 SMB 安全设置。

云终结点创建失败，出现以下错误：“AuthorizationFailed”

如果用户帐户没有足够的权限创建云终结点，则会发生此错误。

若要创建云终结点，用户帐户必须具有以下 Microsoft 授权权限：

  • 读取：获取角色定义
  • 写入：创建或更新自定义角色定义
  • 读取：获取角色分配
  • 写入：创建角色分配

以下内置角色具有所需的 Microsoft 授权权限：

  • 所有者
  • 用户访问权限管理员

若要确定用户帐户角色是否具有所需的权限，请执行以下操作：

  1. 在Azure 门户，选择“资源组”。
  2. 选择存储帐户所在的资源组，然后选择“ 访问控制 (IAM) ”。
  3. 选择“ 角色分配 ”选项卡。
  4. 选择 “角色 (例如用户帐户的所有者或参与者) 。
  5. 在 “资源提供程序” 列表中，选择“ Microsoft 授权”。
    • 角色分配 应具有 读取 和 写入 权限。
    • 角色定义 应具有 读取 和 写入 权限。

云终结点创建失败，并出现以下错误：“指定的 Azure FileShare 已被其他 CloudEndpoint 使用”

如果 Azure 文件共享已被另一个云终结点使用，则会发生此错误。

如果看到此消息，并且云终结点当前未使用 Azure 文件共享，请完成以下步骤以清除 Azure 文件共享上的Azure 文件同步元数据：

警告

删除云终结点当前正在使用的 Azure 文件共享上的元数据会导致Azure 文件同步操作失败。 如果随后将此文件共享用于其他同步组中的同步，则旧同步组中文件的数据丢失几乎可以确定。

  1. 在Azure 门户，转到 Azure 文件共享。  
  2. 右键单击 Azure 文件共享，然后选择“ 编辑元数据”。
  3. 右键单击“ SyncService”，然后选择“ 删除”。

服务器终结点创建和删除错误

服务器终结点的运行状况状态为“预配已取消”

服务器终结点运行状况状态为“预配已取消”表示服务器终结点创建失败。 若要排查服务器终结点创建失败的原因，请选择“预配已取消”状态以查看错误代码，并在此文档中搜索错误。 了解原因后，请先删除未能创建的服务器终结点，然后再尝试再次创建服务器终结点。 若要删除运行状况为“预配已取消”的服务器终结点，请右键单击服务器终结点并选择“ 删除”。

服务器终结点创建失败，出现以下错误：“MgmtServerJobFailed” (错误代码：-2134375898 或 0x80c80226)

如果服务器终结点路径位于系统卷上并且启用了云分层，则会发生此错误。 系统卷不支持云分层。 若要在系统卷上创建服务器终结点，请在创建服务器终结点时禁用云分层。

服务器终结点创建失败，出现以下错误：“MgmtServerJobFailed” (错误代码： -2147024894 或 0x80070002)

如果指定的服务器终结点路径无效，则会发生此错误。 验证指定的服务器终结点路径是否为本地附加的 NTFS 卷。 请注意，Azure 文件同步不支持映射驱动器作为服务器终结点路径。

服务器终结点创建失败，出现此错误：“MgmtServerJobFailed” (错误代码：-2134375640 或 0x80c80328)

如果指定的服务器终结点路径不是 NTFS 卷，则会发生此错误。 验证指定的服务器终结点路径是否为本地附加的 NTFS 卷。 请注意，Azure 文件同步不支持映射驱动器作为服务器终结点路径。

服务器终结点创建失败，出现以下错误：“MgmtServerJobFailed” (错误代码：-2134347507 或 0x80c8710d)

发生此错误的原因是，Azure 文件同步不支持具有压缩系统卷信息文件夹的卷上的服务器终结点。 若要解决此问题，请解压缩“系统卷信息”文件夹。 如果“系统卷信息”文件夹是卷上唯一压缩的文件夹，请执行以下步骤：

  1. 下载 PsExec 工具。

  2. PsExec.exe -i -s -d cmd从提升的命令提示符运行命令，以启动在系统帐户下运行的命令提示符。

  3. 在系统帐户下运行的命令提示符中，键入以下命令并按 Enter：

    cd /d "drive letter:\System Volume Information"
compact /u /s

服务器终结点创建失败，出现此错误：“MgmtServerJobFailed” (错误代码：-2134376345 或 0x80C80067)

如果达到每个服务器的服务器终结点限制，则会发生此错误。 Azure 文件同步目前支持每个服务器最多 30 个服务器终结点。 有关详细信息，请参阅Azure 文件同步缩放目标。

服务器终结点创建失败，出现以下错误：“MgmtServerJobFailed” (错误代码：-2134376427 或 0x80c80015)

如果另一个服务器终结点已在同步指定的服务器终结点路径，则会发生此错误。 Azure 文件同步不支持多个服务器终结点同步同一目录或卷。

服务器终结点创建失败，出现此错误：“MgmtServerJobFailed” (错误代码： -2160590967 或 0x80c80077)

如果服务器终结点路径包含孤立的分层文件，则会发生此错误。 如果最近删除了服务器终结点，请等待孤立的分层文件清理完成。 启动孤立分层文件清理后，事件 ID 6662 将记录到遥测事件日志中。 一旦孤立的分层文件清理完成，可以使用 路径重新创建服务器终结点，就会记录事件 ID 6661。 如果在分层文件清理完成后服务器终结点创建失败，或者如果由于事件日志滚动更新而无法在遥测事件日志中找到事件 ID 6661，则删除服务器终结点后，通过执行分层文件中所述的步骤删除 孤立的分层文件。

服务器终结点删除失败，出现以下错误：“MgmtServerJobExpired” (错误代码：-2134347757 或 0x80c87013)

如果服务器处于脱机状态或没有网络连接，则会发生此错误。 如果服务器不再可用，请在门户中注销服务器，这将删除服务器终结点。 若要删除服务器终结点，请按照使用Azure 文件同步取消注册服务器中所述的步骤操作。

服务器终结点运行状况

无法打开服务器终结点属性页或更新云分层策略

如果服务器终结点上的管理操作失败，则可能会出现此问题。 如果服务器终结点属性页未在Azure 门户中打开，则从服务器使用 PowerShell 命令更新服务器终结点可能会解决此问题。

# Get the server endpoint id based on the server endpoint DisplayName property
Get-AzStorageSyncServerEndpoint `
    -ResourceGroupName myrgname `
    -StorageSyncServiceName storagesvcname `
    -SyncGroupName mysyncgroup | `
Tee-Object -Variable serverEndpoint

# Update the free space percent policy for the server endpoint
Set-AzStorageSyncServerEndpoint `
    -InputObject $serverEndpoint
    -CloudTiering `
    -VolumeFreeSpacePercent 60

服务器终结点的运行状况为“无活动”或“挂起”，已注册服务器边栏选项卡上的服务器状态为“脱机显示”

出现此问题的原因如下：

  • 存储同步监视器进程 (AzureStorageSyncMonitor.exe) 未在服务器上运行，或者服务器系统资源不足。
  • 服务器无法与Azure 文件同步服务通信。
  • 由于证书已过期或删除，服务器无法使用 Azure 文件同步 服务进行身份验证。
  • 服务器上的遥测事件日志已损坏。

在门户中显示为“脱机显示”的服务器上，查看遥测事件日志中的事件 ID 9301 (位于 事件查看器) 中的 Application and Services\Microsoft\FileSync\Agent 下，以确定此问题的原因。

  • 如果记录了“GetNextJob 已完成状态：0”，则服务器可以与Azure 文件同步服务通信。

    打开服务器上的任务管理器，验证存储同步监视器 (AzureStorageSyncMonitor.exe) 进程是否正在运行。 如果进程未运行，请先尝试重启服务器。 如果重启服务器无法解决问题，请升级到最新的 Azure 文件同步 代理版本，并验证服务器是否有足够的系统资源。

  • 如果记录了“GetNextJob 已完成状态： -2134347756”，则由于防火墙、代理或 TLS 密码套件顺序配置，服务器无法与Azure 文件同步服务通信。

    • 如果服务器位于防火墙后面，请验证是否允许端口 443 出站。 如果防火墙将流量限制到特定域，请确认防火墙 文档 中列出的域可访问。

    • 如果服务器位于代理后面，请按照代理 文档中的步骤配置计算机范围或特定于应用的代理设置。

    • Test-StorageSyncNetworkConnectivity使用 cmdlet 检查服务终结点的网络连接。

      若要了解详细信息，请参阅 测试到服务终结点的网络连接。

    • 如果在服务器上配置了 TLS 密码套件顺序，则可以使用组策略或 TLS cmdlet 添加密码套件：

      Azure 文件同步目前支持 TLS 1.2 协议的以下密码套件：

      • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
      • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
      • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
      • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

      注意

      不同的 Windows 版本支持不同的 TLS 密码套件和优先级顺序。 有关相应的 Windows 版本和受支持的密码套件以及 Microsoft Schannel 提供程序选择它们的默认顺序，请参阅 Windows 中的 TLS 密码套件。

  • 如果记录了“GetNextJob 已完成状态： -2134347764”，则由于证书已过期或删除，服务器无法使用Azure 文件同步服务进行身份验证。

    在服务器上运行以下 PowerShell 命令，确认服务器证书缺失或已过期：

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

    在服务器上运行以下 PowerShell 命令以重置用于身份验证的证书：

    Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

  • 如果遥测事件日志为空，则表示事件日志很可能已损坏。

    在服务器上运行以下 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 -FixAfsEventsCorruption

服务器终结点的运行状况为“无活动”，已注册服务器边栏选项卡上的服务器状态为“联机”

服务器终结点运行状况为“无活动”意味着服务器终结点在过去两小时内未记录同步活动。

若要检查服务器上的当前同步活动，请参阅如何实现监视当前同步会话的进度？

由于 bug 或系统资源不足，服务器终结点可能无法记录数小时同步活动。 验证已安装最新的 Azure 文件同步 代理版本。 如果问题仍然存在，请打开支持请求。

注意

如果已注册的服务器边栏选项卡上的服务器状态为“脱机显示”，则执行服务器终结点中记录的步骤 的运行状况为“无活动”或“挂起”，并且已注册的服务器边栏选项卡上的服务器状态为“脱机显示” 部分。

另请参阅

联系我们寻求帮助

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