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 agent is available from Microsoft Update, Microsoft Update Catalog, and Microsoft Download Center.
Notes
-
If the Azure File Sync agent is not currently installed on a server, use the agent installation package on the Microsoft Download Center. The agent installation package on Microsoft Update and Microsoft Update Catalog is intended for agent upgrades only.
-
To update existing agent installations, run AfsUpdater.exe (located in the agent installation directory) or download and install the update from Microsoft Update or Microsoft Update Catalog.
Microsoft Update
To obtain and install from Microsoft Update, follow these steps on a server that has Azure File Sync agent installed:
Server 2016 and Server 2019
-
Click Start, and then click Settings.
-
In Settings, click Update & security.
-
In the Windows Update window, click Check online for updates from Microsoft Update.
-
Verify the Azure File Sync agent update is listed and then click Install now.
Server 2012 R2
-
Click Start, and then click Control Panel.
-
In Control Panel, double-click Windows Update.
-
In the Windows Update window, click Check for updates.
-
Click Important updates are available.
-
Verify the Azure File Sync agent update is selected, and then click Install.
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 from an elevated command prompt:
msiexec.exe /p packagename.mspREINSTALLMODE=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
Microsoft Download Center
Go to the Microsoft Download Center to manually download the agent installation package for new agent installations.
How to perform a silent installation for a new agent installation
To perform a silent installation for a new agent installation that uses the default settings, run the following command at an elevated command prompt:
msiexec /i packagename.msi /qb /l*v AFSv11Installation.log
For example, to install the Azure File Sync agent for Windows Server 2016, run the following command:
msiexec /i StorageSyncAgent_WS2016.msi /qb /l*v AFSv11Installation.log
Notes
-
Use the /qb switch to display restart prompts (if required), agent update, and server registration screens. To suppress the screens and automatically restart the server (if required), use the /qn switch.
-
To perform a silent installation with custom settings, follow the steps documented inĀ KB4459986.