排查 Azure 文件同步云分层问题
云分层是 Azure 文件同步的一项可选功能，可减少所需的本地存储量，同时保留本地文件服务器的性能。 启用后，此功能仅存储本地服务器上经常访问的（热）文件。 不常访问的（冷）文件会拆分为命名空间（文件和文件夹结构）和文件内容。
云分层中存在两个故障路径：
- 文件可能无法层，这意味着，Azure 文件同步未成功尝试将某个文件分层到 Azure 文件。
- 文件可能无法撤回，这意味着，当某个用户尝试访问已分层的文件时，Azure 文件同步文件系统筛选器 (StorageSync.sys) 无法下载数据。
通过任一故障路径可能发生两个主要故障类：
- 云存储故障
- 暂时性存储服务可用性问题。 有关详细信息，请参阅 Azure 存储的服务级别协议 (SLA)。
- Azure 文件共享不可访问。 删除仍属于同步组中的云终结点的 Azure 文件共享时，通常会发生此故障。
- 存储帐户不可访问。 删除仍包含 Azure 文件共享（属于同步组中的云终结点）的存储帐户时，通常会发生此故障。
- 服务器故障
- 未加载 Azure 文件同步文件系统筛选器 (StorageSync.sys)。 为了响应分层/撤回请求，必须加载 Azure 文件同步文件系统筛选器。 可能会出于多种原因而未能加载该筛选器，但最常见的原因是管理员已手动将其卸载。 要使 Azure 文件同步正常运行，始终必须加载 Azure 文件同步文件系统筛选器。
- 重分析点缺失、损坏或出现其他形式的中断。 重分析点是文件中的特殊数据结构，它由两个部分组成：
一个重分析标记，向操作系统指示 Azure 文件同步文件系统筛选器 (StorageSync.sys) 可能需要针对文件的 IO 执行某项操作。
重分析数据，向文件系统筛选器指示关联云终结点（Azure 文件共享）上的文件的 URI。
重分析点损坏的最常见原因是管理员尝试修改标记或其数据。
- 网络连接问题。 若要分层或撤回文件，服务器必须已建立 Internet 连接。
以下部分说明如何排查云分层问题，并确定问题是云存储问题还是服务器问题。
如何监视服务器上的分层活动
若要监视服务器上的分层活动，请使用遥测事件日志（位于“事件查看器”中的 Applications and Services\Microsoft\FileSync\Agent 下）中的事件 ID 9003、9016 和 9029。
- 事件 ID 9003 提供服务器终结点的错误分布情况。 例如，总错误计数和 ErrorCode。 请注意，每小时每错误代码记录一个事件。
- 事件 ID 9016 提供卷的副本创建结果。 例如，可用空间百分比为：会话中虚影的文件数，文件数无法虚影。
- 事件 ID 9029 提供服务器终结点的副本创建会话信息。 例如，会话中尝试的文件数、会话中分层的文件数和已分层的文件数。
如何监视服务器上的重新调用活动
若要监视服务器上的回调活动，请使用遥测事件日志（位于“事件查看器”中的“应用程序和服务\Microsoft\FileSync\代理”下）中的事件 ID 9005、9006、9009 和 9059。
- 事件 ID 9005 提供服务器终结点的重新调用可靠性。 例如，访问的唯一文件总数和访问失败的唯一文件总数。
- 事件 ID 9006 提供服务器终结点的重新调用错误分布情况。 例如，失败的请求总数和 ErrorCode。 请注意，每小时每错误代码记录一个事件。
- 事件 ID 9009 提供服务器终结点的回调会话信息。 例如，DurationSeconds、CountFilesRecallSucceeded 和 CountFilesRecallFailed。
- 事件 ID 9059 提供服务器终结点的应用程序回调分布情况。 例如，ShareId、应用程序名称和 TotalEgressNetworkBytes。
如何识别服务器上召回的文件
- 在事件查看器中，转到 Microsoft-FileSync-Agent/RecallResults 事件日志。
- 为每个被召回的文件记录了一个事件。
DataTransferHresult如果字段为0，则文件撤回成功。DataTransferHresult如果该字段具有错误代码，请检查“召回”错误和修正部分，以查看是否列出了错误代码的修正步骤。
如何对未能分层的文件进行故障排除
若要对无法分层的文件进行故障排除，请执行以下步骤：
在事件查看器中，转到 Microsoft-FileSync-Agent/TieringResults 事件日志。
对于无法分层的每个文件，都会记录一个事件。 检查分层错误和修正部分，以查看是否列出了针对错误代码的修正步骤。
还可以使用 PowerShell 查看记录到 TieringResults 事件日志的事件：
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll" Get-StorageSyncFileTieringResult
如果错误代码不存在内容，请按照常规故障排除步骤操作：
验证该文件是否存在于 Azure 文件共享中。
注意
文件必须先同步到 Azure 文件共享，然后才能分层。
验证服务器是否具有 Internet 连接。
验证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_ MISMATCH |
由于已对文件进行了修改，文件分层失败。 | 无需采取措施。 当修改后的文件同步到 Azure 文件共享时，文件将进行分层。 |
| 0x80c80269 | -2134375831 | ECS_E_GHOSTING_REPLICA_NOT_ FOUND |
由于文件尚未同步到 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_ TIERING |
文件分层失败，是因为当前同步模式为初始上传或协调。 | 无需采取措施。 同步完成初始上传或协调后，文件将分层。 |
| 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_ REACHED |
已达到 Azure 文件快照限制。 | 将 Azure 文件同步代理升级到最新版本。 升级代理后，运行位于 \Microsoft\ StorageSync 下的 DeepScrubbingScheduledTask。 |
| 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_ FORMAT |
无法与服务建立连接。 | 请检查并正确配置代理设置，或删除代理设置。 了解详细信息。 |
| 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_ FAILED |
由于已知问题，无法对文件进行分层。 | 无需采取措施。 忽略错误，在释放修补程序后，它将不再显示。 |
如何对未能召回的文件进行故障排除
若要对无法召回的文件进行故障排除，请执行以下步骤：
在事件查看器中，转到 Microsoft-FileSync-Agent/RecallResults 事件日志。
为每个被召回的文件记录了一个事件。
DataTransferHresult如果字段为0，则文件撤回成功。DataTransferHresult如果该字段具有错误代码，请检查“召回”错误和修正部分，以查看是否列出了错误代码的修正步骤。还可以使用 PowerShell 查看记录到 RecallResults 事件日志的事件：
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll" Get-StorageSyncFileRecallResult
如果错误代码不存在内容，请按照常规故障排除步骤操作：
- 验证该文件是否存在于 Azure 文件共享中。
- 验证服务器是否具有 Internet 连接。
- 打开服务 MMC 管理单元，并验证存储同步代理服务（FileSyncSvc）是否正在运行。
- 验证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 | 由于系统资源不足，文件撤回失败。 注意：如果Azure 文件同步代理版本为 19 或更高版本，并且存储同步代理服务（FileSyncSvc）未运行，则重命名服务器终结点位置中的文件或文件夹时会遇到错误。 |
验证存储同步代理服务（FileSyncSvc）是否正在运行。 如果 FileSyncSvc 正在运行并且错误仍然存在，请调查哪个应用程序或内核模式驱动程序正在耗尽系统资源。 |
| 0x8007000e | -2147024882 | ERROR_OUTOFMEMORY | 由于内存不足，文件撤回失败。 | 如果错误仍然存在，请调查导致内存不足的应用程序或内核模式驱动程序。 |
| 0x80070070 | -2147024784 | ERROR_DISK_FULL | 由于磁盘空间不足，文件撤回失败。 | 要解决此问题，请将文件移到其他卷以释放卷的空间、增加卷大小，或使用 Invoke-StorageSyncCloudTiering cmdlet 强制文件分层。 |
| 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_ FOUND |
文件无法撤回，因为其引用的文件版本在 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_ FOUND |
在文件共享中找不到文件。 | 你可能执行了不受支持的操作。 了解详细信息。 请查找文件的原始副本，并覆盖服务器终结点中的分层文件。 |
| 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_ FOUND |
发生内部错误。 | 你可能执行了不受支持的操作。 了解详细信息。 请查找文件的原始副本，并覆盖服务器终结点中的分层文件。 |
| 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_ FOUND |
为文件指定的父路径不存在 | 你可能执行了不受支持的操作。 了解详细信息。 请查找文件的原始副本，并覆盖服务器终结点中的分层文件。 |
| 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_ FAILED |
由于已知问题，无法召回该文件。 | 从其他终结点或云共享手动复制文件。 如果无法手动复制文件，请创建支持票证。 |
| 0x80C80362 | -2134375582 | ECS_E_ITEM_PATH_COMPONENT_HAS_ TRAILING_DOT |
由于路径中的尾随点，文件分层或下载失败。 | 重命名文件夹或文件名中的尾随点。 |
| 0x80c83096 | -2134364010 | ECS_E_MGMT_ STORAGEACLSBYPASSNOTSET |
如果在存储帐户上启用了防火墙和虚拟网络设置，并且未检查“允许受信任的Microsoft 服务访问此存储帐户异常，则会发生此错误。 | 若要解决此问题，请按照配置防火墙和虚拟网络设置中的步骤操作。 |
在删除服务器终结点后无法访问服务器上的分层文件
如果在删除服务器终结点之前未召回文件，或者从本地（第三方）备份还原到服务器终结点位置，则服务器上的分层文件将无法访问。
如果无法访问分层文件，将记录以下错误：
- 同步文件时，在 ItemResults 事件日志中记录错误代码 -2147023890 （0x800703ee - ERROR_FILE_INVALID） 或 -2147942467 （0x80070043 - ERROR_BAD_NET_NAME）。
- 撤回文件时，在 RecallResults 事件日志中记录错误代码 -2147023890 （0x800703ee - ERROR_FILE_INVALID） 或 -2134376393 （0x80c80037 - ECS_E_SYNC_SHARE_NOT_FOUND）。
如果由于删除服务器终结点而无法访问分层文件，则如果满足以下条件，则有可能还原对分层文件的访问权限：
- 在过去 30 天内删除了服务器终结点。
- 云终结点未删除。
- 未删除文件共享。
- 同步组未删除。
如果满足上述条件，可以通过在 30 天内在同一同步组中在同一个服务器上的同一路径上重新创建服务器终结点来还原对服务器上的文件的访问权限。
如果未满足上述条件，或者已从本地（第三方）备份还原分层文件，则无法还原访问权限，因为服务器上的这些分层文件现已孤立。 按照以下说明删除孤立的分层文件。
注意
- 当无法访问服务器上的分层文件时，如果直接访问 Azure 文件共享，则完整文件应仍可访问。
- 若要防止将来出现孤立分层文件，请按照删除服务器终结点时删除服务器终结点中记录的步骤操作，不要从本地备份还原分层文件，请参阅灾难恢复最佳做法和Azure 文件同步。
运行以下 PowerShell 命令以列出孤立的分层文件：
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll" $orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path> $orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt保存OrphanTieredFiles.txt输出文件，以防文件在删除后需要从备份还原。
选项 1：删除孤立的分层文件
此选项将删除 Windows Server 上孤立的分层文件，但如果服务器终结点在 30 天后重新创建，或已连接到其他同步组，则需将其删除。 如果在重新创建服务器终结点之前在 Windows Server 或 Azure 文件共享上更新了文件，则会发生文件冲突。
备份 Azure 文件共享和服务器终结点位置。
按照删除服务器终结点中所述的步骤，在同步组中删除服务器终结点（如果存在）。
警告
如果在使用
Remove-StorageSyncOrphanedTieredFilescmdlet 之前未删除服务器终结点，则删除服务器上孤立的分层文件将删除 Azure 文件共享中的完整文件。运行以下 PowerShell 命令以列出孤立的分层文件：
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll" $orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path> $orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt保存OrphanTieredFiles.txt输出文件，以防文件在删除后需要从备份还原。
运行以下 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 文件共享的分层文件将被删除。
- 不会删除可访问的分层文件（非孤立文件）。
- 非分层文件将保留在服务器上。
可选：如果在步骤 3 中删除了服务器终结点，请重新创建。
选项 2：装载 Azure 文件共享，并在本地复制服务器上孤立的文件
此选项不需要删除服务器终结点，但需要足够的磁盘空间，以在本地复制完整文件。
在包含孤立分层文件的 Windows Server 上装载 Azure 文件共享。
运行以下 PowerShell 命令以列出孤立的分层文件：
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll" $orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path> $orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt使用OrphanTieredFiles.txt输出文件标识服务器上的孤立分层文件。
通过将完整文件从 Azure 文件共享复制到 Windows Server 来覆盖孤立的分层文件。
如何对服务器上意外重新调用文件的问题进行故障排除
读取大量文件的防病毒、备份和其他应用程序会导致意外的重新调用，除非这些应用程序遵循脱机属性并跳过读取这些文件的内容。 跳过支持此选项的产品的脱机文件可帮助避免在执行防病毒软件扫描或备份作业等操作时出现意外的重新调用。
请咨询软件供应商，了解如何配置其解决方案以跳过读取脱机文件。
意外的召回率也可能在其他方案中发生，例如，在文件资源管理器中浏览云分层文件时。 如果文件夹包含可执行文件，此结果可能在 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 反馈社区。