本文介绍日期为 2025 年 2 月的 Azure 文件同步 代理 v20 版本中修复的改进和问题。 此外，本文包含此版本的安装说明。
已修复的改进和问题
正式发布：对Azure 文件同步服务和服务器的托管标识支持
Azure 文件同步现在支持系统分配的托管标识进行身份验证，无需共享密钥，并使用Microsoft Entra ID简化安全管理。 在此版本中，可以直接从 Azure 门户配置托管标识，使部署更加轻松和安全。
配置托管标识后，系统分配的托管标识将用于以下方案：
-
到 Azure 文件共享的存储同步服务身份验证
-
已注册到 Azure 文件共享的服务器身份验证
-
向存储同步服务注册服务器身份验证
有关详细信息，请参阅：如何将托管标识与Azure 文件同步配合使用。
注意： 在未来几周内，正式版的门户体验将逐步推广到所有区域。
云分层和同步的其他可靠性和遥测改进
有关 Azure 文件同步 代理 v20 版本的详细信息
-
此版本适用于 Windows Server 2016、Windows Server 2019、Windows Server 2022 和 Windows Server 2025 安装。
-
此版本的代理版本为 20.0.0.0。
-
必须在Windows Server上安装以下更新：
注意：如果在安装 Azure 文件同步 代理之前未安装 Windows 汇报，则存储同步代理服务 (FileSyncSvc) 将无法启动。 若要了解详细信息，请参阅Azure 文件同步故障排除文档。
如何获取和安装 Azure 文件同步 代理
Azure 文件同步代理可从Microsoft更新、Microsoft更新目录和Microsoft下载中心获取。
注意
-
如果服务器上当前未安装 Azure 文件同步 代理，请使用 Microsoft 下载中心上的代理安装包。 Microsoft更新和Microsoft更新目录上的代理安装包仅用于代理升级。
-
若要更新现有代理安装，请运行位于代理安装目录中) AfsUpdater.exe (，或者从 Microsoft 更新或Microsoft更新目录中下载并安装更新。
Microsoft 更新
若要从 Microsoft Update 获取并安装，请在安装了 Azure 文件同步 代理的服务器上执行以下步骤：
-
单击“开始”，然后单击“设置”。
-
在“设置”中，单击“更新 & 安全性”。
-
在“Windows 更新”窗口中，单击“联机检查Microsoft更新中的更新”。
-
验证是否已列出Azure 文件同步代理更新，然后单击“立即安装”。
Microsoft 更新目录
转到以下网站，从Microsoft更新目录手动下载此更新：
Azure 文件同步代理 v20 版本：2025 年 2 月 (KB5041884)
若要手动安装更新包，请提取 cab 文件，并从提升的命令提示符运行以下命令：
msiexec.exe /p packagename.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent，StorageSyncAgentAzureFileSync，StorageSyncAgentGuardFilter，StorageSyncAgentUpdater /qb /l*v KB5041884.log
例如，若要为 Server 2016 安装 Azure 文件同步 代理更新，请运行以下命令：
msiexec.exe /p StorageSyncAgent_WS2016_KB5041884.msp 重新安装MODE=OMUS 重新安装=StorageSyncAgent，StorageSyncAgentAzureFileSync，StorageSyncAgentGuardFilter，StorageSyncAgentUpdater /qb /l*v KB5041884.log
Microsoft 下载中心
转到 Microsoft下载中心 ，手动下载新代理安装的代理安装包。
如何为新代理安装执行无提示安装
若要对使用默认设置的新代理安装执行无提示安装，请在提升的命令提示符处运行以下命令：
msiexec /i packagename.msi /qb /l*v AFSv20Installation.log
例如，若要为 Windows Server 2016 安装 Azure 文件同步 代理，请运行以下命令：
msiexec /i StorageSyncAgent_WS2016.msi /qb /l*v AFSv20Installation.log
注意
-
如果需要，可以使用 /qb 开关 () 、代理更新和服务器注册屏幕显示重启提示。 若要禁止显示屏幕并根据需要) 自动重启服务器 (，请使用 /qn 开关。
-
若要使用自定义设置执行无提示安装，请参阅如何以无提示方式安装 Azure 文件同步 代理。
