Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This article explains how to silently install the Azure File Sync agent by using default or custom settings. Use silent installation when you need to deploy the agent across multiple servers without manual interaction. For example, use silent installation in automated provisioning scripts, group policy deployments, or configuration management tools like Microsoft Configuration Manager.
You can perform a silent installation that uses either default or custom settings.
Perform a silent installation that uses default settings
To run a silent installation for a new Azure File Sync agent installation that uses the default settings, run the following command from an elevated command prompt:
msiexec /i packagename.msi /qb /l*v AFSInstaller.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 AFSInstaller.log
Note
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.
Perform a silent installation that uses custom settings
To run a silent installation for a new Azure File Sync agent installation that uses custom settings, use the parameters documented in Azure File Sync agent installation parameters.
For example, to run a silent installation by using custom proxy settings, run the following command:
msiexec /i StorageSyncAgent_WS2016.msi USE_CUSTOM_PROXY_SETTINGS=1 PROXY_ADDRESS=10.0.0.1 PROXY_PORT=80 PROXY_AUTHREQUIRED_FLAG=1 PROXY_USERNAME=username PROXY_PASSWORD=password /qb /l*v AFSInstaller.log
For example, to run a silent installation by using an unattend answer file, run the following command:
msiexec /i StorageSyncAgent_WS2016.msi UNATTEND_ANSWER_FILE=c:\agent\unattend.ini /qb /l*v AFSInstaller.log
The unattend answer file should have the following format:
ACCEPTEULA=1
ENABLE_AZUREFILESYNC_FEATURE=1
AGENTINSTALLDIR=%SYSTEMDRIVE%\Program Files\Azure\StorageSyncAgent
ENABLE_MU_ENROLL=1
ENABLE_DATA_COLLECTION=1
ENABLE_AGENT_UPDATE_POSTINSTALL=1
USE_CUSTOM_PROXY_SETTINGS=1
PROXY_ADDRESS=10.0.0.1
PROXY_PORT=80
PROXY_AUTHREQUIRED_FLAG=1
PROXY_USERNAME=username
PROXY_PASSWORD=password
Azure File Sync agent installation parameters
The following table describes the parameters you can use to customize a silent installation of the Azure File Sync agent.
| Parameter | Purpose | Values | Default Value |
|---|---|---|---|
| ACCEPTEULA | Azure File Sync license agreement | 0 (Not accepted) or 1 (Accepted) | 1 |
| ENABLE_AZUREFILESYNC_FEATURE | Azure File Sync feature installation option | 0 (Do not install) or 1 (Install) | 1 |
| AGENTINSTALLDIR | Agent installation directory | Local Path | %SYSTEMDRIVE%\Program Files\Azure\StorageSyncAgent |
| AGENT_AUTO_UPDATE_SCHEDULED_DAY | Specifies day to apply the update. Used in conjunction with AGENT_AUTO_UPDATE_SCHEDULED_HOUR | Monday (or other days of the week) | Tuesday |
| AGENT_AUTO_UPDATE_SCHEDULED_HOUR | Specifies hour to apply (24-hour format). Used in conjunction with AGENT_AUTO_UPDATE_SCHEDULED_DAY | 20 (or other hours of the day - 00 to 23) | 18 |
| AUTO_UPDATE_POLICY_MODE | To set auto update policy mode | InstallLatest or UpdateBeforeExpiration | UpdateBeforeExpiration |
| ENABLE_MU_ENROLL | Enroll in Microsoft Update | 0 (Do not enroll) or 1 (Enroll) | 1 |
| ENABLE_DATA_COLLECTION | Collect data necessary to identify and fix problems | 0 (No) or 1 (Yes) | 1 |
| ENABLE_AGENT_AUTO_UPDATE | Turns automatic updates on or off | 0 (Off) or 1 (On) | 0 |
| ENABLE_AGENT_UPDATE_POSTINSTALL | Check for updates after agent installation completes | 0 (No) or 1 (Yes) | 1 |
| USE_CUSTOM_PROXY_SETTINGS | Use default proxy settings (if configured) or custom proxy settings | 0 (Default Proxy) or 1 (Custom Proxy) | 0 |
| PROXY_ADDRESS | Proxy server IP address | IP Address | |
| PROXY_PORT | Proxy server port number | Port Number | |
| PROXY_AUTHREQUIRED_FLAG | Proxy server requires credentials | 0 (No) or 1 (Yes) | |
| PROXY_USERNAME | User name used for authentication | Username | |
| PROXY_PASSWORD | Password used for authentication | Password | |
| UNATTEND_ANSWER_FILE | Use unattend answer file | Path |