Next Topic

Previous Topic

Book Contents

Agent Install Command Line Switches

Agent install command line switches for KcsSetup.exe are case insensitive and order independent. Separate switches with an empty space.

/b - Reboot the system after installation completes. Agent installation requires a reboot in order to load its drivers. Use this switch on packages given to users that do not have rights to shut down the computer.

/c - Use the computer name as the machine ID for the new account. If the computer name cannot be determined programmatically, the user is prompted to enter a machine ID. The exception is silent mode, /s, in which case the installation stops and an error is logged to the installation log.

/d - Use the current domain name as the group ID for the new account. If the domain name cannot be determined programmatically, the user will be prompted to enter the group ID. The exception is silent mode, /s, in which case the installation stops and an error is logged to the installation log.

/e - Exit immediately if the installer detects that an agent is already installed. Use /e at the end of logon scripts. /k or /r overrides /e.

/g=xxx - Specifies the group ID to use for the new account. xxx must be an alpha-numeric string and can not contain spaces or punctuation marks.

/h - Display the help dialog box listing all the command line switches, unless the /s switch is set, in which case the application exits.

/i - Ignore non-critical errors such as incorrect or indeterminate versions of WinSock2, or indeterminate versions of the OS, and force the installation to proceed.

/k - Displays a dialog box asking the user if it is OK to re-install when the agent is already detected on the machine. Without this switch, the installer exits if an agent is already present.

/m=xxx - Specifies the machine ID to use for the new account. xxx must be an alpha-numeric string and can not contain spaces or any punctuation marks except period(.).

/p "install_path" - Overrides the default installation path by specifying the full directory path, including drive letter, in which to install the agent. By default, the agent installation creates a directory named Program Files\Kaseya\Agent off the root of the drive on which Windows is installed.

/r - Executes the installation program and reinstalls the agent even if an agent is already on the machine.

/s - Runs in silent mode. Suppresses all dialog boxes.

/t "Title" - Specifies the title of any dialog windows shown to the user during installation. The default title is: "Kaseya Agent".

/u - Uses the current user name as the machine ID for the new account. If the user name cannot be determined programmatically, the user is prompted to enter a machine ID. The exception is silent mode, /s, in which case the installation stops and an error is logged to the installation log.

/w - Overwrites the existing configuration file with a configuration file included in the agent installation. Use with the /r switch to re-install an agent with new server settings. Intended for an existing agent that is attempting to connect to a server that no longer exists.

/x - Disables remote control after successfully installing the agent. This option is ignored when updating or re-installing. Remote control of this machine can only occur after the user selects Enable Remote Control by right clicking the K icon on the system tray.

/z “Message” - Specifies the message shown to the user when installation completes. The exception is silent mode, /s, in which case the installation completes and the status message is written to the installation log. The default message is: "The Agent has been installed successfully on your computer.”