本文介绍日期为 2025 年 12 月的 Azure 文件同步 代理 v22 版本中修复的改进和问题。 此外，本文包含此版本的安装说明。
已修复的改进和问题
用于监视代理过期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上安装以下更新：
注意：如果在安装 Azure 文件同步 代理之前未安装 Windows 汇报，则存储同步代理服务 (FileSyncSvc) 将无法启动。 若要了解详细信息，请参阅Azure 文件同步故障排除文档。
如何获取和安装 Azure 文件同步 代理
Azure 文件同步 v22 版本当前正被外部测试到服务器，这些服务器配置为在新版本可用时自动更新。 战斗完成后，此更新将在Microsoft更新和Microsoft下载中心提供。 外部测试意味着首先向有限数量的服务器提供版本，并逐渐扩展到更多服务器。 它可能不会立即提供给服务器，即使它配置为在新版本可用时自动更新。 若要立即安装 Azure 文件同步 v20 版本，请从Microsoft更新目录手动下载更新。
若要详细了解Azure 文件同步代理自动更新，请参阅自动代理生命周期管理。
若要获取并安装此更新，请将 Azure 文件同步 代理配置为在新版本可用时自动更新，或者从Microsoft更新目录手动下载更新。
将Azure 文件同步代理配置为在新版本可用时自动更新
代理安装
在Azure 文件同步代理安装过程中，选择“新版本可用时自动更新”设置。
代理后安装
如果已安装代理，请运行以下 PowerShell 命令来配置自动更新：
Import-Module“C：\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll”
Set-StorageSyncAgentAutoUpdate -PolicyMode InstallLatest -Day <day> -Hour <hour>
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_KB5041884.msp REINSTALLMODE=OMUS 重新安装=StorageSyncAgent，StorageSyncAgentAzureFileSync，StorageSyncAgentGuardFilter，StorageSyncAgentUpdater /qb /l*v KB5056967.log
