排查Azure 文件同步同步运行状况和错误

项目
04/11/2024

本文旨在帮助排查和解决Azure 文件同步部署时可能会遇到的常见同步问题。

同步运行状况

如果我通过 SMB 或通过门户直接在 Azure 文件共享中创建文件，该文件需要多长时间才能同步到同步组中的服务器？

使用 Azure 门户或 SMB 对 Azure 文件共享所做的更改不会立即检测和复制，就像对服务器终结点所做的更改一样。 Azure 文件存储尚没有更改通知或日记，因此无法在文件更改时自动启动同步会话。在 Windows Server 上，Azure 文件同步使用 Windows USN 日记功能在文件更改时自动启动同步会话。

若要检测对 Azure 文件共享的更改，Azure 文件同步有一个名为更改检测作业的计划作业。更改检测作业枚举文件共享中的每个文件，然后将其与该文件的同步版本进行比较。更改检测作业确定文件已更改时，Azure 文件同步启动同步会话。更改检测作业每 24 小时启动一次。由于更改检测作业的工作原理是枚举 Azure 文件共享中的每个文件，因此更改检测在较大的命名空间中花费的时间比在较小的命名空间中花费的时间更长。对于大型命名空间，可能需要超过每 24 小时一次的时间来确定哪些文件已更改。

若要立即同步 Azure 文件共享中更改的文件， Invoke-AzStorageSyncChangeDetection 可以使用 PowerShell cmdlet 手动启动 Azure 文件共享中更改的检测。此 cmdlet 适用于以下情况：某些类型的自动化过程正在 Azure 文件共享中进行更改，或者由管理员 (（例如将文件和目录移动到共享) ）进行更改。对于最终用户更改，建议在 IaaS VM 中安装 Azure 文件同步代理，并让最终用户通过 IaaS VM 访问文件共享。这样，所有更改将快速同步到其他代理，而无需使用 Invoke-AzStorageSyncChangeDetection cmdlet。若要了解详细信息，请参阅 Invoke-AzStorageSyncChangeDetection 文档。

我们正在探索为 Azure 文件共享添加更改检测，类似于 Windows Server 上的卷的 USN。通过在 Azure 社区反馈中投票支持此功能，帮助我们确定此功能的优先级，以便将来的开发。

服务器终结点运行状况处于挂起状态数小时

如果创建云终结点并使用包含数据的 Azure 文件共享，则会出现此问题。必须先完成扫描 Azure 文件共享中更改的云更改枚举作业，然后文件才能在云终结点和服务器终结点之间同步。完成作业的时间取决于 Azure 文件共享中命名空间的大小。更改枚举作业完成后，服务器终结点运行状况应更新。

若要检查云更改枚举作业的状态，请转到门户中的“云终结点”属性，并在“更改枚举”部分提供状态。

若要在门户中查看服务器终结点的运行状况，请导航到存储同步服务的“同步组”部分，然后选择同步组。

正常状态和持续同步错误计数为 0 表示同步按预期工作。如果持久同步错误的计数大于 0，请参阅如何实现查看是否有特定文件或文件夹未同步，以排查文件无法同步的原因。如果服务器终结点的“运行状况”状态为“正常”，请遵循下表中的指南。

运行状况状态	说明	修复
Healthy	同步会话成功完成，或者正在进行同步会话 () 应用文件。	不适用
Pending	创建服务器终结点后，预期会出现“挂起”状态。将服务器终结点的同步遥测发送到服务后，运行状况状态将更新。	如果运行状况状态在几个小时内未更改，请参阅服务器终结点运行状况在数小时内处于挂起状态。
错误	同步会话失败并出现错误。	若要解决此问题，请在门户中选择 “错误状态”以获取错误代码和修正步骤。如果门户中未列出修正步骤或未解决问题，请在此文档中搜索错误代码以获取更多指导。
无活动	在过去两小时内，存储同步服务未收到来自此服务器终结点的同步遥测数据。	若要解决此问题，请按照排查Azure 文件同步同步组管理问题中的步骤操作。
低磁盘模式	服务器终结点所在的卷磁盘空间不足。	若要解决此问题，请释放卷上的磁盘空间。若要详细了解磁盘空间不足模式，请参阅云分层概述。
预配已取消	服务器终结点创建失败。同步在此服务器终结点上不起作用。	若要解决此问题，请参阅服务器终结点创建和删除错误。

注意

服务器终结点状态 (运行状况和活动) 每 15 分钟刷新一次，并且基于从服务器发送到服务的遥测事件。

查看服务器上遥测日志中的最新 9102 事件 (事件查看器，转到“应用程序和服务日志\Microsoft\FileSync\Agent\Telemetry) ”。完成同步会话后，将记录此事件。 SyncDirection 告知此会话是上传还是下载。 HResult如果为 0，则同步会话成功。非零 HResult 表示同步期间出现错误;有关常见错误列表，请参阅下文。 PerItemErrorCount如果大于 0，则表示某些文件或文件夹未正确同步。可以将一个 HResult 设置为 0，但 PerItemErrorCount 大于 0 的。

下面是成功上传的示例。为简洁起见，仅列出了每个 9102 事件中包含的部分值。

Replica Sync session completed.
SyncDirection: Upload,
HResult: 0, 
SyncFileCount: 2, SyncDirectoryCount: 0,
AppliedFileCount: 2, AppliedDirCount: 0, AppliedTombstoneCount 0, AppliedSizeBytes: 0.
PerItemErrorCount: 0,
TransferredFiles: 2, TransferredBytes: 0, FailedToTransferFiles: 0, FailedToTransferBytes: 0.

相反，上传失败可能如下所示：

Replica Sync session completed.
SyncDirection: Upload,
HResult: -2134364065,
SyncFileCount: 0, SyncDirectoryCount: 0, 
AppliedFileCount: 0, AppliedDirCount: 0, AppliedTombstoneCount 0, AppliedSizeBytes: 0.
PerItemErrorCount: 0, 
TransferredFiles: 0, TransferredBytes: 0, FailedToTransferFiles: 0, FailedToTransferBytes: 0.

有时，同步会话总体失败或非零 PerItemErrorCount ，但仍向前推进，某些文件同步成功。可以通过查看应用字段 (AppliedFileCount、 AppliedDirCount、 AppliedTombstoneCount和 AppliedSizeBytes) 来确定进度。这些字段描述了会话成功次数。如果在一行中看到多个同步会话失败，但应用计数不断增加，则应在打开支持票证之前提供同步时间重试。

如何实现监视当前同步会话的进度？

门户
服务器

在同步组中，转到服务器终结点属性，并查看 “同步状态 ”部分，查看在当前同步会话中上传或下载的文件计数。此状态将延迟约 15 分钟。如果同步会话足够小，可以在这段时间内完成，则可能不会在门户中报告该会话。

注意

如果 “估计完成时间 ”为空，则表示同步尚未完成对同步会话中的文件数的计数。

查看服务器上的遥测日志中的最新 9302 事件 (事件查看器，转到“应用程序和服务日志\Microsoft\FileSync\Agent\Telemetry) ”。此事件指示当前同步会话的状态。 TotalItemCount 表示要同步的文件数， AppliedItemCount 表示到目前为止已同步的文件数，并 PerItemErrorCount 表示无法同步的文件数 (请参阅以下内容，了解如何处理此) 。

Replica Sync Progress. 
ServerEndpointName: <CI>sename</CI>, SyncGroupName: <CI>sgname</CI>, ReplicaName: <CI>rname</CI>, 
SyncDirection: Upload, CorrelationId: {AB4BA07D-5B5C-461D-AAE6-4ED724762B65}. 
AppliedItemCount: 172473, TotalItemCount: 624196. AppliedBytes: 51473711577, 
TotalBytes: 293363829906. 
AreTotalCountsFinal: true. 
PerItemErrorCount: 1006.

如何实现知道我的服务器是否彼此同步？

门户
服务器

对于给定同步组中的每个服务器，请确保：

“上传到云”和“下载到服务器”的时间戳是最新的。
上传和下载的状态都为绿色。
服务器终结点属性中的 “同步状态 ”部分显示极少数或根本没有要同步的文件。
服务器终结点属性中的 “持久同步错误 ”和“ 暂时性同步错误 ”字段的计数为 0。

查看已完成的同步会话（在事件查看器中每个服务器的遥测事件日志中标有 9102 个事件 (），转到“应用程序和服务日志\Microsoft\FileSync\Agent\Telemetry) ”。

在任何给定服务器上，你希望确保成功完成最新的上传和下载会话。

为此，检查HResult，和 PerItemErrorCount 为 0 表示上传和下载， (SyncDirection 字段指示给定会话是上传会话还是下载会话) 。请注意，如果未看到最近完成的同步会话，则可能当前正在进行同步会话，这是预期，如果刚刚添加或修改了大量数据。
当服务器与云完全保持最新状态，并且没有更改可双向同步时，你将看到空的同步会话。这些由上传和下载事件指示，其中 (SyncFileCount、 SyncDirCount、 SyncTombstoneCount和 SyncSizeBytes) 的所有 Sync* 字段均为零，这意味着没有要同步的内容。请注意，这些空同步会话可能不会在高改动服务器上发生，因为总有一些新内容需要同步。如果没有同步活动，则应每隔 30 分钟发生一次。
如果所有服务器都是最新的云服务器，这意味着其最近的上传和下载会话都是空同步会话，则可以合理确定整个系统处于同步状态。

如果直接在 Azure 文件共享中进行更改，Azure 文件同步在更改枚举运行（每 24 小时发生一次）之前不会检测到这些更改。当服务器实际上缺少直接在 Azure 文件共享中做出的最新更改时，服务器可能会说它与云是最新的。

如何实现查看是否有未同步的特定文件或文件夹？

对于任何给定的同步会话，如果门户或PerItemErrorCount服务器上的持久同步错误和暂时性同步错误计数大于 0，则表示某些项目无法同步。文件和文件夹可能具有阻止它们同步的特征。这些特征可能是永久性的，需要显式操作才能恢复同步，例如从文件或文件夹名称中删除不受支持的字符。它们也可能是暂时性的，这意味着文件或文件夹将自动恢复同步;例如，具有打开句柄的文件将在文件关闭时自动恢复同步。当Azure 文件同步引擎检测到此类问题时，将生成一个错误日志，可以分析该日志以列出当前未正确同步的项。

注意

同步会话完成后，门户中 的持久同步错误 和 暂时性同步错误 计数将更新。如果同步会话正在进行中，请等到同步会话完成并更新 持久同步错误 和 暂时性同步错误 计数，然后调查剩余错误。

若要查看无法同步的文件和目录的名称，请在Azure 文件同步代理) 的代理安装目录中运行FileSyncErrorsReport.ps1PowerShell 脚本 (或使用 Debug-StorageSyncServer cmdlet。字段 ItemPath 告知文件相对于根同步目录的位置。有关修正步骤，请参阅常见每项错误列表。

若要使用 Debug-StorageSyncServer cmdlet 识别无法在服务器上同步的文件，请运行以下 PowerShell 命令：

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

注意

如果 FileSyncErrorsReport.ps1 脚本返回“未找到文件错误”或未列出同步组的每个项错误，则原因如下：

原因 1：上次完成的同步会话没有每个项的错误。门户应很快更新，以显示“0 个文件未同步”。默认情况下， FileSyncErrorsReport.ps1 脚本仅显示上次完成的同步会话的每个项目错误。若要查看所有同步会话的每个项错误，请使用 -ReportAllErrors 参数。检查遥测事件日志中最新的事件 ID 9102 ，以确认 PerItemErrorCount 为 0。
原因 2： ItemResults 服务器上由于每个项错误过多而包装的事件日志，并且事件日志不再包含此同步组的错误。若要防止此问题，请 ItemResults 增加事件日志大小。可以在 ItemResults 事件查看器 中的“应用程序和服务日志\Microsoft\FileSync\代理”下找到事件日志。

同步错误

排查每个文件/目录同步错误

如果文件或目录因错误而无法同步，则会在 Microsoft-FileSync-Agent/ItemResults 事件日志中记录事件。本部分介绍针对每个项目错误的常见错误代码和修正步骤。

注意

如果文件或目录无法同步，最长可能需要 30 分钟才能Azure 文件同步重试同步该项目。如果在服务器终结点位置中未检测到任何更改，Azure 文件同步每隔 30 分钟启动一个同步会话。若要强制同步会话，请重启存储同步代理 (FileSyncSvc) 服务，或者对服务器终结点位置中的文件或目录进行更改。

ItemResults 事件日志中记录的常见每项同步错误

HRESULT	HRESULT (十进制)	错误字符串	问题	修复
0x80070043	-2147942467	ERROR_BAD_NET_NAME	无法访问服务器上的分层文件。如果在删除服务器终结点之前未召回分层文件，则会出现此问题。	若要解决此问题，请参阅删除服务器终结点后无法在服务器上访问分层文件。
0x80c80207	-2134375929	ECS_E_SYNC_CONSTRAINT_CONFLICT	文件或目录更改尚无法同步，因为依赖文件夹尚未同步。此项将在从属更改同步后同步。	暂时性错误。如果错误持续数天，请创建支持请求。
0x80C8028A	-2134375798	ECS_E_SYNC_CONSTRAINT_CONFLICT_ON_FAILED_DEPENDEE	文件或目录更改尚无法同步，因为依赖文件夹尚未同步。此项将在从属更改同步后同步。	暂时性错误。如果错误仍然存在，请使用 FileSyncErrorsReport.ps1 PowerShell 脚本来确定依赖文件夹尚未同步的原因。
0x80c80284	-2134375804	ECS_E_SYNC_CONSTRAINT_CONFLICT_SESSION_FAILED	文件或目录更改尚无法同步，因为依赖文件夹尚未同步且同步会话失败。此项将在从属更改同步后同步。	无需执行任何操作。如果错误仍然存在，请调查同步会话失败。
0x8007007b	-2147024773	ERROR_INVALID_NAME	文件或目录名称无效。	重命名有问题的文件或目录。有关详细信息，请参阅处理不受支持的字符。
0x80070459	-2147023783	ERROR_NO_UNICODE_TRANSLATION	文件或目录名称具有不支持的代理项对字符。	重命名有问题的文件或目录。有关详细信息，请参阅处理不受支持的字符。
0x80c80255	-2134375851	ECS_E_XSMB_REST_INCOMPATIBILITY	文件或目录名称无效。	重命名有问题的文件或目录。有关详细信息，请参阅处理不受支持的字符。
0x80c80018	-2134376424	ECS_E_SYNC_FILE_IN_USE	无法同步文件，因为它正在使用中。该文件在不再使用时将同步。	无需执行任何操作。 Azure 文件同步每天在服务器上创建一次临时 VSS 快照，以同步具有打开句柄的文件。
0x80c8031d	-2134375651	ECS_E_CONCURRENCY_CHECK_FAILED	文件已更改，但同步尚未检测到更改。检测到此更改后，同步将恢复。	无需执行任何操作。
0x80070002	-2147024894	ERROR_FILE_NOT_FOUND	文件已被删除，同步不知道更改。	无需执行任何操作。一旦更改检测检测到文件已删除，同步将停止记录此错误。
0x80070003	-2147024893	ERROR_PATH_NOT_FOUND	无法同步删除文件或目录，因为项目已在目标中删除，并且同步不知道更改。	无需执行任何操作。在目标上运行更改检测并同步检测到项目已删除后，同步将停止记录此错误。
0x80c80205	-2134375931	ECS_E_SYNC_ITEM_SKIP	文件或目录已跳过，但将在下一个同步会话期间同步。如果在下载项目时报告此错误，则文件或目录名称很可能无效。	如果在上传文件时报告此错误，则无需执行任何操作。如果在下载文件时报告了错误，请重命名有问题的文件或目录。有关详细信息，请参阅处理不受支持的字符。
0x800700B7	-2147024713	ERROR_ALREADY_EXISTS	无法同步创建文件或目录，因为项目已存在于目标中，并且同步无法识别更改。	无需执行任何操作。一旦更改检测在目标上运行并且同步知道此新项目，同步将停止记录此错误。
0x80c8603e	-2134351810	ECS_E_AZURE_STORAGE_SHARE_SIZE_LIMIT_REACHED	无法同步文件，因为已达到 Azure 文件共享限制。	若要解决此问题，请参阅故障排除指南中的“已达到 Azure 文件共享存储限制 ”部分。
0x80c83008	-2134364152	ECS_E_CANNOT_CREATE_AZURE_STAGED_FILE	无法同步文件，因为已达到 Azure 文件共享限制。	若要解决此问题，请参阅故障排除指南中的“已达到 Azure 文件共享存储限制 ”部分。
0x80c8027C	-2134375812	ECS_E_ACCESS_DENIED_EFS	该文件由不支持的解决方案 (（如 NTFS EFS) ）加密。	解密文件并使用支持的加密解决方案。有关支持解决方案的列表，请参阅规划指南的加密部分。
0x80c80283	-2160591491	ECS_E_ACCESS_DENIED_DFSRRO	该文件位于 DFS-R 只读复制文件夹中。	文件位于 DFS-R 只读复制文件夹中。 Azure 文件同步不支持 DFS-R 只读复制文件夹上的服务器终结点。有关详细信息，请参阅规划指南。
0x80070005	-2147024891	ERROR_ACCESS_DENIED	该文件具有删除挂起状态。	无需执行任何操作。关闭所有打开的文件句柄后，将删除文件。
0x80c86044	-2134351804	ECS_E_AZURE_AUTHORIZATION_FAILED	无法同步文件，因为存储帐户上的防火墙和虚拟网络设置已启用，并且服务器无权访问存储帐户。	按照部署指南中的配置防火墙和虚拟网络设置部分中所述的步骤添加服务器 IP 地址或虚拟网络。
0x8000ffff	-2147418113	E_UNEXPECTED	由于意外错误，无法同步文件。	如果错误持续数天，请创建支持案例。
0x80070020	-2147024864	ERROR_SHARING_VIOLATION	无法同步文件，因为它正在使用中。该文件在不再使用时将同步。	无需执行任何操作。
0x80c80017	-2134376425	ECS_E_SYNC_OPLOCK_BROKEN	文件在同步期间已更改，因此需要再次同步。	无需执行任何操作。
0x80070017	-2147024873	ERROR_CRC	由于 CRC 错误，无法同步文件。如果在删除服务器终结点之前未召回分层文件，或者该文件已损坏，则会发生此错误。	若要解决此问题，请参阅删除服务器终结点后无法在服务器上访问分层文件，以删除孤立的分层文件。如果在删除孤立的分层文件后继续发生错误，请在卷上运行 chkdsk 。
0x80c80200	-2134375936	ECS_E_SYNC_CONFLICT_NAME_EXISTS	无法同步文件，因为已达到冲突文件的最大数目。 Azure 文件同步支持每个文件 100 个冲突文件。若要了解有关文件冲突的详细信息，请参阅Azure 文件同步常见问题解答。	若要解决此问题，请减少冲突文件的数量。冲突文件数小于 100 后，该文件将同步。
0x80c8027d	-2134375811	ECS_E_DIRECTORY_RENAME_FAILED	无法同步目录的重命名，因为目录中的文件或文件夹具有打开的句柄。	无需执行任何操作。关闭目录中所有打开的文件句柄后，将同步目录的重命名。
0x800700de	-2147024674	ERROR_BAD_FILE_TYPE	服务器上的分层文件不可访问，因为它引用了 Azure 文件共享中不再存在的文件版本。	如果已从 Windows Server 的备份还原分层文件，则可能会出现此问题。若要解决此问题，请从 Azure 文件共享中的快照还原文件。
0x80C80065	-2134376347	ECS_E_DATA_TRANSFER_BLOCKED	该文件已被识别为在同步期间产生永久性错误。因此，在达到重试间隔之前，会阻止同步。稍后将重试该文件。	无需执行任何操作。该文件将在 24 小时后重试。如果错误持续数天，请创建支持请求。
0x80C80203	-2134375933	ECS_E_SYNC_INVALID_STAGED_FILE	文件传输错误。服务稍后将重试。	无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。
0x80c8027f	-2134375809	ECS_E_SYNC_CONSTRAINT_CONFLICT_CYCLIC_DEPENDENCY	同步会话超时错误。	无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。
0x80070035	-2147024843	ERROR_BAD_NETPATH	未找到网络路径。	无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。
0x80071779	-2147018887	ERROR_FILE_READ_ONLY	指定的文件是只读的。	如果错误持续一天以上，请创建支持请求。
0x80070006	-2147024890	ERROR_INVALID_HANDLE	发生了内部错误。	如果错误持续一天以上，请创建支持请求。
0x8007012f	-2147024593	ERROR_DELETE_PENDING	无法打开该文件，因为它正在删除。	无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。
0x80041007	-2147217401	SYNC_E_ITEM_MUST_EXIST	发生了内部错误。	如果错误持续一天以上，请创建支持请求。
0X80C80293	-2134375789	ECS_E_SYNC_INITIAL_SCAN_COMPLETED	同步会话失败，因为初始枚举已完成。下一个会话将涵盖整个命名空间。	无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。
0X80C80342	-2134375614	ECS_E_SYNC_CUSTOM_METADATA_VERSION_NOT_SUPPORTED	同步数据库具有高于支持版本的自定义元数据。	请将文件同步代理升级到最新版本。如果错误在升级代理后仍然存在，请创建支持请求。

处理不受支持的字符

Azure 文件同步代理 v17 支持 NTFS 文件系统支持的所有字符，但无效代理项对除外。

如果门户或 FileSyncErrorsReport.ps1 PowerShell 脚本显示每个项同步错误 (错误代码0x8007007b、0x80c80255或0x80070459) ，则检查服务器上是否安装了 Azure 文件同步代理 v17。如果已安装代理 v17，并且文件仍然由于无效字符而无法同步，请使用 ScanUnsupportedChars 脚本重命名包含不受支持的字符的文件。

常见同步错误

本部分介绍同步会话失败并出现错误的常见错误代码和修正步骤。

同步会话已取消。

错误	代码
[HRESULT]	0x800704c7
HRESULT (十进制)	-2147023673
错误字符串	ERROR_CANCELLED
需要修正	否

同步会话可能会因各种原因而失败，包括服务器正在重启或更新、VSS 快照等。尽管此错误看起来需要跟进，但可以放心地忽略此错误，除非它持续了几个小时。

文件同步会话已被卷快照同步会话取消，该会话每天运行一次，以使用打开的句柄同步文件。

错误	代码
[HRESULT]	0x80c8029c
HRESULT (十进制)	-2134375780
错误字符串	ECS_E_SYNC_CANCELLED_BY_VSS
需要修正	否

无需执行任何操作。此错误应会自动解决。如果错误持续一天以上，请创建支持请求。

无法建立与服务的连接。

错误	代码
[HRESULT]	0x80072ee7
HRESULT (十进制)	-2147012889
错误字符串	WININET_E_NAME_NOT_RESOLVED
需要修正	是

错误	代码
[HRESULT]	0x80c83081
HRESULT (十进制)	-2134364031
错误字符串	ECS_E_HTTP_CLIENT_CONNECTION_ERROR
需要修正	是

错误	代码
[HRESULT]	0x80c8309a
HRESULT (十进制)	-2134364006
错误字符串	ECS_E_AZURE_STORAGE_REMOTE_NAME_NOT_RESOLVED
需要修正	是

错误	代码
[HRESULT]	0xc00000c4
HRESULT (十进制)	-1073741628
错误字符串	UNEXPECTED_NETWORK_ERROR
需要修正	是

错误	代码
[HRESULT]	0x80072ee2
HRESULT (十进制)	-2147012894
错误字符串	WININET_E_TIMEOUT
需要修正	是

每当无法从服务器访问Azure 文件同步服务时，都可能发生此错误。可以通过执行以下步骤来排查此错误：

验证防火墙未阻止 Windows 服务FileSyncSvc.exe 。
验证端口 443 是否对Azure 文件同步服务的传出连接开放。可以使用 cmdlet 执行此操作 Test-NetConnection 。可以在Azure 文件同步代理和防火墙设置文档中找到以下占位符的 URL<azure-file-sync-endpoint>。
```
Test-NetConnection -ComputerName <azure-file-sync-endpoint> -Port 443
```
确保代理配置设置为预期。这可以通过 cmdlet 完成 Get-StorageSyncProxyConfiguration 。有关为Azure 文件同步配置代理配置的详细信息，请参阅Azure 文件同步代理和防火墙设置。
```
$agentPath = "C:\Program Files\Azure\StorageSyncAgent"
Import-Module "$agentPath\StorageSync.Management.ServerCmdlets.dll"
Get-StorageSyncProxyConfiguration
```
Test-StorageSyncNetworkConnectivity使用 cmdlet 检查服务终结点的网络连接。若要了解详细信息，请参阅测试到服务终结点的网络连接。
请与网络管理员联系，获取对网络连接进行故障排除的其他帮助。

注意

还原到Azure 文件同步服务的网络连接后，同步可能不会立即恢复。默认情况下，如果服务器终结点位置中未检测到任何更改，Azure 文件同步将每 30 分钟启动一次同步会话。若要强制同步会话，请重启存储同步代理 (FileSyncSvc) 服务，或者对服务器终结点位置中的文件或目录进行更改。

服务限制了用户请求。

错误	代码
[HRESULT]	0x80c8004c
HRESULT (十进制)	-2134376372
错误字符串	ECS_E_USER_REQUEST_THROTTLED
需要修正	否

无需执行任何操作;服务器将重试。如果此错误持续数小时，请创建支持请求。

同步失败，因为操作已中止

错误	代码
[HRESULT]	0x80c83000
HRESULT (十进制)	-2134364160
错误字符串	ECS_E_OPERATION_ABORTED
需要修正	否

不需要执行任何操作。如果此错误持续数小时，请创建支持请求。

操作已取消。

错误	代码
[HRESULT]	0x80c8308d
HRESULT (十进制)	-2134364019
错误字符串	ECS_E_REQUEST_CANCELLED_EXTERNALLY
需要修正	否

错误	代码
[HRESULT]	0x8013153b
HRESULT (十进制)	-2146233029
错误字符串	COR_E_OPERATIONCANCELED
需要修正	否

无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。

在还原后更改检测完成之前，会阻止同步

错误	代码
[HRESULT]	0x80c83075
HRESULT (十进制)	-2134364043
错误字符串	ECS_E_SYNC_BLOCKED_ON_CHANGE_DETECTION_POST_RESTORE
需要修正	否

不需要执行任何操作。使用 Azure 备份还原云终结点 (文件或文件共享) 时，将阻止同步，直到在 Azure 文件共享上完成更改检测。还原完成后，更改检测会立即运行，持续时间基于文件共享中的文件数。

由于在同步文件夹上还原时启动暂停，文件夹上的同步被阻止。

错误	代码
[HRESULT]	0x80c83058
HRESULT (十进制)	-2134364072
错误字符串	ECS_E_SYNC_BLOCKED_ON_RESTORE
需要修正	否

无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。

同步失败，因为同步数据库已卸载。

错误	代码
[HRESULT]	0x80041295
HRESULT (十进制)	-2147216747
错误字符串	SYNC_E_METADATA_INVALID_OPERATION
需要修正	否

当备份应用程序创建 VSS 快照并卸载同步数据库时，通常会发生此错误。如果此错误持续数小时，请创建支持请求。

同步无法访问云终结点中指定的 Azure 文件共享。

错误	代码
[HRESULT]	0x80c8305f
HRESULT (十进制)	-2134364065
错误字符串	ECS_E_EXTERNAL_STORAGE_ACCOUNT_AUTHORIZATION_FAILED
需要修正	是

错误	代码
[HRESULT]	0x80c86053
HRESULT (十进制)	-2134351789
错误字符串	ECS_E_AZURE_FILE_SHARE_NOT_ACCESSIBLE
需要修正	是

出现此错误的原因是Azure 文件同步代理无法访问 Azure 文件共享，这可能是因为 Azure 文件共享或托管它的存储帐户不再存在。可以通过执行以下步骤来排查此错误：

验证存储帐户是否存在。
确保存在 Azure 文件共享。
确保Azure 文件同步有权访问存储帐户。
验证存储帐户上的 SMB 安全设置 是否允许 SMB 3.1.1 协议版本、 NTLM v2 身份验证和 AES-128-GCM 加密。若要检查存储帐户上的 SMB 安全设置，请参阅 SMB 安全设置。
验证存储帐户上的防火墙和虚拟网络设置是否正确配置 (（如果已启用)

同步失败，因为请求无权执行此操作。

错误	代码
[HRESULT]	0x80c86044
HRESULT (十进制)	-2134351804
错误字符串	ECS_E_AZURE_AUTHORIZATION_FAILED
需要修正	是

发生此错误的原因是，Azure 文件同步代理无权访问 Azure 文件共享。可以通过执行以下步骤来排查此错误：

无法解析使用的存储帐户名称。

错误	代码
[HRESULT]	0x80C83060
HRESULT (十进制)	-2134364064
错误字符串	ECS_E_STORAGE_ACCOUNT_NAME_UNRESOLVED
需要修正	是

检查是否可以从服务器解析存储 DNS 名称。

Test-NetConnection -ComputerName <storage-account-name>.file.core.windows.net -Port 443

验证存储帐户是否存在。
验证存储帐户上的防火墙和虚拟网络设置是否正确配置 (（如果已启用)

注意

访问存储帐户时发生未知错误。

错误	代码
[HRESULT]	0x80c8308a
HRESULT (十进制)	-2134364022
错误字符串	ECS_E_STORAGE_ACCOUNT_UNKNOWN_ERROR
需要修正	是

由于存储帐户锁定，同步失败。

错误	代码
[HRESULT]	0x80c83092
HRESULT (十进制)	-2134364014
错误字符串	ECS_E_STORAGE_ACCOUNT_LOCKED
需要修正	是

发生此错误的原因是存储帐户具有只读资源锁。若要解决此问题，请删除存储帐户上的只读资源锁。

由于同步数据库存在问题，同步失败。

错误	代码
[HRESULT]	0x8e5e044e
HRESULT (十进制)	-1906441138
错误字符串	JET_errWriteConflict
需要修正	是

当Azure 文件同步使用的内部数据库出现问题时，会发生此错误。出现此问题时，请创建支持请求，我们将联系你以帮助你解决此问题。

不支持服务器上安装的 Azure 文件同步代理版本。

错误	代码
[HRESULT]	0x80C8306B
HRESULT (十进制)	-2134364053
错误字符串	ECS_E_AGENT_VERSION_BLOCKED
需要修正	是

如果服务器上安装的 Azure 文件同步代理版本不受支持，则会发生此错误。若要解决此问题，请升级到支持的代理版本。

已达到 Azure 文件共享存储限制。

错误	代码
[HRESULT]	0x80c8603e
HRESULT (十进制)	-2134351810
错误字符串	ECS_E_AZURE_STORAGE_SHARE_SIZE_LIMIT_REACHED
需要修正	是

错误	代码
[HRESULT]	0x80c80249
HRESULT (十进制)	-2134375863
错误字符串	ECS_E_NOT_ENOUGH_REMOTE_STORAGE
需要修正	是

当达到 Azure 文件共享存储限制时，同步会话会失败，并出现以下任一错误;如果为 Azure 文件共享应用配额，或者如果使用量超出 Azure 文件共享的限制，则可能会发生这种情况。有关详细信息，请参阅 Azure 文件共享的当前限制。

导航到存储同步服务中的同步组。
选择同步组中的云终结点。
记下打开的窗格中的 Azure 文件共享名称。选择文件共享名称以打开存储帐户中的文件共享设置页。
选择文件共享以获取“ 概述 ”页上的详细信息。
选择 “编辑配额 ”以验证文件共享配额。除非已指定备用配额，否则配额将与 Azure 文件共享的最大大小匹配。

如果文件共享已满 (使用的容量等于配额) ，请释放文件共享上的空间。解决此问题的一种可能方法是将当前服务器终结点的每个子文件夹设置为其自己的服务器终结点（位于其自己的单独同步组中）。这样，每个子文件夹将同步到单个 Azure 文件共享。

找不到 Azure 文件共享。

错误	代码
[HRESULT]	0x80c86030
HRESULT (十进制)	-2134351824
错误字符串	ECS_E_AZURE_FILE_SHARE_NOT_FOUND
需要修正	是

当无法访问 Azure 文件共享时，会发生此错误。若要进行故障排除，请：

验证存储帐户是否存在。
确保存在 Azure 文件共享。
验证存储帐户上的 SMB 安全设置 是否允许 SMB 3.1.1 协议版本、 NTLM v2 身份验证和 AES-128-GCM 加密。若要检查存储帐户上的 SMB 安全设置，请参阅 SMB 安全设置。

如果删除了 Azure 文件共享，则需要创建新的文件共享，然后重新创建同步组。

此 Azure 订阅暂停时，同步已暂停。

错误	代码
[HRESULT]	0x80C83076
HRESULT (十进制)	-2134364042
错误字符串	ECS_E_SYNC_BLOCKED_ON_SUSPENDED_SUBSCRIPTION
需要修正	是

Azure 订阅暂停时会发生此错误。还原 Azure 订阅后，将重新启用同步。有关详细信息，请参阅为何禁用我的 Azure 订阅以及如何重新激活它？

存储帐户配置了防火墙或虚拟网络。

错误	代码
[HRESULT]	0x80c8033e
HRESULT (十进制)	-2134375618
错误字符串	ECS_E_SERVER_BLOCKED_BY_NETWORK_ACL
需要修正	是

当由于存储帐户防火墙或存储帐户属于虚拟网络而无法访问 Azure 文件共享时，会发生此错误。验证是否已正确配置存储帐户上的防火墙和虚拟网络设置。有关详细信息，请参阅配置防火墙和虚拟网络设置。

由于同步数据库存在问题，同步失败。

错误	代码
[HRESULT]	0x80c80219
HRESULT (十进制)	-2134375911
错误字符串	ECS_E_SYNC_METADATA_WRITE_LOCK_TIMEOUT
需要修正	否

错误	代码
[HRESULT]	0x80c83044
HRESULT (十进制)	-2134364092
错误字符串	ECS_E_SYNC_METADATA_WRITE_LOCK_TIMEOUT_SERVICEUNAVAILABLE
需要修正	否

这些错误通常会自行解决，并且可能出现以下情况：

同步组中服务器中的大量文件更改。
单个文件和目录出现大量错误。

如果此错误持续的时间超过几个小时，请创建支持请求，我们将与你联系以帮助你解决此问题。

同步数据库遇到存储繁忙 IO 错误。

错误	代码
[HRESULT]	0x80c8021f
HRESULT (十进制)	-2134375905
错误字符串	ECS_E_SYNC_METADATA_IO_BUSY
需要修正	否

无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。

同步数据库遇到 IO 超时。

错误	代码
[HRESULT]	0x80c8021e
HRESULT (十进制)	-2134375906
错误字符串	ECS_E_SYNC_METADATA_IO_TIMEOUT
需要修正	否

无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。

同步数据库遇到 IO 错误。

错误	代码
[HRESULT]	0x80c80220
HRESULT (十进制)	-2134375904
错误字符串	ECS_E_SYNC_METADATA_IO_ERROR
需要修正	否

无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。

同步失败，因为数据已损坏且无法读取。

错误	代码
[HRESULT]	0x80071128
HRESULT (十进制)	-2147020504
错误字符串	ERROR_INVALID_REPARSE_DATA
需要修正	是

如果服务器终结点所在的 NTFS 卷上存在文件系统损坏，则会发生此错误。若要解决此错误，请在卷上运行 chkdsk 。

服务器未能建立安全连接。云服务收到了意外的证书。

错误	代码
[HRESULT]	0x800b0109
HRESULT (十进制)	-2146762487
错误字符串	CERT_E_UNTRUSTEDROOT
需要修正	是

如果组织正在使用 TLS 终止代理，或者恶意实体正在截获服务器与Azure 文件同步服务之间的流量，则会发生此错误。如果你确定这是预期 (，因为你的组织正在使用 TLS 终止代理) ，则跳过使用注册表替代的证书验证。

SkipVerifyingPinnedRootCertificate创建注册表值。

New-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Azure\StorageSync -Name SkipVerifyingPinnedRootCertificate -PropertyType DWORD -Value 1

在已注册的服务器上重启同步服务。
```
Restart-Service -Name FileSyncSvc -Force
```

通过设置此注册表值，Azure 文件同步代理将在服务器和云服务之间传输数据时接受任何本地受信任的 TLS/SSL 证书。

同步失败，因为服务器无法解码来自Azure 文件同步服务的响应。

错误	代码
[HRESULT]	0x80072f8f
HRESULT (十进制)	-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 文件同步代理后，PKI URL 用于下载与 Azure 文件同步服务和 Azure 文件共享通信所需的中间证书。 OCSP URL 用于检查证书的状态。如果错误持续数天，请创建支持请求。

由于身份验证问题，同步失败。

错误	代码
[HRESULT]	0x80c80300
HRESULT (十进制)	-2134375680
错误字符串	ECS_E_SERVER_CREDENTIAL_NEEDED
需要修正	是

此错误通常是因为服务器时间不正确。如果服务器在虚拟机中运行，请验证主机上的时间是否正确。

由于证书过期，同步失败。

错误	代码
[HRESULT]	0x80c83078
HRESULT (十进制)	-2134364040
错误字符串	ECS_E_AUTH_SRV_CERT_EXPIRED
需要修正	是

发生此错误的原因是用于身份验证的证书已过期。

若要确认证书已过期，请执行以下步骤：

打开“证书 MMC”管理单元，选择“ 计算机帐户” ，然后导航到“ 证书 (本地计算机) \Personal\Certificates”。
检查客户端身份验证证书是否已过期。

如果客户端身份验证证书已过期，请在服务器上运行以下 PowerShell 命令：

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

由于找不到身份验证证书，同步失败。

错误	代码
[HRESULT]	0x80c80228
HRESULT (十进制)	-2134375896
错误字符串	ECS_E_AUTH_SRV_CERT_NOT_FOUND
需要修正	是

出现此错误的原因是找不到用于身份验证的证书。

若要解决此问题，请在服务器上运行以下 PowerShell 命令：

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

由于找不到身份验证标识，同步失败。

错误	代码
[HRESULT]	0x80c83079
HRESULT (十进制)	-2134364039
错误字符串	ECS_E_AUTH_IDENTITY_NOT_FOUND
需要修正	是

发生此错误的原因是服务器终结点删除失败，并且终结点现在处于部分删除状态。若要解决此问题，请重试删除服务器终结点。

服务器终结点所在的卷磁盘空间不足。

错误	代码
[HRESULT]	0x8e5e0211
HRESULT (十进制)	-1906441711
错误字符串	JET_errLogDiskFull
需要修正	是

错误	代码
[HRESULT]	0x80c8031a
HRESULT (十进制)	-2134375654
错误字符串	ECS_E_NOT_ENOUGH_LOCAL_STORAGE
需要修正	是

同步会话失败并出现以下错误之一，因为卷的磁盘空间不足或达到磁盘配额限制。此错误通常是因为服务器终结点外部的文件占用了卷上的空间。检查服务器上的可用磁盘空间。可以通过添加其他服务器终结点、将文件移动到其他卷或增加服务器终结点所使用卷的大小来释放卷上的空间。如果使用文件服务器资源管理器或 NTFS 配额在卷上配置了磁盘配额，请提高配额限制。

如果为服务器终结点启用了云分层，请验证文件是否同步到 Azure 文件共享，以避免磁盘空间不足。

服务尚未准备好与该服务器终结点同步。

错误	代码
[HRESULT]	0x80c8300f
HRESULT (十进制)	-2134364145
错误字符串	ECS_E_REPLICA_NOT_READY
需要修正	否

发生此错误的原因是云终结点是在 Azure 文件共享上已存在的内容创建的。 Azure 文件同步必须先扫描 Azure 文件共享中的所有内容，然后才允许服务器终结点继续其初始同步。在 Azure 文件共享上完成更改检测后，将开始同步。更改检测可能需要超过 24 小时才能完成，并且与 Azure 文件共享上的文件和目录数成正比。如果配置了云分层，将在同步完成后对文件进行分层。

由于许多单独的文件出现问题，同步失败。

错误	代码
[HRESULT]	0x80c8023b
HRESULT (十进制)	-2134375877
错误字符串	ECS_E_SYNC_METADATA_KNOWLEDGE_SOFT_LIMIT_REACHED
需要修正	是

错误	代码
[HRESULT]	0x80c8021c
HRESULT (十进制)	-2134375908
错误字符串	ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED
需要修正	是

错误	代码
[HRESULT]	0x80c80253
HRESULT (十进制)	-2134375853
错误字符串	ECS_E_TOO_MANY_PER_ITEM_ERRORS
需要修正	是

如果有许多文件无法同步并出现每个项目错误，则同步会话会失败，并显示其中一个错误。执行如何实现查看是否存在未同步的特定文件或文件夹部分中所述的步骤，以解决每个项目的错误。对于同步错误ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED，请打开支持案例。

注意

Azure 文件同步每天在服务器上创建一次临时 VSS 快照，以同步具有打开句柄的文件。

由于服务器终结点路径存在问题，同步失败。

错误	代码
[HRESULT]	0x80c80019
HRESULT (十进制)	-2134376423
错误字符串	ECS_E_SYNC_INVALID_PATH
需要修正	是

确保路径存在，位于本地 NTFS 卷上，并且不是重新分析点或现有服务器终结点。

同步失败，因为筛选器驱动程序版本与代理版本不兼容

错误	代码
[HRESULT]	0x80C80277
HRESULT (十进制)	-2134375817
错误字符串	ECS_E_INCOMPATIBLE_FILTER_VERSION
需要修正	是

出现此错误的原因是，加载的版本 (StorageSync.sys) 云分层筛选器驱动程序与存储同步代理 (FileSyncSvc) 服务不兼容。如果升级了 Azure 文件同步代理，请重启服务器以完成安装。如果错误继续发生，请卸载代理，重启服务器并重新安装Azure 文件同步代理。

该服务当前不可用。

错误	代码
[HRESULT]	0x80c8004b
HRESULT (十进制)	-2134376373
错误字符串	ECS_E_SERVICE_UNAVAILABLE
需要修正	否

发生此错误的原因是Azure 文件同步服务不可用。当Azure 文件同步服务再次可用时，此错误将自动解决。

注意

由于异常，同步失败。

错误	代码
[HRESULT]	0x80131500
HRESULT (十进制)	-2146233088
错误字符串	COR_E_EXCEPTION
需要修正	否

出现此错误的原因是同步由于异常而失败。如果错误持续数小时，请创建支持请求。

同步失败，因为存储帐户已故障转移到另一个区域。

错误	代码
[HRESULT]	0x80c83073
HRESULT (十进制)	-2134364045
错误字符串	ECS_E_STORAGE_ACCOUNT_FAILED_OVER
需要修正	是

发生此错误的原因是存储帐户已故障转移到另一个区域。 Azure 文件同步不支持存储帐户故障转移功能。不应故障转移包含用作 Azure 文件同步中云终结点的 Azure 文件共享的存储帐户。这样做将导致同步停止工作，并且还可能导致意外数据丢失（如果新分层文件）。若要解决此问题，请将存储帐户移动到主要区域。

由于同步数据库的暂时性问题，同步失败。

错误	代码
[HRESULT]	0x80c8020e
HRESULT (十进制)	-2134375922
错误字符串	ECS_E_SYNC_METADATA_WRITE_LEASE_LOST
需要修正	否

发生此错误的原因是同步数据库存在内部问题。同步重试时，此错误将自动解决。如果此错误持续很长时间，请创建支持请求，我们将与你联系以帮助你解决此问题。

由于Microsoft Entra租户中的更改，同步失败

错误	代码
[HRESULT]	0x80c83088
HRESULT (十进制)	-2134364024
错误字符串	ECS_E_INVALID_AAD_TENANT
需要修正	是

验证已安装最新的 Azure 文件同步代理版本，并向 Microsoft.StorageSync 应用程序授予对存储帐户的访问权限 (请参阅确保Azure 文件同步有权访问存储帐户) 。

由于未配置防火墙和虚拟网络异常，同步失败

错误	代码
[HRESULT]	0x80c83096
HRESULT (十进制)	-2134364010
错误字符串	ECS_E_MGMT_STORAGEACLSBYPASSNOTSET
需要修正	是

如果在存储帐户上启用了防火墙和虚拟网络设置，并且未选中“允许受信任的 Microsoft 服务访问此存储帐户”异常，则会发生此错误。若要解决此问题，请按照部署指南中的配置防火墙和虚拟网络设置部分中所述的步骤进行操作。

同步失败，由于存储帐户上的安全设置或服务器上的 NTFS 权限，访问被拒绝。

错误	代码
[HRESULT]	0x80070005
HRESULT (十进制)	-2147024891
错误字符串	ERROR_ACCESS_DENIED
需要修正	是

如果Azure 文件同步由于安全设置而无法访问存储帐户，或者 NT AUTHORITY\SYSTEM 帐户对服务器终结点所在的卷上的“系统卷信息”文件夹没有权限，则会发生此错误。如果单个文件无法与ERROR_ACCESS_DENIED同步，请执行排查每个文件/目录同步错误部分中所述的步骤。

验证存储帐户上的 SMB 安全设置 是否允许 SMB 3.1.1 协议版本、 NTLM v2 身份验证和 AES-128-GCM 加密。若要检查存储帐户上的 SMB 安全设置，请参阅 SMB 安全设置。
验证存储帐户上的防火墙和虚拟网络设置是否正确配置 (（如果已启用)
通过执行以下步骤，验证 NT AUTHORITY\SYSTEM 帐户是否有权访问服务器终结点所在的卷上的 “系统卷信息 ”文件夹：
1. 下载 Psexec 工具。
2. 从提升的命令提示符运行以下命令，使用系统帐户启动命令提示符： PsExec.exe -i -s -d cmd。
3. 在系统帐户下运行的命令提示符下运行以下命令，确认 NT AUTHORITY\SYSTEM 帐户无权访问 “系统卷信息 ”文件夹： cacls "drive letter:\system volume information" /T /C。
4. 如果 NT AUTHORITY\SYSTEM 帐户无权访问 “系统卷信息” 文件夹，请运行以下命令： cacls "drive letter:\system volume information" /T /E /G "NT AUTHORITY\SYSTEM:F"。
  
  如果步骤 d 失败并拒绝访问，请运行以下命令获取 “系统卷信息” 文件夹的所有权，然后重复步骤 d：
  
  takeown /A /R /F "drive letter:\System Volume Information"

同步失败，因为 Azure 文件共享已删除并重新创建。

错误	代码
[HRESULT]	0x80c8027e
HRESULT (十进制)	-2134375810
错误字符串	ECS_E_SYNC_REPLICA_ROOT_CHANGED
需要修正	是

发生此错误的原因是，Azure 文件同步不支持在同一同步组中删除和重新创建 Azure 文件共享。

若要解决此问题，请通过执行以下步骤删除并重新创建同步组：

删除同步组中的所有服务器终结点。
删除云终结点。
删除同步组。
如果在服务器终结点上启用了云分层，请在删除服务器终结点部分后，执行分层文件中所述的步骤，删除服务器上的孤立分层文件。
重新创建同步组。

同步检测到副本 (replica) 已还原到较旧状态

错误	代码
[HRESULT]	0x80c80254
HRESULT (十进制)	-2134375852
错误字符串	ECS_E_SYNC_REPLICA_BACK_IN_TIME
需要修正	否

不需要执行任何操作。出现此错误是因为同步检测到副本 (replica) 已还原到较旧状态。同步现在将进入对帐模式，通过合并 Azure 文件共享的内容和服务器终结点上的数据来重新创建同步关系。触发对帐模式时，该过程可能非常耗时，具体取决于命名空间大小。在对帐完成之前不会进行定期同步，并且与 Azure 文件共享和服务器终结点之间 (上次修改时间或大小) 不同的文件将导致文件冲突。

同步失败，因为 HTTP 请求已重定向

错误	代码
[HRESULT]	0x80190133
HRESULT (十进制)	-2145844941
错误字符串	HTTP_E_STATUS_REDIRECT_KEEP_VERB
需要修正	是

发生此错误的原因是Azure 文件同步不支持 HTTP 重定向 (3xx 状态代码) 。若要解决此问题，请在代理服务器或网络设备上禁用 HTTP 重定向。

同步会话超时错误。

错误	代码
[HRESULT]	0x80c8304a
HRESULT (十进制)	-2134364086
错误字符串	ECS_E_WORK_FRAMEWORK_TIMEOUT
需要修正	否

错误	代码
[HRESULT]	0x80c83049
HRESULT (十进制)	-2134364087
错误字符串	ECS_E_WORK_FRAMEWORK_RESULT_NOT_FOUND
需要修正	否

错误	代码
[HRESULT]	0x80c83093
HRESULT (十进制)	-2134364013
错误字符串	ECS_E_WORK_RESULT_EXPIRED
需要修正	否

无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。

操作超时。

错误	代码
[HRESULT]	0x80131505
HRESULT (十进制)	-2146233083
错误字符串	COR_E_TIMEOUT
需要修正	否

无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。

超时错误。

错误	代码
[HRESULT]	0x80c8600d
HRESULT (十进制)	-2134351859
错误字符串	ECS_E_AZURE_OPERATION_TIME_OUT
需要修正	否

无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。

同步失败，因为在服务器上找不到服务器终结点路径。

错误	代码
[HRESULT]	0x80c8027a
HRESULT (十进制)	-2134375814
错误字符串	ECS_E_SYNC_ROOT_DIRECTORY_NOT_FOUND
需要修正	是

如果用作服务器终结点路径的目录已重命名或删除，则会发生此错误。如果目录已重命名，请将目录重命名回原始名称，并重启存储同步代理服务 (FileSyncSvc) 。

如果删除了目录，请执行以下步骤以删除现有服务器终结点，并使用新路径创建新的服务器终结点：

按照删除服务器终结点中所述的步骤删除同步组中的服务器终结点。
按照添加服务器终结点中所述的步骤，在同步组中创建新的服务器终结点。

由于服务器路径为空，服务器终结点预配失败。

错误	代码
[HRESULT]	0x80C80299
HRESULT (十进制)	-2134375783
错误字符串	ECS_E_SYNC_AUTHORITATIVE_UPLOAD_EMPTY_SET
需要修正	是

如果满足以下条件，则服务器终结点预配失败并显示以下错误代码：

此服务器终结点预配了初始同步模式：服务器权威
本地服务器路径为空或不包含识别为可同步的项目。

此预配错误可防止删除 Azure 文件共享中可能提供的所有内容。服务器权威上传是一种特殊模式，用于通过服务器位置的更新来追赶已种子设定的云位置。查看此迁移指南，了解已为其生成此模式的方案。

按照删除服务器终结点中所述的步骤删除同步组中的服务器终结点。
按照添加服务器终结点中所述的步骤，在同步组中创建新的服务器终结点。

已禁用拥有存储帐户的订阅。

错误	代码
[HRESULT]	0x80c83087
HRESULT (十进制)	-2134364025
错误字符串	ECS_E_STORAGE_ACCOUNT_SUBSCRIPTION_DISABLED
需要修正	是

请检查并确保已启用存储帐户所在的订阅。

指定的网络名称不再可用。

错误	代码
[HRESULT]	0x80070040
HRESULT (十进制)	-2147024832
错误字符串	ERROR_NETNAME_DELETED
需要修正	是

Test-StorageSyncNetworkConnectivity使用 cmdlet 检查服务终结点的网络连接。有关详细信息，请参阅测试到服务终结点的网络连接。

同步会话错误。

错误	代码
[HRESULT]	0x80c8300d
HRESULT (十进制)	-2134364147
错误字符串	ECS_E_CANNOT_CREATE_ACTIVE_SESSION_PLACEHOLDER_BLOB
需要修正	否

错误	代码
[HRESULT]	0x80c8300e
HRESULT (十进制)	-2134364146
错误字符串	ECS_E_CANNOT_UPDATE_REPLICA_WATERMARK
需要修正	否

错误	代码
[HRESULT]	0x80c8024a
HRESULT (十进制)	-2134375862
错误字符串	ECS_E_SYNC_DEFERRAL_QUEUE_RESTART_SESSION
需要修正	否

错误	代码
[HRESULT]	0x80c83098
HRESULT (十进制)	-2134364008
错误字符串	ECS_E_STORAGE_ACCOUNT_MGMT_OPERATION_THROTTLED
需要修正	否

错误	代码
[HRESULT]	0x80c83082
HRESULT (十进制)	-2134364030
错误字符串	ECS_E_ASYNC_WORK_ACTION_UNABLE_TO_RETRY
需要修正	否

错误	代码
[HRESULT]	0x80c83006
HRESULT (十进制)	-2134364154
错误字符串	ECS_E_ECS_BATCH_ERROR
需要修正	否

无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。

同步会话错误。

错误	代码
[HRESULT]	0x80c830a1
HRESULT (十进制)	-2134363999
错误字符串	ECS_TOO_MANY_ETAGVERIFICATION_FAILURES
需要修正	也许

错误	代码
[HRESULT]	0x80c8023c
HRESULT (十进制)	-2134375876
错误字符串	ECS_E_SYNC_CLOUD_METADATA_CORRUPT
需要修正	也许

错误	代码
[HRESULT]
HRESULT (十进制)
错误字符串
需要修正	也许

如果错误持续一天以上，请创建支持请求。

发生内部错误。

错误	代码
[HRESULT]	0x80070057
HRESULT (十进制)	-2147024809
错误字符串	ERROR_INVALID_PARAMETER
需要修正	否

错误	代码
[HRESULT]	0x80c80302
HRESULT (十进制)	-2134375678
错误字符串	ECS_E_UNKNOWN_HTTP_SERVER_ERROR
需要修正	否

错误	代码
[HRESULT]	0x8004100c
HRESULT (十进制)	-2147217396
错误字符串	SYNC_E_DESERIALIZATION
需要修正	否

错误	代码
[HRESULT]	0x80c8022d
HRESULT (十进制)	-2134375891
错误字符串	ECS_E_SYNC_METADATA_UNCOMMITTED_TX_LIMIT_REACHED
需要修正	否

错误	代码
[HRESULT]	0x80c83097
HRESULT (十进制)	-2134364009
错误字符串	ECS_E_QUEUE_CLIENT_EXCEPTION
需要修正	否

错误	代码
[HRESULT]	0x80c80245
HRESULT (十进制)	-2134375867
错误字符串	ECS_E_EPOCH_CHANGE_DETECTED
需要修正	否

错误	代码
[HRESULT]	0x80072ef3
HRESULT (十进制)	-2147012877
错误字符串	WININET_E_INCORRECT_HANDLE_STATE
需要修正	否

无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。

发生内部错误。

错误	代码
[HRESULT]	0x80131509
HRESULT (十进制)	-2146233079
错误字符串	COR_E_INVALIDOPERATION
需要修正	也许

错误	代码
[HRESULT]	0x80070718
HRESULT (十进制)	-2147023080
错误字符串	ERROR_NOT_ENOUGH_QUOTA
需要修正	也许

错误	代码
[HRESULT]	0x80131622
HRESULT (十进制)	-2146232798
错误字符串	COR_E_OBJECTDISPOSED
需要修正	也许

错误	代码
[HRESULT]	0x80004002
HRESULT (十进制)	-2147467262
错误字符串	E_NOINTERFACE
需要修正	也许

错误	代码
[HRESULT]	0x800700a1
HRESULT (十进制)	-2147024735
错误字符串	ERROR_BAD_PATHNAME
需要修正	也许

错误	代码
[HRESULT]	0x8007054f
HRESULT (十进制)	-2147023537
错误字符串	ERROR_INTERNAL_ERROR
需要修正	也许

错误	代码
[HRESULT]	0x80131501
HRESULT (十进制)	-2146233087
错误字符串	COR_E_SYSTEM
需要修正	也许

错误	代码
[HRESULT]	0x80131620
HRESULT (十进制)	-2146232800
错误字符串	COR_E_IO
需要修正	也许

错误	代码
[HRESULT]	0x80070026
HRESULT (十进制)	-2147024858
错误字符串	COR_E_ENDOFSTREAM
需要修正	也许

错误	代码
[HRESULT]	0x80070554
HRESULT (十进制)	-2147023532
错误字符串	ERROR_NO_SUCH_PACKAGE
需要修正	也许

错误	代码
[HRESULT]	0x80131537
HRESULT (十进制)	-2146233033
错误字符串	COR_E_FORMAT
需要修正	也许

错误	代码
[HRESULT]	0x8007001f
HRESULT (十进制)	-2147024865
错误字符串	ERROR_GEN_FAILURE
需要修正	也许

如果错误持续一天以上，请创建支持请求。

发生内部错误。

错误	代码
[HRESULT]	0x80004003
HRESULT (十进制)	-2147467261
错误字符串	E_POINTER
需要修正	是

请升级到最新的文件同步代理版本。如果错误在升级代理后仍然存在，请创建支持请求。

由于身份验证失败，操作失败。

错误	代码
[HRESULT]	0x8007052e
HRESULT (十进制)	-2147023570
错误字符串	ERROR_LOGON_FAILURE
需要修正	也许

错误	代码
[HRESULT]	0x8007051f
HRESULT (十进制)	-2147023585
错误字符串	ERROR_NO_LOGON_SERVERS
需要修正	也许

如果错误持续一天以上，请创建支持请求。

指定的 Azure 帐户处于禁用状态。

错误	代码
[HRESULT]	0x80c86003
HRESULT (十进制)	-2134351869
错误字符串	ECS_E_AZURE_ACCOUNT_IS_DISABLED
需要修正	是

请检查并确保已启用存储帐户所在的订阅。

基于存储帐户密钥的身份验证被阻止。

错误	代码
[HRESULT]	0x80c8307c
HRESULT (十进制)	-2134364036
错误字符串	ECS_E_STORAGE_ACCOUNT_KEY_BASED_AUTHENTICATION_BLOCKED
需要修正	是

在存储帐户上启用“允许存储帐户密钥访问”。了解详细信息。

同步需要更新服务器上的数据库。

错误	代码
[HRESULT]	0x80c8003f
HRESULT (十进制)	-2134376385
错误字符串	ECS_E_SYNC_EPOCH_MISMATCH
需要修正	否

无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。

卷处于脱机状态。删除、未准备就绪或未连接。

错误	代码
[HRESULT]	0x80c87104
HRESULT (十进制)	-2134347516
错误字符串	ECS_E_VOLUME_OFFLINE
需要修正	是

请验证服务器终结点所在的卷是否已附加到服务器。

专用终结点配置访问已阻止。

错误	代码
[HRESULT]	0x80c83099
HRESULT (十进制)	-2134364007
错误字符串	ECS_E_PRIVATE_ENDPOINT_ACCESS_BLOCKED
需要修正	是

检查专用终结点配置并允许访问文件同步服务。了解详细信息。

同步需要先协调服务器和 Azure 文件共享数据，然后才能上传文件。

错误	代码
[HRESULT]	0x80c80248
HRESULT (十进制)	-2134375864
错误字符串	ECS_E_REPLICA_RECONCILIATION_NEEDED
需要修正	否

无需执行任何操作。此错误应会自动解决。如果错误持续数天，请创建支持请求。

不允许同一用户使用多个用户名与服务器或共享资源的多个连接。

错误	代码
[HRESULT]	0x800704c3
HRESULT (十进制)	-2147023677
错误字符串	ERROR_SESSION_CREDENTIAL_CONFLICT
需要修正	是

断开与服务器或共享资源之前的所有连接，然后重试。

服务器的 SSL 证书无效或已过期。

错误	代码
[HRESULT]	0x80c80050
HRESULT (十进制)	-2134376368
错误字符串	ECS_E_SERVER_INVALID_OR_EXPIRED_CERTIFICATE
需要修正	是

在服务器上运行以下 PowerShell 命令以重置证书：

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

常见故障排除步骤

验证存储帐户是否存在。

门户
PowerShell

导航到存储同步服务中的同步组。
选择同步组中的云终结点。
记下打开的窗格中的 Azure 文件共享名称。
选择文件共享名称以打开存储帐户中的文件共享设置页。如果此链接无法打开，则已删除引用的存储帐户。

# Variables for you to populate based on your configuration
$region = "<Az_Region>"
$resourceGroup = "<RG_Name>"
$syncService = "<storage-sync-service>"
$syncGroup = "<sync-group>"

# Log into the Azure account
Connect-AzAccount

# Check to ensure Azure File Sync is available in the selected Azure
# region.
$regions = [System.String[]]@()
Get-AzLocation | ForEach-Object { 
    if ($_.Providers -contains "Microsoft.StorageSync") { 
        $regions += $_.Location 
    } 
}

if ($regions -notcontains $region) {
    throw [System.Exception]::new("Azure File Sync is either not available in the " + `
        " selected Azure Region or the region is mistyped.")
}

# Check to ensure resource group exists
$resourceGroups = [System.String[]]@()
Get-AzResourceGroup | ForEach-Object { 
    $resourceGroups += $_.ResourceGroupName 
}

if ($resourceGroups -notcontains $resourceGroup) {
    throw [System.Exception]::new("The provided resource group $resourceGroup does not exist.")
}

# Check to make sure the provided Storage Sync Service
# exists.
$syncServices = [System.String[]]@()

Get-AzStorageSyncService -ResourceGroupName $resourceGroup | ForEach-Object {
    $syncServices += $_.StorageSyncServiceName
}

if ($syncServices -notcontains $syncService) {
    throw [System.Exception]::new("The provided Storage Sync Service $syncService does not exist.")
}

# Check to make sure the provided Sync Group exists
$syncGroups = [System.String[]]@()

Get-AzStorageSyncGroup -ResourceGroupName $resourceGroup -StorageSyncServiceName $syncService | ForEach-Object {
    $syncGroups += $_.SyncGroupName
}

if ($syncGroups -notcontains $syncGroup) {
    throw [System.Exception]::new("The provided sync group $syncGroup does not exist.")
}

# Get reference to cloud endpoint
$cloudEndpoint = Get-AzStorageSyncCloudEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $syncService `
    -SyncGroupName $syncGroup

# Get reference to storage account
$storageAccount = Get-AzStorageAccount | Where-Object { 
    $_.Id -eq $cloudEndpoint.StorageAccountResourceId
}

if ($storageAccount -eq $null) {
    throw [System.Exception]::new("The storage account referenced in the cloud endpoint does not exist.")
}

确保存在 Azure 文件共享。

门户
PowerShell

在左侧目录上选择“概述”，返回到main存储帐户页。
选择“ 文件” 以查看文件共享列表。
验证云终结点引用的文件共享是否显示在文件共享列表中， (在上述步骤 1 中) 。

$fileShare = Get-AzStorageShare -Context $storageAccount.Context | Where-Object {
    $_.Name -eq $cloudEndpoint.AzureFileShareName -and
    $_.IsSnapshot -eq $false
}

if ($fileShare -eq $null) {
    throw [System.Exception]::new("The Azure file share referenced by the cloud endpoint does not exist")
}

确保Azure 文件同步有权访问存储帐户。

门户
PowerShell

从左侧导航栏 中选择“访问控制 (IAM) ”。
选择“ 角色分配 ”选项卡，列出有权访问存储帐户的用户和应用程序 (服务主体) 。
验证 Microsoft.StorageSync 或混合文件同步服务 (旧应用程序名称) 是否出现在具有读取者和数据访问角色的列表中。

如果列表中未显示 Microsoft.StorageSync 或混合文件同步服务，请执行以下步骤：
- 选择“添加”。
- 在 “角色” 字段中，选择“ 读者和数据访问”。
- 在 “选择” 字段中，键入 Microsoft.StorageSync，选择角色，然后选择“ 保存”。

$role = Get-AzRoleAssignment -Scope $storageAccount.Id | Where-Object { $_.DisplayName -eq "Microsoft.StorageSync" }

if ($role -eq $null) {
    throw [System.Exception]::new("The storage account does not have the Azure File Sync " + `
                "service principal authorized to access the data within the " + ` 
                "referenced Azure file share.")
}

另请参阅

联系我们寻求帮助

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

排查Azure 文件同步同步运行状况和错误

同步运行状况

如何实现监视同步运行状况？

如何实现监视当前同步会话的进度？

如何实现知道我的服务器是否彼此同步？

如何实现查看是否有未同步的特定文件或文件夹？

同步错误

排查每个文件/目录同步错误

处理不受支持的字符

常见同步错误

常见故障排除步骤

另请参阅

联系我们寻求帮助

反馈

反馈

其他资源