Command lines

We are pleased to provide you with a comprehensive set of command-line tools designed to enhance the flexibility and efficiency of our software. These tools enable users to script and automate various functionalities, tailoring the software to meet their specific needs and workflows.

Explore the possibilities and optimize your experience with our command-line options.

You only have to run the following command lines as an elevated Administrator. As a reminder, AdminTool.exe and TwoFactor.Admin.exe (2FA addon) should be located here: C:\Program Files (x86)\BYODAPP\UserDesktop\files

Table of contents


Backup data and settings: /backup

Syntax:

AdminTool.exe /backup [optionalPath] [parameters]

Description:

Command /backup is used to backup BYODAPP data and settings.

By default, the backup will be created in the archives directory (C:\Backupparam)

Parameters:

  • optionalPath: to backup in another directory than the default one. Relative and absolute paths are allowed.
  • /silent: if this parameter is mentioned, the backup is done silently

Examples:

AdminTool.exe /backup
AdminTool.exe /backup "c:/BYODAPP/CustomBackupFolder" /silent

For more information, please go to BYODAPP - Backup Settings


Restore data and settings: /restore

Syntax:

AdminTool.exe /restore [backupPath] [parameters]

Description:

Command /restore is used to restore BYODAPP data and settings.

The specified backup directory must contain a data and a settings folder, as created by the /backup command.

Parameters:

  • backupPath: the path where is located the backup folder to restore.
  • /silent: if this parameter is mentioned, the restore is done silently

Examples:

AdminTool.exe /restore "C:/Backupparam" /silent
AdminTool.exe /restore "C:/BYODAPP/CustomBackupFolder" /silent

For more information, please go to BYODAPP - Backup Settings


Webserver: /webstop, /webstart and /webrestart

Syntax:

AdminTool.exe /webstop

AdminTool.exe /webstart

AdminTool.exe /webrestart

Description:

Command /webstop is used to stop the Web server.

Command /webstart is used to start the Web server.

Command /webrestart is used to restart the Web server.

Parameters:

None


Update: /update

Syntax:

AdminTool.exe /update [options]

Description:

Command update is used to update BYODAPP Remote Access and potentially Advanced Security.

Parameters:

  • [options]:
    • /addons: if this option is used, Advanced Security is also updated, if a new version is available.

Example:

AdminTool.exe /update /addons

Apply Windows compatibility updates: /updatekernel

Syntax:

svcac.exe /updatekernel [/silent]

svcac.exe should be located here: C:\Program Files (x86)\BYODAPP

Description:

Command /updatekernel is used to apply Windows compatibility updates.

These automatic updates ensure that BYODAPP Remote Access remains compatible with new Windows updates and avoid the need to download and reinstall a newer version of BYODAPP Remote Access.

Windows compatibility updates can occur daily. BYODAPP Remote Access allows forced updating. This is useful when compatibility seems broken, and you need to retrieve the latest BYODAPP Remote Access patch outside of the regular update schedule.

Please note that a valid license is required to retrieve compatibility updates. If your trial license has expired or if your license is invalid, an error message box will be displayed. Please contact our support team with a screenshot of this error message if the issue is unexpected.

Parameters:

  • [/silent]: Update silently by providing this parameter. No message box will be displayed.

Install Universal Printer: /InstallUniversalPrinter

Syntax:

universalprintermanagement.exe /InstallUniversalPrinter

universalprintermanagement.exe is located here: C:\Program Files (x86)\BYODAPP\UserDesktop\files

Description:

Command /InstallUniversalPrinter is used to install Universal Printer.

This is a clean install as it removes existing Universal Printer if previously installed.

Parameters:

None

You can also perform this action manually, please look at Universal Printer


Remove UniversalPrinter: /RemoveUniversalPrinter

Syntax:

universalprintermanagement.exe /RemoveUniversalPrinter

universalprintermanagement.exe is located here: C:\Program Files (x86)\BYODAPP\UserDesktop\files

Description:

Command /RemoveUniversalPrinter is used to uninstall Universal Printer.

Parameters:

None

You can also perform this action manually, please look at Universal Printer


Configure proxy server: /proxy /set

Syntax:

AdminTool.exe /proxy /set [parameters]

Description:

Command /proxy /set is used to configure a proxy server for Internet access.

Parameters:

  • /host: the destination host can be a predefined value ("ie" or "none") or a user-defined value (e.g: 127.0.0.1 or proxy.company.org). This parameter is mandatory
  • /port: the port number used to connect to the proxy server. Required if the hostname value is a custom user-defined value.
  • /username: the username to connect to the proxy server. This setting is optional
  • /password: the user's password must be supplied if a username has been defined. However, its value can be empty

Examples:

AdminTool.exe /proxy /set /host proxy.company.org /port 80 /username dummy /password pass@word1

AdminTool.exe /proxy /set /host ie

For more information, please go to How to configure a Proxy Server for Internet Access?


Open Web Credentials form: /webcredentials

Syntax:

AdminTool.exe /webcredentials

Description:

Command /webcredentials launches in a single window the Web Credentials interface (as you would do in AdminTool > Web > Web Credentials).

Parameters:

None


Create Web Credentials: /webcredentials-add

Syntax:

AdminTool.exe /webcredentials-add [webLogin] [webPassword] [windowsLogin] [windowsPassword] [maximumConcurrentSessions]

Description:

Command /webcredentials-add is used to create Web Credentials (as you would do in AdminTool > Web > Web Credentials).

Parameters:

  • webLogin: the web login you want to create.
  • webPassword: the associated web password. It can be blank credential. For that, use double quotes "" to indicate a blank password
  • windowsLogin: the Windows login of the corresponding user.
  • windowsPassword: the Windows password.
  • maximumConcurrentSessions (optional): the maximum number of concurrent sessions for this user.

Example:

AdminTool.exe /webcredentials-add johndoe passwordABCD johnWinuser johnWinpassword 4

For more information, please go to Web Credentials


Remove Web Credentials: /webcredentials-remove

Syntax:

AdminTool.exe /webcredentials-remove [webLogin]

Description:

Command /webcredentials-remove is used to remove an existing Web Credential (as you would do in AdminTool > Web > Web Credentials).

Parameters:

  • webLogin: the web login you want to remove.

Example:

AdminTool.exe /webcredentials-remove johndoe

For more information, please go to Web Credentials


Open Session Manager: /sessionmanager

Syntax:

AdminTool.exe /sessionmanager

Description:

Command /sessionmanager launches in a single sizable-window the session manager (as you would do in AdminTool > Home > Session Manager).

Parameters:

None


Open Sessions monitor: /farm-sessions-monitor

Syntax:

AdminTool.exe /farm-sessions-monitor

Description:

Command /farm-sessions-monitor launches in a single sizable-window the session monitor of the farm manager (as you would do in AdminTool > Farm > Monitor Sessions).

Parameters:

None


Run system audit: /systemaudit

Syntax:

AdminTool.exe /systemaudit

Description:

Command /systemaudit runs a system audit (as you would do manually in AdminTool > Home > System Audit > Run System Audit).

Parameters:

None


License activation: /activate

Syntax:

AdminTool.exe /activate [licensePath]

Description:

Command activate is used to activate Remote Access license, using a license file.

Parameters:

  • [licensePath]: the path of the license file

Example:

AdminTool.exe /activate "C:\Program Files (x86)\BYODAPP\license.lic"

Volume license activation: /vl /activate

Syntax:

AdminTool.exe /vl /activate [licensekey] [parameters]

Description :

Command vl /activate is used to activate a volume license.

Parameters:

  • licensekey: license key to activate, in this format: AAAA-BBBB-CCCC-DDDD
  • /users: any number from 1 to 50, or "unlimited"
  • /edition: "Desktop", "MobileWeb" or "Enterprise"
  • /supportyears: Any number from 0 to 3.
  • /comments: Specifies the comments to attach to the license on the License portal

Example:

AdminTool.exe /vl /activate VOLU-MELI-CENS-EKEY /users unlimited /edition Enterprise /supportyears 3 /comments "This is a comment"

For more information, please go to Volume license documentation


Enabling and disabling Volume license: /vl /enable and /vl /disable

Syntax:

AdminTool.exe /vl /enable [licensekey]

AdminTool.exe /vl /disable [licensekey]

Description:

Command vl /enable is used to enable a volume license.

Command vl /disable is used to disable a volume license.

Parameters:

  • licensekey: license key to enable/disable, in this format: AAAA-BBBB-CCCC-DDDD

Examples:

AdminTool.exe /vl /enable VOLU-MELI-CENS-EKEY

AdminTool.exe /vl /disable VOLU-MELI-CENS-EKEY

For more information, please go to How to enable/disable a License from the Server?


Volume license update: /vl /update

Syntax:

AdminTool.exe /vl /update [licensekey] [parameters]

Description:

Command vl /update is used to update the users of a volume license.

Parameters:

  • licensekey: license key to update, in this format: AAAA-BBBB-CCCC-DDDD
  • /users: any number from 1 to 50, or "unlimited"

Examples:

AdminTool.exe /vl /update /users 2
AdminTool.exe /vl /update /users unlimited

For more information, please go to How to Update the Users of a Volume License from the Server?


2FA - reset: /resetuser

Syntax:

TwoFactor..Admin.exe /resetuser [user1] [user2] .... [userN]

Description:

Command /resetuser is used to reset 2FA users, instead of doing it through the user interface (this can be done here in the interface: TwoFactor.Admin > Manage Users > Reset)

Parameters:

  • user1 user2 ... userN: the domain names of the users you want to reset (separated by simple space)

Examples:

TwoFactor.Admin.exe /resetuser johndoe jackrussell chuckbartowski

For more information, please go to Reset Configuration for Users


2FA - add users: /addusers

Syntax:

TwoFactor.Admin.exe /addusers [userInfos1] [userInfos2] ... [userInfosN]

Description:

Command /addusers is used to add several 2FA users, instead of doing it through the user interface, user by user (this can be done here in the interface: TwoFactor.Admin > Manage Users > Add User)

Parameters:

  • userInfos1 userInfos2 ... userInfosN: the user infos of the users you want to add. These infos consist of the following fields, separated by a semi-colon:
    • domainName (mandatory): the domain Name of the user to add
    • receivedMethod (optional): the method to receive confirmation codes. Has to be one of these values: SMS, App, Email or LetTheUserChoose. App is the default value.
    • mobilePhone (optional): the phone of the user to add
    • email (optional): the email of the user to add

Examples:

TwoFactor.Admin.exe /addusers johndoe jackrussell;LetTheUserChoose chuckbartowski;Phone;+33101010101;abcd@efgh.com samanthacarter;Email;;

For more information, please go to Add Users and Groups


2FA - add groups: /addgroups

Syntax:

TwoFactor.Admin.exe /addgroups [group1] [group2] ... [groupN]

Description:

Command /addgroups is used to add several 2FA groups, instead of doing it through the user interface, group by group (this can be done here in the interface: TwoFactor.Admin > Manage Users > Add Group)

Parameters:

  • group1 group2 ... groupN: the names of the groups you want to add.

Examples:

TwoFactor.Admin.exe /addgroups group1 group2 group3

For more information, please go to Add Users and Groups