Command line installation

The following settings are intended for use only with the reduced, basic and none level of the user interface. See documentation exlink for the msiexec version used for the appropriate command line switches.

Supported parameters:

APPDIR=<path>

path - Valid directory path

Application installation directory

For example: emsx_nt64.msi /qn APPDIR=C:\ESET\ ADDLOCAL=DocumentProtection

APPDATADIR=<path>

path - Valid directory path

Application Data installation directory

MODULEDIR=<path>

path - Valid directory path

Module installation directory

ADDLOCAL=<list>

Component installation - list of non-mandatory features to be installed locally.

Usage with ESET .msi packages: emsx_nt64.msi /qn ADDLOCAL=<list>

For more information about the ADDLOCAL property see https://docs.microsoft.com/en-gb/windows/desktop/Msi/addlocal exlink

The ADDLOCAL list is a comma-separated list of all feature that will be installed.

When selecting a feature to be installed, the full path (all parent features) must be explicitly included in the list.

REMOVE=<list>

Component installation - parent feature you do not want to have installed locally.

Usage with ESET .msi packages: emsx_nt64.msi /qn REMOVE=<list>

For more information about the REMOVE property see https://docs.microsoft.com/en-gb/windows/desktop/Msi/remove exlink

The REMOVE list is a comma-separated list of parent features that will not be installed (or will be removed in case of existing installation).

It is sufficient to specify parent feature only. There is no need to explicitly include every child feature to the list.

ADDEXCLUDE=<list>

The ADDEXCLUDE list is a comma-separated list of all feature names not to be installed.

When selecting a feature not to be installed, then the whole path (i.e., all its sub-features) and related invisible features must be explicitly included in the list.

For example: emsx_nt64.msi /qn ADDEXCLUDE=<list>


NOTE

ADDEXCLUDE cannot be used with ADDLOCAL.

Feature Presence

Mandatory - The feature is always installed.

Optional - The feature may be deselected for install.

Invisible - Logical feature mandatory for other features to work properly.

List of ESET Mail Security features:


IMPORTANT

Names of all the features are case sensitive, for example RealtimeProtection is not equal to REALTIMEPROTECTION.

Feature Name

Feature Presence

SERVER

Mandatory

RealtimeProtection

Mandatory

MAILSERVER

Mandatory

WMIProvider

Mandatory

HIPS

Mandatory

Updater

Mandatory

eShell

Mandatory

UpdateMirror

Mandatory

DeviceControl

Optional

DocumentProtection

Optional

WebAndEmail

Optional

ProtocolFiltering

Invisible

NetworkProtection

Optional

IdsAndBotnetProtection

Optional

Rmm

Optional

WebAccessProtection

Optional

EmailClientProtection

Optional

MailPlugins

Invisible

Cluster

Optional

_Base

 

eula

 

ShellExt

Optional

_FeaturesCore

 

GraphicUserInterface

Optional

SysInspector

Optional

SysRescue

Optional

EnterpriseInspector

Optional

If you want to remove any of the following features, you need to remove the whole group by specifying every feature that belongs to the group. Otherwise, the feature will not be removed. Here are two groups (each line represents one group):

GraphicUserInterface,ShellExt

NetworkProtection,WebAccessProtection,IdsAndBotnetProtection,ProtocolFiltering,MailPlugins,EmailClientProtection


EXAMPLE

Exclude NetworkProtection section (including child features) from the installation using REMOVE parameter and specifying only parent feature:

msiexec /i emsx_nt64.msi /qn ADDLOCAL=ALL REMOVE=NetworkProtection

Alternatively, you can use ADDEXCLUDE parameter, but you must also specify all child features:

msiexec /i emsx_nt64.msi /qn ADDEXCLUDE=NetworkProtection,WebAccessProtection,IdsAndBotnetProtection,^
ProtocolFiltering,MailPlugins,EmailClientProtection

If you want your ESET Mail Security to be automatically configured after the installation, you can specify basic configuration parameters within the installation command.


EXAMPLE

Install ESET Mail Security and disable ESET LiveGrid®:

msiexec /i emsx_nt64.msi /qn /l*xv msi.log CFG_LIVEGRID_ENABLED=0

List of all configuration properties:

Switch

Value

CFG_POTENTIALLYUNWANTED_ENABLED=1/0

0 - Disabled, 1 - Enabled

CFG_LIVEGRID_ENABLED=1/0

0 - Disabled, 1 - Enabled

FIRSTSCAN_ENABLE=1/0

0 - Disable, 1 - Enable

CFG_PROXY_ENABLED=0/1

0 - Disabled, 1 - Enabled

CFG_PROXY_ADDRESS=<ip>

Proxy IP address

CFG_PROXY_PORT=<port>

Proxy port number

CFG_PROXY_USERNAME=<user>

User name for authentication

CFG_PROXY_PASSWORD=<pass>

Password for authentication

Language parameters: Product language (you must specify both parameters)

Switch

Value

PRODUCT_LANG=

LCID Decimal (Locale ID), for example 1033 for English - United States, see the list of language codes exlink.

PRODUCT_LANG_CODE=

LCID String (Language Culture Name) in lowercase, for example en-us for English - United States, see the list of language codes exlink.