This article describes the improvements and issues that are fixed in the Azure File Sync Agent v22 release that is dated December 2025. Additionally, this article contains installation instructions for this release.
Improvements and issues that are fixed
New metric to monitor Azure File Sync agent expiration
A new agentVersionExpiration metric provides visibility into how many days remain before an agent reaches expiration. Customers can configure Azure Monitor alerts when an agent is within 90 days of expiry, enabling proactive management and reducing the risk of unexpected service interruptions. To learn more, see Azure File Sync Monitoring Metric Charts
Generally Available: Azure File Sync in Poland Central, Spain Central, and New Zealand North
The expansion into Poland Central, Spain Central, and New Zealand North brings the service closer to organizations in these regions, offering lower latency, better performance, and support for local data residency requirements.
Software Assurance License Benefit
Starting January 2026, organizations with Software Assurance licensing and Arc-enabled servers will receive discounted per-server pricing for Azure File Sync. This benefit applies when running agents V22 or later, providing customers with a cost advantage.
Miscellaneous reliability and telemetry improvements for cloud tiering and sync
More information about the Azure File Sync Agent v22 release
-
This release is available for Windows Server 2016, Windows Server 2019, Windows Server 2022 and Windows Server 2025 installations.
-
The agent version for this release is 22.0.0.0.
-
The following updates must be installed on the Windows Server:
Note: If the Windows Updates are not installed prior to installing the Azure File Sync agent, the Storage Sync Agent service (FileSyncSvc) will fail to start. To learn more, see the Azure File Sync troubleshooting documentation.
How to obtain and install the Azure File Sync Agent
The Azure File Sync v22 release is currently being flighted to servers which are configured to automatically update when a new version becomes available. Once fighting completes, this update will be available on Microsoft Update and Microsoft Download Center. Flighting means the release is offered to a limited number of servers first and expands to more servers gradually. It may not be offered to your server right away even if it’s configured to automatically update when a new version becomes available. To immediately install the Azure File Sync v20 release, manually download the update from the Microsoft Update Catalog.
To learn more about Azure File Sync agent auto-update, see automatic agent lifecycle management.
To obtain and install this update, configure your Azure File Sync agent to automatically update when a new version becomes available or manually download the update from the Microsoft Update Catalog.
Configure your Azure File Sync agent to automatically update when a new version becomes available
Agent installation
During the Azure File Sync agent installation, select the “Automatically update when a new version becomes available” setting.
Post-agent installation
If the agent is already installed, run the following PowerShell commands to configure auto-update:
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Set-StorageSyncAgentAutoUpdate -PolicyMode InstallLatest -Day <day> -Hour <hour>
Microsoft Update Catalog
Go to the following website to manually download this update from the Microsoft Update Catalog:
Azure File Sync Agent v22 release: December 2025 (KB5056967)
To manually install the update package, extract the cab file and run the following command from an elevated command prompt:
msiexec.exe /p packagename.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB5056967.log
For example, to install the Azure File Sync agent update for Server 2016, run the following command:
msiexec.exe /p StorageSyncAgent_WS2016_KB5041884.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB5056967.log
