排查Azure 文件同步云分层问题

  • 项目

云分层是Azure 文件同步的可选功能，可减少所需的本地存储量，同时保持本地文件服务器的性能。 启用后，此功能仅在本地服务器上存储经常访问 (热) 文件。 不经常访问的 (冷) 文件被拆分为命名空间 (文件和文件夹结构) 和文件内容。

云分层中有两种失败路径：

  • 文件可能无法分层，这意味着Azure 文件同步尝试将文件分层以Azure 文件存储失败。
  • 文件可能无法召回，这意味着当用户尝试访问已分层的文件时，Azure 文件同步文件系统筛选器 (StorageSync.sys) 无法下载数据。

可通过任一故障路径发生两种main类故障：

  • 云存储故障
    • 暂时性存储服务可用性问题。 有关详细信息，请参阅 Azure 存储的服务级别协议 (SLA) 。
    • 无法访问 Azure 文件共享。 当 Azure 文件共享仍然是同步组中的云终结点时，通常会在删除该文件共享时发生此故障。
    • 不可访问的存储帐户。 删除存储帐户时，通常会发生此故障，而存储帐户在同步组中仍具有作为云终结点的 Azure 文件共享。
  • 服务器故障
    • 未加载Azure 文件同步文件系统筛选器 (StorageSync.sys) 。 为了响应分层/召回请求，必须加载Azure 文件同步文件系统筛选器。 未加载筛选器的原因有多种，但最常见的原因是管理员手动卸载了筛选器。 必须随时加载Azure 文件同步文件系统筛选器，Azure 文件同步才能正常运行。
    • 缺少、损坏或其他损坏的重新分析点。 重新分析点是文件上由两个部分组成的特殊数据结构：

      1. 重新分析标记，它向操作系统指示Azure 文件同步文件系统筛选器 (StorageSync.sys) 可能需要对文件的 IO 执行某些操作。

      2. 重新分析数据，指示文件系统在关联的云终结点上筛选文件的 URI， (Azure 文件共享) 。

        重新分析点可能损坏的最常见方式是管理员尝试修改标记或其数据。

    • 网络连接问题。 为了对文件进行分层或召回，服务器必须具有 Internet 连接。

以下部分说明如何排查云分层问题，并确定问题是云存储问题还是服务器问题。

如何监视服务器上的分层活动

若要监视服务器上的分层活动，请在位于 事件查看器) 的Applications and Services\Microsoft\FileSync\Agent遥测事件日志 (中使用事件 ID 9003、9016 和 9029。

  • 事件 ID 9003 提供服务器终结点的错误分布。 例如，“总错误计数”和“ErrorCode”。 请注意，每小时为每个错误代码记录一个事件。
  • 事件 ID 9016 提供卷的重影结果。 例如，可用空间百分比为、会话中虚影的文件数和无法重影的文件数。
  • 事件 ID 9029 提供服务器终结点的虚影会话信息。 例如，会话中尝试的文件数、会话中分层的文件数和已分层的文件数。

如何监视服务器上的召回活动

若要监视服务器上的召回活动，请在 事件查看器) 中的“应用程序和服务\Microsoft\FileSync\Agent”下的“遥测事件日志” (使用事件 ID 9005、9006、9009 和 9059。

  • 事件 ID 9005 为服务器终结点提供召回可靠性。 例如，访问的唯一文件总数和访问失败的唯一文件总数。
  • 事件 ID 9006 提供服务器终结点的召回错误分布。 例如，失败请求总数和 ErrorCode。 请注意，每小时为每个错误代码记录一个事件。
  • 事件 ID 9009 提供服务器终结点的召回会话信息。 例如，DurationSeconds、CountFilesRecallSucceeded 和 CountFilesRecallFailed。
  • 事件 ID 9059 提供服务器终结点的应用程序召回分发。 例如，ShareId、应用程序名称和 TotalEgressNetworkBytes。

如何排查无法分层的文件的问题

若要对无法分层的文件进行故障排除，请执行以下步骤：

  1. 在 事件查看器中，转到 Microsoft-FileSync-Agent/TieringResults 事件日志。

  2. 对于无法分层的每个文件，都会记录一个事件。 查看 分层错误和修正 部分，查看错误代码是否列出了修正步骤。

    还可以使用 PowerShell 查看记录到 TieringResults 事件日志的事件：

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

如果错误代码中不存在内容，请按照常规故障排除步骤操作：

  1. 验证文件是否存在于 Azure 文件共享中。

    注意

    必须先将文件同步到 Azure 文件共享，然后才能对其进行分层。

  2. 验证服务器是否已建立 Internet 连接。

  3. 验证Azure 文件同步筛选器驱动程序 (StorageSync.sys 和 StorageSyncGuard.sys) 正在运行：

    • 在提升的命令提示符下，运行 fltmc。 验证是否列出了 StorageSync.sys 和 StorageSyncGuard.sys 文件系统筛选器驱动程序。

注意

如果服务器具有大量分层活动，则由于包装，TieringResults 事件日志中可能缺少一些错误。 若要防止此问题，请转到事件查看器并增加 TieringResults 事件日志大小。

分层错误和修正

HRESULT HRESULT (十进制) 错误字符串 问题 修复
0x80c86045 -2134351803 ECS_E_INITIAL_UPLOAD_PENDING 文件无法分层，因为初始上传正在进行中。 无需执行任何操作。 初始上传完成后，文件将分层。
0x80c86043 -2134351805 ECS_E_GHOSTING_FILE_IN_USE 文件因正在使用而无法分层。 无需执行任何操作。 文件在不再使用时将分层。
0x80c80241 -2134375871 ECS_E_GHOSTING_EXCLUDED_BY_SYNC 文件无法分层，因为它被同步排除。 无需执行任何操作。 无法对同步排除列表中的文件进行分层。
0x80c86042 -2134351806 ECS_E_GHOSTING_FILE_NOT_FOUND 文件无法分层，因为在服务器上找不到该文件。 无需执行任何操作。 如果错误仍然存在，检查服务器上是否存在该文件。
0x80c83053 -2134364077 ECS_E_CREATE_SV_FILE_DELETED 由于文件在 Azure 文件共享中删除，因此无法分层。 无需执行任何操作。 下一个下载同步会话运行时，应在服务器上删除该文件。
0x80c8600e -2134351858 ECS_E_AZURE_SERVER_BUSY 由于网络问题，文件无法分层。 无需执行任何操作。 如果错误仍然存在，检查与 Azure 文件共享的网络连接。
0x80072ee7 -2147012889 WININET_E_NAME_NOT_RESOLVED 由于网络问题，文件无法分层。 无需执行任何操作。 如果错误仍然存在，检查与 Azure 文件共享的网络连接。
0x80070005 -2147024891 ERROR_ACCESS_DENIED 由于访问被拒绝错误，文件无法分层。 如果文件位于 DFS-R 只读复制文件夹中，则会发生此错误。 Azure 文件同步不支持 DFS-R 只读复制文件夹中的服务器终结点。 有关详细信息，请参阅 规划指南 。
0x80072efe -2147012866 WININET_E_CONNECTION_ABORTED 由于网络问题，文件无法分层。 无需执行任何操作。 如果错误仍然存在，检查与 Azure 文件共享的网络连接。
0x80c80261 -2134375839 ECS_E_GHOSTING_MIN_FILE_SIZE 文件无法分层，因为文件大小小于支持的大小。 支持的最小文件大小基于文件系统群集大小 (文件系统群集大小) 的两倍。 例如，如果文件系统群集大小为 4 KiB，则最小文件大小为 8 KiB。
0x80c83007 -2134364153 ECS_E_STORAGE_ERROR 由于 Azure 存储问题，文件无法分层。 如果错误仍然存在，请打开支持请求。
0x800703e3 -2147023901 ERROR_OPERATION_ABORTED 文件无法分层，因为它同时被召回。 无需执行任何操作。 当召回完成并且文件不再使用时，该文件将分层。
0x80c80264 -2134375836 ECS_E_GHOSTING_FILE_NOT_SYNCED 文件无法分层，因为它尚未同步到 Azure 文件共享。 无需执行任何操作。 文件在同步到 Azure 文件共享后将分层。
0x80070001 -2147942401 ERROR_INVALID_FUNCTION 文件无法分层，因为云分层筛选器驱动程序 (storagesync.sys) 未运行。 若要解决此问题，请打开提升的命令提示符并运行以下命令： fltmc load storagesync
如果在运行 fltmc 命令时无法加载Azure 文件同步筛选器驱动程序，请卸载 Azure 文件同步 代理，重启服务器，然后重新安装 Azure 文件同步 代理。
0x80070070 -2147024784 ERROR_DISK_FULL 由于服务器终结点所在的卷上的磁盘空间不足，文件无法分层。 若要解决此问题，请在服务器终结点所在的卷上释放至少 100 MiB 磁盘空间。
0x80070490 -2147023728 ERROR_NOT_FOUND 文件无法分层，因为它尚未同步到 Azure 文件共享。 无需执行任何操作。 文件在同步到 Azure 文件共享后将分层。
0x80c80262 -2134375838 ECS_E_GHOSTING_UNSUPPORTED_RP 文件无法分层，因为它是不支持的重新分析点。 如果文件是重复数据删除重新分析点，请按照 规划指南 中的步骤启用重复数据删除支持。 不支持具有重复数据删除以外的重新分析点的文件，并且不会分层。
0x80c83052 -2134364078 ECS_E_CREATE_SV_STREAM_ID_
失 配		 文件无法分层，因为它已被修改。 无需执行任何操作。 修改后的文件同步到 Azure 文件共享后，该文件将分层。
0x80c80269 -2134375831 ECS_E_GHOSTING_REPLICA_NOT_
发现		 文件无法分层，因为它尚未同步到 Azure 文件共享。 无需执行任何操作。 文件在同步到 Azure 文件共享后将分层。
0x80072ee2 -2147012894 WININET_E_TIMEOUT 由于网络问题，文件无法分层。 无需执行任何操作。 如果错误仍然存在，检查与 Azure 文件共享的网络连接。
0x80c80017 -2134376425 ECS_E_SYNC_OPLOCK_BROKEN 文件无法分层，因为它已被修改。 无需执行任何操作。 修改后的文件同步到 Azure 文件共享后，该文件将分层。
0x800705aa -2147023446 ERROR_NO_SYSTEM_RESOURCES 由于系统资源不足，文件无法分层。 如果错误仍然存在，请调查哪个应用程序或内核模式驱动程序正在耗尽系统资源。
0x8e5e03fe -1906441218 JET_errDiskIO 写入云分层数据库时，由于 I/O 错误，文件无法分层。 如果错误仍然存在，请在卷上运行 chkdsk 并检查存储硬件。
0x8e5e0442 -1906441150 JET_errInstanceUnavailable 文件无法分层，因为云分层数据库未运行。 若要解决此问题，请重启 FileSyncSvc 服务或服务器。 如果错误仍然存在，请在卷上运行 chkdsk 并检查存储硬件。
0x80C80285 -2134375803 ECS_E_GHOSTING_SKIPPED_BY_
CUSTOM_EXCLUSION_LIST		 无法对文件进行分层，因为文件类型已从分层中排除。 若要使用此文件类型对文件进行分层，请在 HKEY_LOCAL_MACHINE 中修改 GhostingExclusionList 注册表设置
\SOFTWARE\Microsoft\Azure\StorageSync
0x80C86050 -2134351792 ECS_E_REPLICA_NOT_READY_FOR_
分层		 文件无法分层，因为当前同步模式是初始上传或对帐。 无需执行任何操作。 同步完成初始上传或对帐后，文件将分层。
0x80c8304e -2134364082 ECS_E_WORK_FRAMEWORK_ACTION_
RETRY_NOT_SUPPORTED		 发生意外错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80c8309c -2134364004 ECS_E_CREATE_SV_BATCHED_CHANGE_
DETECTION_FAILED		 发生意外错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x8000ffff -2147418113 E_UNEXPECTED 发生意外错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80c80220 -2134375904 ECS_E_SYNC_METADATA_IO_ERROR 同步数据库遇到 IO 错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80c830a7 -2134363993 ECS_E_AZURE_FILE_SNAPSHOT_LIMIT_
达到		 已达到 Azure 文件快照限制。 将 Azure 文件同步 代理升级到最新版本。 升级代理后，运行 DeepScrubbingScheduledTask 位于 \Microsoft\StorageSync 下的 。
0x80c80367 -2134375577 ECS_E_FILE_SNAPSHOT_OPERATION_
EXECUTION_MAX_ATTEMPTS_REACHED		 发生意外错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80c8306f -2134364049 ECS_E_ETAG_MISMATCH 发生意外错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80c8304c -2134364084 ECS_E_ASYNC_POLLING_TIMEOUT 发生超时错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80070299 -2147024231 ERROR_FILE_SYSTEM_LIMITATION 发生意外错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80c83054 -2134364076 ECS_E_CREATE_SV_UNKNOWN_
GLOBAL_ID		 发生意外错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80c8309b -2134364005 ECS_E_CREATE_SV_PER_ITEM_CHANGE_
DETECTION_FAILED		 发生意外错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80c83034 -2134364108 ECS_E_FORBIDDEN 访问被拒绝。 请在存储帐户上检查访问策略，同时检查代理设置。 了解详细信息。
0x80070034 -2147024844 ERROR_DUP_NAME 发生意外错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80071128 -2147020504 ERROR_INVALID_REPARSE_DATA 数据已损坏且不可读。 chkdsk在卷上运行。 了解详细信息。
0x8e5e0450 -1906441136 JET_errInvalidSesid 发生意外错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80092004 -2146885628 CRYPT_E_NOT_FOUND 缺少Azure 文件同步身份验证所需的证书。 在服务器上运行此 PowerShell 命令以重置证书：
Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>.
0x80c80020 -2134376416 ECS_E_CLUSTER_NOT_RUNNING 故障转移群集服务未运行。 验证群集服务 (clussvc) 正在运行。 了解详细信息。
0x80c83036 -2134364106 ECS_E_NOT_FOUND 发生意外错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x801f0005 -2145452027 ERROR_FLT_INVALID_NAME_REQUEST 发生意外错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80071126 -2147020506 ERROR_NOT_A_REPARSE_POINT 发生了内部错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80070718 -2147023080 ERROR_NOT_ENOUGH_QUOTA 没有足够的服务器内存资源可用于处理此命令。 监视服务器上的内存使用情况。 了解详细信息。
0x8007046a -2147023766 ERROR_NOT_ENOUGH_SERVER_
记忆		 没有足够的服务器内存资源可用于处理此命令。 监视服务器上的内存使用情况。 了解详细信息。
0x80070026 -2147024858 COR_E_ENDOFSTREAM 发生外部错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80131501 -2146233087 COR_E_SYSTEM 发生外部错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80c86040 -2134351808 ECS_E_AZURE_FILE_SHARE_INVALID_
头		 发生意外错误。 如果错误持续一天以上，请创建支持请求。
0x80c80339 -2134375623 ECS_E_CERT_DATE_INVALID 服务器的 SSL 证书已过期。 请咨询组织的技术支持以获取帮助。 如果需要进一步调查，请创建支持请求。
0x80c80337 -2134375625 ECS_E_INVALID_CA 服务器的 SSL 证书由此电脑不信任的证书颁发机构颁发。 请咨询组织的技术支持以获取帮助。 如果需要进一步调查，请创建支持请求。
0x80c80001 -2134376447 ECS_E_SYNC_INVALID_PROTOCOL_
格式		 无法建立与服务的连接。 请正确检查并配置代理设置，或删除代理设置。 了解详细信息。
0x800706d9 -2147023143 EPT_S_NOT_REGISTERED 发生外部错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80070035 -2147024843 ERROR_BAD_NETPATH 发生外部错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80070571 -2147023503 ERROR_DISK_CORRUPT 磁盘结构已损坏且不可读。 chkdsk在卷上运行。 了解详细信息。
0x8007052e -2147023570 ERROR_LOGON_FAILURE 由于身份验证失败，操作失败。 如果错误持续一天以上，请创建支持请求。
0x8002802b -2147319765 TYPE_E_ELEMENTNOTFOUND 发生意外错误。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80072f00 -2147012864 WININET_E_FORCE_RETRY 无法建立与服务的连接。 无需执行任何操作。 此错误应会自动解决。 如果错误持续数天，请创建支持请求。
0x80C86093 -2134351785 ECS_E_STABLEVERSION_SVID_CHECK_
失败		 由于已知问题，无法对文件进行分层。 无需执行任何操作。 忽略此错误，在发布修补程序后，该错误将不再显示。

如何对无法召回的文件进行故障排除

若要对无法召回的文件进行故障排除，请执行以下步骤：

  1. 在 事件查看器 中，转到 Microsoft-FileSync-Agent/RecallResults 事件日志。

  2. 每个被召回的文件都记录了一个事件。 如果字段 DataTransferHresult 为 0，则文件召回成功。 如果字段DataTransferHresult具有错误代码，检查“召回错误和修正”部分，查看错误代码是否列出了修正步骤。

    还可以使用 PowerShell 查看记录到 RecallResults 事件日志的事件：

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

如果错误代码中不存在内容，请按照常规故障排除步骤操作：

  1. 验证文件是否存在于 Azure 文件共享中。
  2. 验证服务器是否已建立 Internet 连接。
  3. 打开服务 MMC 管理单元，验证存储同步代理服务 (FileSyncSvc) 是否正在运行。
  4. 验证Azure 文件同步筛选器驱动程序 (StorageSync.sys 和 StorageSyncGuard.sys) 正在运行：
    • 在提升的命令提示符下，运行 fltmc。 验证是否列出了 StorageSync.sys 和 StorageSyncGuard.sys 文件系统筛选器驱动程序。

注意

如果服务器具有大量召回活动，则由于包装，RecallResults 事件日志中可能缺少一些错误。 若要防止此问题，请转到事件查看器并增加 RecallResults 事件日志大小。

召回错误和修正

HRESULT HRESULT (十进制) 错误字符串 问题 修复
0x80070079 -2147942521 ERROR_SEM_TIMEOUT 由于 I/O 超时，文件无法召回。 出现此问题的原因有多种：服务器资源限制、网络连接不佳或 Azure 存储问题 (例如限制) 。 无需执行任何操作。 如果错误持续数小时，请创建支持案例。
0x80070036 -2147024842 ERROR_NETWORK_BUSY 由于网络问题，文件无法召回。 如果错误仍然存在，检查与 Azure 文件共享的网络连接。
0x80c80037 -2134376393 ECS_E_SYNC_SHARE_NOT_FOUND 文件无法召回，因为服务器终结点已删除。 若要解决此问题，请参阅 删除服务器终结点后，无法在服务器上访问分层文件。
0x80070005 -2147024891 ERROR_ACCESS_DENIED 由于访问被拒绝错误，文件无法召回。 如果存储帐户上的防火墙和虚拟网络设置已启用，并且服务器无权访问存储帐户，则可能会出现此问题。 若要解决此问题，请按照部署指南中的 配置防火墙和虚拟网络设置 部分中所述的步骤添加服务器 IP 地址或虚拟网络。
0x80c86002 -2134351870 ECS_E_AZURE_RESOURCE_NOT_FOUND 由于无法在 Azure 文件共享中访问该文件，因此无法召回该文件。 若要解决此问题，请验证 Azure 文件共享中是否存在该文件。 如果文件存在于 Azure 文件共享中，请升级到最新的 Azure 文件同步 代理版本。
0x80c8305f -2134364065 ECS_E_EXTERNAL_STORAGE_ACCOUNT_
AUTHORIZATION_FAILED		 由于对存储帐户的授权失败，文件无法召回。 若要解决此问题，请验证Azure 文件同步有权访问存储帐户。
0x80c86030 -2134351824 ECS_E_AZURE_FILE_SHARE_NOT_FOUND 文件无法召回，因为 Azure 文件共享不可访问。 验证文件共享是否存在且可访问。 如果删除并重新创建文件共享，请执行 同步失败（因为删除并重新创建了 Azure 文件共享 ）部分中所述的步骤，以删除并重新创建同步组。
0x800705aa -2147023446 ERROR_NO_SYSTEM_RESOURCES 由于系统资源不足，文件无法召回。 如果错误仍然存在，请调查哪个应用程序或内核模式驱动程序正在耗尽系统资源。
0x8007000e -2147024882 ERROR_OUTOFMEMORY 由于内存不足，文件无法召回。 如果错误仍然存在，请调查哪个应用程序或内核模式驱动程序导致内存不足的情况。
0x80070070 -2147024784 ERROR_DISK_FULL 由于磁盘空间不足，文件无法召回。 若要解决此问题，请释放卷上的空间，方法是将文件移动到其他卷、增加卷的大小，或使用 cmdlet 强制文件分层 Invoke-StorageSyncCloudTiering 。
0x80072f8f -2147012721 WININET_E_DECODING_FAILED 文件无法召回，因为服务器无法解码来自 Azure 文件同步 服务的响应。 如果网络代理正在修改来自 Azure 文件同步 服务的响应，则通常会发生此错误。 请检查代理配置。
0x80090352 -2146892974 SEC_E_ISSUING_CA_UNTRUSTED 由于组织正在使用 TLS 终止代理或恶意实体正在截获服务器与Azure 文件同步服务之间的流量，文件无法召回。 如果你确定这是预期 (，因为你的组织正在使用 TLS 终止代理) ，请按照针对错误 CERT_E_UNTRUSTEDROOT 记录的步骤来解决此问题。
0x80c86047 -2134351801 ECS_E_AZURE_SHARE_SNAPSHOT_NOT_
发现		 该文件无法召回，因为它引用了 Azure 文件共享中不再存在的文件版本。 如果已从 Windows Server 的备份还原分层文件，则可能会出现此问题。 若要解决此问题，请从 Azure 文件共享中的快照还原文件。
0x80070032 -2147024846 ERROR_NOT_SUPPORTED 发生了内部错误。 请升级到最新的 Azure 文件同步 代理版本。 如果错误在升级代理后仍然存在，请创建支持请求。
0x80070006 -2147024890 ERROR_INVALID_HANDLE 发生了内部错误。 如果错误持续一天以上，请创建支持请求。
0x80c80310 -2134375664 ECS_E_INVALID_DOWNLOAD_RESPONSE Azure 文件同步错误。 如果错误持续一天以上，请创建支持请求。
0x8007045d -2147023779 ERROR_IO_DEVICE 发生了内部错误。 如果错误持续一天以上，请创建支持请求。
0x80c8604b -2134351797 ECS_E_AZURE_FILE_SHARE_FILE_NOT_
发现		 在文件共享中找不到文件。 你可能执行了不受支持的操作。 了解详细信息。 请查找文件的原始副本，并覆盖服务器终结点中的分层文件。
0x80070021 -2147024863 ERROR_LOCK_VIOLATION 由于另一个进程锁定了文件的一部分，因此进程无法访问该文件。 无需执行任何操作。 应用程序关闭文件的句柄后，召回应成功。
0x80c8604c -2134351796 ECS_E_AZURE_FILE_SNAPSHOT_NOT_
FOUND_SYNC_PENDING		 发生了内部错误。 无需执行任何操作。 如果错误持续一天以上，请创建支持请求。 在同步会话完成后，召回应成功。
0x80c80312 -2134375662 ECS_E_DOWNLOAD_SESSION_STREAM_
打断		 无法完成文件下载。 同步将在稍后重试。 如果错误仍然存在，请使用 Test-StorageSyncNetworkConnectivity cmdlet 检查与服务终结点的网络连接。 了解详细信息。
0x80c8600c -2134351860 ECS_E_AZURE_INTERNAL_ERROR 服务器遇到内部错误。 无需执行任何操作。 如果错误持续一天以上，请创建支持请求。
0x80c8600b -2134351861 ECS_E_AZURE_INVALID_RANGE 服务器遇到内部错误。 无需执行任何操作。 如果错误持续一天以上，请创建支持请求。
0x8007045b -2147023781 ERROR_SHUTDOWN_IN_PROGRESS 系统关闭正在进行中。 无需执行任何操作。 如果错误持续一天以上，请创建支持请求。
0x80072efd -2147012867 WININET_E_CANNOT_CONNECT 无法建立与服务的连接。 Test-StorageSyncNetworkConnectivity使用 cmdlet 检查服务终结点的网络连接。 了解详细信息。
0x80072f8f -2147012721 WININET_E_DECODING_FAILED 防火墙、代理或网关阻止了对 PKI URL 的访问，或者 PKI 服务器已关闭。 确保服务器可以访问以下 URL：

公有云终结点：

https://www.microsoft.com/pki/mscorp/cps
http://crl.microsoft.com/pki/mscorp/crl/
http://mscrl.microsoft.com/pki/mscorp/crl/
http://ocsp.msocsp.com
http://ocsp.digicert.com/
http://crl3.digicert.com/

Azure 政府终结点：

https://www.microsoft.com/pki/mscorp/cps
http://crl.microsoft.com/pki/mscorp/crl/
http://mscrl.microsoft.com/pki/mscorp/crl/
http://ocsp.msocsp.com
http://ocsp.digicert.com/
http://crl3.digicert.com/

安装 Azure 文件同步 代理后，PKI URL 用于下载与 Azure 文件同步 服务和 Azure 文件共享通信所需的中间证书。 OCSP URL 用于检查证书的状态。 如果错误持续数天，请创建支持请求。
0x800703ee -2147023890 ERROR_FILE_INVALID 文件的卷已在外部进行了更改，因此打开的文件不再有效。 如果错误持续一天以上，请创建支持请求。
0x80c86048 -2134351800 ECS_E_AZURE_FILE_SNAPSHOT_NOT_
发现		 发生了内部错误。 你可能执行了不受支持的操作。 了解详细信息。 请查找文件的原始副本，并覆盖服务器终结点中的分层文件。
0x80072f78 -2147012744 WININET_E_INVALID_SERVER_RESPONSE 无法建立与服务的连接。 Test-StorageSyncNetworkConnectivity使用 cmdlet 检查服务终结点的网络连接。 了解详细信息。
0x8007139f -2147019873 ERROR_INVALID_STATE 发生了内部错误。 无需执行任何操作。 如果错误持续一天以上，请创建支持请求。
0x80070570 -2147023504 ERROR_FILE_CORRUPT 文件或目录已损坏且不可读。 在卷上运行 chkdsk。 了解详细信息。
0x800705ad -2147023443 ERROR_WORKING_SET_QUOTA 配额不足，无法完成请求的服务。 监视服务器上的内存使用情况。 如果错误持续一天以上，请创建支持请求。
0x80070008 -2147024888 ERROR_NOT_ENOUGH_MEMORY 没有足够的内存资源可用于处理此命令。 监视服务器上的内存使用情况。 如果错误持续一天以上，请创建支持请求。
0x80c80072 -2134376334 ECS_E_BAD_GATEWAY 无法建立与服务的连接。 Test-StorageSyncNetworkConnectivity使用 cmdlet 检查服务终结点的网络连接。 了解详细信息。
0x80190193 -2145844845 HTTP_E_STATUS_FORBIDDEN 发生禁止 (403) 错误。 更新 Azure 文件共享访问策略。 了解详细信息。
0x80c8604e -2134351794 ECS_E_AZURE_FILE_SNAPSHOT_NOT_
FOUND_ON_CONFLICT_FILE		 无法从 Azure 文件共享中召回同步冲突失败者文件。 如果作为同步冲突文件的分层文件发生此错误，最终用户可能不再需要此文件。 如果原始文件可用且有效，则可以从服务器终结点中删除此文件。
0x80c80075 -2134376331 ECS_E_ACCESS_TOKEN_CATASTROPHIC
_失败		 发生了内部错误。 无需执行任何操作。 如果错误持续一天以上，请创建支持请求。
0x80c8005b -2134376357 ECS_E_AZURE_FILE_SERVICE_
无法		 Azure 文件服务当前不可用。 如果错误持续一天以上，请创建支持请求。
0x80c83099 -2134364007 ECS_E_PRIVATE_ENDPOINT_ACCESS_
封锁		 专用终结点配置访问已阻止。 检查专用终结点配置并允许访问 Azure 文件同步 服务。 了解详细信息。
0x80c86000 -2134351872 ECS_E_AZURE_AUTHENTICATION_FAILED 服务器无法对请求进行身份验证。 检查网络配置，并确保存储帐户接受服务器 IP 地址。 为此，可以添加服务器 IP、添加服务器的 IP 子网，或将服务器 vnet 添加到授权的访问控制列表以访问存储帐户。 了解详细信息。
0x80072ef1 -2147012879
ERROR_WINHTTP_OPERATION_CANCELLED		 无法建立与服务的连接。 如果错误仍然存在，请使用 Test-StorageSyncNetworkConnectivity cmdlet 检查与服务终结点的网络连接。 了解详细信息。
0x80c80338 -2134375624 ECS_E_CERT_CN_INVALID 服务器的 SSL 证书包含不正确的主机名。 证书不能用于建立 SSL 连接。 请咨询组织的技术支持以获取帮助。 如果需要进一步调查，请创建支持请求。
0x80c8000c -2134376436 ECS_E_SYNC_UNKNOWN_URI 发生了内部错误。 无需执行任何操作。 如果错误持续一天以上，请创建支持请求。
0x80c8033a -2134375622 ECS_E_SECURITY_CHANNEL_ERROR 验证服务器的 SSL 证书时出现问题。 请咨询组织的技术支持以获取帮助。 如果需要进一步调查，请创建支持请求。
0x80131509 -2146233079 COR_E_INVALIDOPERATION 发生意外错误。 如果错误持续一天以上，请创建支持请求。
0x80c8603d -2134351811 ECS_E_AZURE_UNKNOWN_FAILURE 发生意外错误。 无需执行任何操作。 如果错误持续一天以上，请创建支持请求。
0x80c8033f -2134375617 ECS_E_TOKEN_LIFETIME_IS_TOO_LONG 发生了内部错误。 无需执行任何操作。 如果错误持续一天以上，请创建支持请求。
0x80190190 -2145844848 HTTP_E_STATUS_BAD_REQUEST 无法建立与服务的连接。 无需执行任何操作。 如果错误持续一天以上，请创建支持请求。
0x80c86036 -2134351818 ECS_E_AZURE_FILE_PARENT_NOT_
发现		 该文件的指定父路径不存在 你可能执行了不受支持的操作。 了解详细信息。 请查找文件的原始副本，并覆盖服务器终结点中的分层文件。
0x80c86049 -2134351799 ECS_E_AZURE_SHARE_SNAPSHOT_FILE_
NOT_FOUND		 在共享快照中找不到文件。 你可能执行了不受支持的操作。 了解详细信息。 请查找文件的原始副本，并覆盖服务器终结点中的分层文件。
0x80c80311 -2134375663 ECS_E_DOWNLOAD_SESSION_HASH_
冲突		 发生了内部错误。 如果错误持续一天以上，请创建支持请求。
0x800700a4 -2147024732 ERROR_MAX_THRDS_REACHED 发生了内部错误。 无需执行任何操作。 如果错误持续一天以上，请创建支持请求。
0x80070147 -2147024569 ERROR_OFFSET_ALIGNMENT_
违反		 发生了内部错误。 如果错误持续一天以上，请创建支持请求。
0x80090321 -2146893023 SEC_E_BUFFER_TOO_SMALL 发生了内部错误。 如果错误持续一天以上，请创建支持请求。
0x801901a0 -2145844832 HTTP_E_STATUS_RANGE_NOT_
SATISFIABLE		 发生了内部错误。 如果错误持续一天以上，请创建支持请求。
0x80c80066 -2134376346 ECS_E_CLUSTER_ID_MISMATCH 从群集 API 返回的群集 ID 与注册期间保存的群集 ID 不匹配。 请创建支持请求以进一步调查问题。
0x80c8032d -2134375635 ECS_E_PROXY_AUTH_REQUIRED 用于访问 Internet 的代理服务器需要你当前的凭据。 如果代理需要身份验证，请更新代理凭据。 了解详细信息。
0x8007007a -2147024774 ERROR_INSUFFICIENT_BUFFER 发生了内部错误。 无需执行任何操作。 如果错误持续一天以上，请创建支持请求。
0x8019012e -2145844946 HTTP_E_STATUS_REDIRECT Azure 文件同步不支持 HTTP 重定向。 在代理服务器或网络设备上禁用 HTTP 重定向。
0x800706be -2147023170 RPC_S_CALL_FAILED 出现未知错误。 如果错误仍然存在，请使用 Test-StorageSyncNetworkConnectivity cmdlet 检查与服务终结点的网络连接。 了解详细信息。
0x80072747 -2147014841 WSAENOBUFS 发生了内部错误。 如果错误仍然存在，请使用 Test-StorageSyncNetworkConnectivity cmdlet 检查与服务终结点的网络连接。 了解详细信息。
0x80C86093 -2134351785 ECS_E_STABLEVERSION_SVID_CHECK_
失败		 由于已知问题，无法召回该文件。 从其他终结点或云共享手动复制文件。 如果无法手动复制文件，请创建支持票证。
0x80C80362 -2134375582 ECS_E_ITEM_PATH_COMPONENT_HAS_
TRAILING_DOT		 由于路径中的尾随点，文件分层或下载失败。 重命名文件夹或文件名中的尾随点。
0x80c83096 -2134364010 ECS_E_MGMT_
STORAGEACLSBYPASSNOTSET		 如果在存储帐户上启用了防火墙和虚拟网络设置，并且未选中 “允许受信任的 Microsoft 服务访问此存储帐户 ”异常，则会发生此错误。 若要解决此问题，请按照 配置防火墙和虚拟网络设置中的步骤操作。

删除服务器终结点后，无法在服务器上访问分层文件

如果在删除服务器终结点之前未召回文件，则服务器上的分层文件将变得不可访问。

如果无法访问分层文件，则记录错误：

  • 同步文件时，在 ItemResults 事件日志中记录错误代码 -2147942467 (0x80070043 - ERROR_BAD_NET_NAME) 。
  • 召回文件时，错误代码 -2134376393 (0x80c80037 - ECS_E_SYNC_SHARE_NOT_FOUND) 记录在 RecallResults 事件日志中。

如果满足以下条件，可以还原对分层文件的访问权限：

  • 在过去 30 天内删除了服务器终结点。
  • 未删除云终结点。
  • 未删除文件共享。
  • 同步组未删除。

如果满足上述条件，则可以通过在 30 天内在同一同步组中的服务器上的同一路径上重新创建服务器终结点来还原对服务器上的文件的访问权限。

如果不满足上述条件，则无法还原访问权限，因为服务器上的这些分层文件现在已孤立。 按照这些说明删除孤立的分层文件。

注意

  • 当无法在服务器上访问分层文件时，如果直接访问 Azure 文件共享，则应仍可访问完整文件。
  • 若要防止将来出现孤立分层文件，请按照 删除服务器终结点时删除服务器终结点 中所述的步骤进行操作。

如何获取孤立分层文件的列表

  1. 运行以下 PowerShell 命令以列出孤立的分层文件：

    Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
$orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
$orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt

  2. 保存 OrphanTieredFiles.txt 输出文件，以防文件在删除后需要从备份还原。

如何删除孤立的分层文件

选项 1：删除孤立的分层文件

此选项将删除 Windows Server 上孤立的分层文件，但如果服务器终结点由于 30 天后重新创建而存在，或者已连接到其他同步组，则需要删除该终结点。 如果在重新创建服务器终结点之前在 Windows Server 或 Azure 文件共享上更新文件，则会发生文件冲突。

  1. 备份 Azure 文件共享和服务器终结点位置。

  2. 按照删除服务器终结点中所述的步骤，删除同步组中的服务器 终结点 (是否存在) 。

    警告

    如果在使用 Remove-StorageSyncOrphanedTieredFiles cmdlet 之前未删除服务器终结点，则删除服务器上的孤立分层文件将删除 Azure 文件共享中的完整文件。

  3. 运行以下 PowerShell 命令以列出孤立的分层文件：

    Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
$orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
$orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt

  4. 保存 OrphanTieredFiles.txt 输出文件，以防文件在删除后需要从备份还原。

  5. 运行以下 PowerShell 命令以删除孤立的分层文件：

    Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
$orphanFilesRemoved = Remove-StorageSyncOrphanedTieredFiles -Path <folder path containing orphaned tiered files> -Verbose
$orphanFilesRemoved.OrphanedTieredFiles > DeletedOrphanFiles.txt

    注意

    • 服务器上修改的未同步到 Azure 文件共享的分层文件将被删除。
    • 不会删除可访问 (非孤立) 的分层文件。
    • 非分层文件将保留在服务器上。

  6. 可选：如果步骤 3 中删除，请重新创建服务器终结点。

选项 2：装载 Azure 文件共享，并在本地复制服务器上孤立的文件

此选项不需要删除服务器终结点，但需要足够的磁盘空间来在本地复制完整文件。

  1. 在具有孤立分层文件的 Windows Server 上装载 Azure 文件共享。

  2. 运行以下 PowerShell 命令以列出孤立的分层文件：

    Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
$orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
$orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt

  3. 使用 OrphanTieredFiles.txt 输出文件标识服务器上的孤立分层文件。

  4. 通过将完整文件从 Azure 文件共享复制到 Windows Server 来覆盖孤立的分层文件。

如何排查服务器上意外召回的文件的问题

防病毒、备份和其他读取大量文件的应用程序会导致意外召回，除非它们尊重 skip offline 属性并跳过读取这些文件的内容。 跳过支持此选项的产品的脱机文件有助于避免在防病毒扫描或备份作业等操作期间发生意外召回。

咨询软件供应商，了解如何配置其解决方案以跳过读取脱机文件。

其他情况下也可能发生意外召回，例如在 文件资源管理器 中浏览云分层文件时。 如果文件夹包含可执行文件，则Windows Server 2016可能会发生这种情况。 Windows Server 2019 及更高版本改进了文件资源管理器，以更好地处理脱机文件。

注意

使用遥测事件日志中的事件 ID 9059 确定哪个应用程序 () 导致召回。 此事件为服务器终结点提供应用程序召回分发，并且每小时记录一次。

Azure 文件同步的进程排除项

如果要将防病毒或其他应用程序配置为跳过扫描Azure 文件同步访问的文件，请配置以下进程排除项：

  • C：\Program Files\Azure\StorageSyncAgent\AfsAutoUpdater.exe
  • C：\Program Files\Azure\StorageSyncAgent\FileSyncSvc.exe
  • C：\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentLauncher.exe
  • C：\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentHost.exe
  • C：\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentManager.exe
  • C：\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentCore.exe
  • C：\Program Files\Azure\StorageSyncAgent\MAAgent\Extensions\XSyncMonitoringExtension\AzureStorageSyncMonitor.exe

Azure 文件同步需要 TLS 1.2

可以通过查看注册表设置来查看服务器上的 TLS 设置。

如果使用的是代理，请参阅代理的文档，并确保将其配置为使用 TLS 1.2。

另请参阅

联系我们寻求帮助

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