Azure File Sync Agent v11.2 Release – February 2021

This article describes the improvements and issues that are fixed in the Microsoft Azure File Sync Agent v11.2 release that is dated February 2021. Additionally, this article contains installation instructions for this release.

Improvements and issues that are fixed

  • If a sync session is canceled because of a high number of per-item errors, sync may go through reconciliation when a new session starts if the Azure File Sync service determines that a custom sync session is required to correct the per-item errors.

  • Registering a server by using the Register-AzStorageSyncServer cmdlet may fail and return an "Unhandled Exception" error message.

  • Added: A new PowerShell cmdlet (Add-StorageSyncAllowedServerEndpointPath) to configure allowed server endpoints paths on a server. This cmdlet is useful for scenarios in which the Azure File Sync deployment is managed by a Cloud Solution Provider (CSP) or Service Provider, and the customer wants to configure allowed server endpoints paths on a server. When you create a server endpoint, if the path specified is not in the allow list, the server endpoint creation fails.

    Note This is an optional feature. All supported paths are allowed by default when you create a server endpoint.

    • To add a server endpoint path that’s allowed, run the following PowerShell commands on the server:

      Import-Module 'C:\Program

      Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll' -verbose

      Add-StorageSyncAllowedServerEndpointPath -Path <path>

    • To get the list of supported paths, run the following PowerShell command:

      Get-StorageSyncAllowedServerEndpointPath

    • To remove a path, run the following PowerShell command:

      Remove-StorageSyncAllowedServerEndpointPath -Path <path>

More information about the Azure File Sync Agent v11.2 release

  • This update is available for Windows Server 2012 R2, Windows Server 2016, and Windows Server 2019 installations.

  • Azure File Sync agent version 4.0.1.0 or a later version is required to upgrade existing agent installations.

  • A restart may be required if files are in use during the agent installation.

  • The agent version for this release is 11.2.0.0.

How to obtain and install the Azure File Sync Agent 

The Azure File Sync v11.2 release is currently being flighted to servers that are configured to automatically update when a new version becomes available. After fighting finishes, this update will be available on Microsoft Update and Microsoft Download Center. Flighting means that the release is offered to a limited number of servers first and expands to more severs gradually. It might 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 v11.2 release, manually download the update from the Microsoft Update Catalog.

To learn more about Azure File Sync agent auto-update, see the "Automatic agent lifecycle management" section of Release notes for the Azure File Sync agent.

To get 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> 

Manually download and install the Azure File Sync agent update from the Microsoft Update Catalog

Go to the following website to manually download this update from the Microsoft Update Catalog:

Azure File Sync Agent v11.2 release: February 2021 (KB4539952)

To manually install the update package, run the following command at an elevated command prompt:

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

For example, to install the Azure File Sync agent update for Server 2016, run the following command:

msiexec.exe /p StorageSyncAgent_WS2016_KB4539952.msp REINSTALLMODE=OMUS REINSTALL=StorageSyncAgent,StorageSyncAgentAzureFileSync,StorageSyncAgentGuardFilter,StorageSyncAgentUpdater /qb /l*v KB4539952.log

Need more help?

Expand your skills
Explore Training
Get new features first
Join Microsoft Insiders

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.

×