Azure 文件同步代理 v21.2 版本 - 2025 年 7 月

已修复的改进和问题 

Azure 文件同步代理现已通过 Arc 扩展提供

通过 Azure arc 连接的 Windows 服务器现在可以使用名为 Azure 文件同步 Agent for Windows 的新扩展安装 Azure 文件同步 代理。 新扩展由 Microsoft 发布，可以使用 Azure 门户、PowerShell 或 Azure CLI 进行管理。 若要了解详细信息，请参阅 Azure 文件同步 代理扩展文档。

正式发布：意大利北部的Azure 文件同步 

向意大利北部的扩展使该服务更接近这些地区的组织，从而提供更低的延迟、更好的性能，并支持本地数据驻留要求。  

适用于Azure 文件同步的粒度 Role-Based 访问控制 (RBAC)  

Azure 文件同步现在包括两个专用的内置 RBAC 角色Azure 文件同步管理员和Azure 文件同步读取者，旨在增强安全性并简化管理本地和云环境之间的文件同步的组织的作。 与所有者或参与者等更广泛的角色相比，这些角色提供更精细的访问控制，使组织能够更有效地实施最小特权原则。

云分层和同步的其他可靠性和遥测改进

修复了在文件或文件夹路径包含尾随点时导致同步下载和云分层失败的问题，错误代码0x80c80362 (ECS_E_ITEM_PATH_COMPONENT_HAS_ TRAILING_DOT) 。 以前，用户必须手动重命名受影响的项才能恢复同步。 Azure 文件同步现在正确处理带有尾随点的路径组件，无需手动干预。

有关 Azure 文件同步 代理 v21.2 版本的详细信息 

• 此版本适用于 Windows Server 2016、Windows Server 2019、Windows Server 2022 和 Windows Server 2025 安装。 

• 此版本的代理版本为 21.2.0.0。 

• 必须在Windows Server上安装以下更新：

  • WS 2016 Microsoft 更新目录 (最新的累积更新)

  • WS 2019 Microsoft 更新目录 (最新的累积更新)

​​​​​​​累积更新每月发布一次。 若要部署最新的更新目录，用户可以使用Windows 更新或手动从Microsoft更新目录下载它。 如果手动安装，他们应查看关联的知识库文章，以确保满足所有先决条件。

注意：如果在安装 Azure 文件同步 代理之前未安装 Windows 汇报，则存储同步代理服务 (FileSyncSvc) 将无法启动。 若要了解详细信息，请参阅Azure 文件同步故障排除文档。 

如何获取和安装 Azure 文件同步 代理

 Azure 文件同步代理可从Microsoft更新、Microsoft更新目录和Microsoft下载中心获取。 

注意 

• 如果服务器上当前未安装 Azure 文件同步 代理，请使用 Microsoft 下载中心上的代理安装包。 Microsoft更新和Microsoft更新目录上的代理安装包仅用于代理升级。

• 若要更新现有代理安装，请运行位于代理安装目录中) AfsUpdater.exe (，或者从 Microsoft 更新或Microsoft更新目录中下载并安装更新。

Microsoft 更新 

若要从 Microsoft Update 获取并安装，请在安装了 Azure 文件同步 代理的服务器上执行以下步骤： 

1. 单击“开始”，然后单击“设置”。

2. 在“设置”中，单击“更新 & 安全性”。

3. 在“Windows 更新”窗口中，单击“联机检查Microsoft更新中的更新”。

4. 验证是否已列出Azure 文件同步代理更新，然后单击“立即安装”。

Microsoft 更新目录 

转到以下网站，从Microsoft更新目录手动下载此更新： 

Azure 文件同步代理 v21.2 版本 - 2025 年 7 月 (KB5063825)

若要手动安装更新包，请提取 cab 文件，并从提升的命令提示符运行以下命令： 

msiexec.exe /p packagename.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent，StorageSyncAgentAzureFileSync，StorageSyncAgentGuardFilter，StorageSyncAgentUpdater /qb /l*v KB5063825.log

例如，若要为 Server 2016 安装 Azure 文件同步 代理更新，请运行以下命令： 

msiexec.exe /p StorageSyncAgent_WS2016_KB 5063825.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent，StorageSyncAgentAzureFileSync，StorageSyncAgentGuardFilter，StorageSyncAgentUpdater /qb /l*v KB5063825.log

Microsoft 下载中心 

转到 Microsoft下载中心，手动下载新代理安装的代理安装包。 

如何为新代理安装执行无提示安装 

若要对使用默认设置的新代理安装执行无提示安装，请在提升的命令提示符处运行以下命令： 

msiexec /i packagename.msi /qb /l*v AFSv21.2Installation.log 

例如，若要为 Windows Server 2016 安装 Azure 文件同步 代理，请运行以下命令： 

msiexec /i StorageSyncAgent_WS2016.msi /qb /l*v AFSv21.2Installation.log 

注意 

如果需要，可以使用 /qb 开关 () 、代理更新和服务器注册屏幕显示重启提示。 若要禁止显示屏幕并根据需要) 自动重启服务器 (，请使用 /qn 开关。

若要使用自定义设置执行无提示安装，请参阅如何以无提示方式安装 Azure 文件同步 代理。