A desktop client can be installed and registered in unattended mode (silently) by running the desktop client's executable file from the command line.
Install a desktop client in unattended mode
First, the desktop client must be installed. The following arguments can be used to control the installation process:
|--help||Display the list of valid options|
|--revision||Display product information|
|--unattendedmodeui||Unattended Mode UI
Allowed: none, minimal, minimalwithdialogs
Allowed: win32 unattended
Allowed: en ar bg ca da nl et fr fi de el es es_AR he hr hu it ja ko pl pt_BR pt ro ru no sl sk sq sv tr zh_TW zh_CN va cy cs
|--create_shortcuts||Creates Desktop shortcut with value of 1
Allowed: 0, 1
Note: Do not include http or https protocol; do not include port number, if applicable
|--httpport||Server Web Port
The following example will install the desktop client silently without registering it:
- From the command-line, navigate to the location of the executable file (installation file). Please note that you should not rename the downloaded executable file when conducting a silent installation. The name of the executable file determines both branding settings and the current revision of the desktop client. If you alter the name of the executable file, branding settings will not be reflected, and the current revision of the desktop client will not be installed. For example, if the executable file exists on the Desktop, run the following commend:
- Run the executable file from the command-line using the following arguments, making sure to replace the information appropriate to the specific environment and user.
SyncedTool_OrganizationA.syncedtool.com_15059-184.108.40.2065.exe --unattendedmodeui none --mode unattended --host OrganizationA.syncedtool.com
Register a desktop client in unattended mode
After the installation process completes, the desktop client can then be registered to a user silently. The following arguments can be used to control the registration process:
|--help||Produce help message|
|--action||Action to perform (required)
|--user||Username (email or domain\ad_username)|
|--auth_code||Two-Factor Authentication code (when the Two-Factor Authentication policy has been enabled and configured)|
The following example will register the desktop client using the desktop client_cmdui.exe file located in the installation directory bin folder.
- From the command-line, navigate to the Synced Tool installation directory (for example, C:\Program Files (x86)\SyncedTool).
cd C:\Program Files (x86)\SyncedTool
- Run the desktop client_cmdui.exe file using the following arguments, making sure to replace the text with information appropriate to the specific environment and user. Please note that you should execute agent_cmdui.exe from its parent folder (for example, C:\Program Files (x86)\SyncedTool) as noted in the example above.
bin\agent_cmdui.exe --config "C:\Program Files (x86)\SyncedTool\conf\config.ini" --action register --user firstname.lastname@example.org --password PASSWORD --path "C:\Users\Synced"
After silently registering the user, you might notice that the application UI still indicates that registration is not complete. Run the following command from the installation directory BIN folder (for example, C:\Program Files (x86)\SyncedTool\bin):
agent_gui.exe --message check_registration