How to perform a silent installation for a new Azure File Sync agent installation
This article covers how to silently install the Azure File Sync agent using default or custom settings.
Silent installation that uses default settings
To run 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 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.
Silent installation that uses custom settings
To run a silent installation for a new agent installation that uses custom settings, use the parameters that are documented in the table below.
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
| 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 |
| 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_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 |