Azure 文件同步 代理 v22 - 2025 年 12 月

已修复的改进和问题 

用于监视代理过期Azure 文件同步的新指标 

新的 agentVersionExpiration 指标可让你了解代理到期前还剩多少天。 客户可以配置Azure在代理过期后的 90 天内监视警报，从而启用主动管理并降低意外服务中断的风险。  若要了解详细信息，请参阅Azure 文件同步监视指标图表

正式发布：波兰中部、西班牙中部、新西兰北部和以色列中部的Azure 文件同步

扩展到波兰中部、西班牙中部、新西兰北部和以色列中部，使服务更接近这些地区的组织，提供更低的延迟、更好的性能，并支持本地数据驻留要求。  

软件保障许可证权益

从 2026 年 1 月开始，具有软件保障许可和已启用 Arc 的服务器的组织将获得Azure 文件同步的每服务器定价折扣。 此权益适用于运行代理 V22 或更高版本，为客户提供成本优势。 

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

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

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

• 此版本的代理版本为 22.0.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 文件同步代理 v22 版本 - 2025 年 12 月 (KB5056967)

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

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

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

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

Microsoft 下载中心 

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

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

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

msiexec /i packagename.msi /qb /l*v AFSv22Installation.log 

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

msiexec /i StorageSyncAgent_WS2016.msi /qb /l*v AFSv22Installation.log 

注意 

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

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

​​​​​​​