Merge pull request #280064 from jeffpatt24/patch-1

Create file-sync-agent-silent-installation.md

Author: Jill Grant

articles/storage/file-sync/TOC.yml

@@ -210,6 +210,8 @@
     href: https://azure.microsoft.com/updates/?category=storage
   - name: Azure File Sync release notes
     href: file-sync-release-notes.md
+  - name: Azure File Sync agent silent installation
+    href: file-sync-agent-silent-installation.md
   - name: Azure Files on Microsoft Q&A
     href: /answers/topics/azure-files.html
   - name: Azure Files on Stack Overflow

articles/storage/file-sync/file-sync-agent-silent-installation.md

@@ -0,0 +1,76 @@
+---
+title: How to install the Azure File Sync agent silently 
+description: Discusses how to perform a silent installation for a new Azure File Sync agent installation
+author: khdownie
+ms.service: azure-file-storage
+ms.topic: how-to
+ms.date: 07/03/2024
+ms.author: kendownie
+---
+
+# 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||