Using ESMCmdConfig.exe

ESMCmdConfig.exe enables you to configure general settings for GFI EventsManager; such as:

  • GFI EventsManager logon credentials
  • License key
  • Mail server settings
  • Administrator account
  • Create/Remove Group shortcuts
  • Get computer names.

To use ESMCmdConfig.exe:

1. Click Start > Run and key in CMD.

2. Click Ctrl + Shift + Enter to run CMD with elevated privileges.

3. Change the directory to the GFI EventsManager install directory. Example:

CD C:\Program Files\GFI\EventsManager

4. Key in ESMCmdConfig.exe followed by the functions described below:

/op:registerService

This function enables you to register GFI EventsManager services, using an administrator account. The following parameters are supported:

Parameter Description
/username:<username>

Specify the username of an administrator account.

Note

Parameters that contain spaces must be enclosed in double quotes ().

/pass:<password> Specify the password for the account specified in the /username parameter.

Example

ESMCmdConfig.exe /op:registerService /username:Domain\Administrator /pass:p@ss

/op:enable

This function enables you to turn on events management features and does not support additional parameters.

Example

ESMCmdConfig.exe /op:enable

/op:disable

This function enables you to turn off events management features and prompts the user with a custom message. The following parameter is supported:

Parameter Description
/message:<message>

Specify a custom message that is shown to the user before events management features are disabled.

Note

Parameters that contain spaces must be enclosed in double quotes ().

Example

ESMCmdConfig.exe /op:disable /message:"Events Management Disabled!"

/op:SetLicense

This function enables you to enter the product license key. The following parameter is supported:

Parameter Description
/licenseKey:<key> Specify the product license key.

Example

ESMCmdConfig.exe /op:SetLicense /licenseKey:*********

/op:configureAlerting

This function enables you to turn on and configure email alerting options. The following parameters are supported:

Parameter

Description

/Server:<server> Specify the mail server IP address or fully qualified domain name (FQDN).
/SenderEmail:<email> Specify the sender email address. Notifications appear to have been sent from the specified address.
/Port:<port> Specify the TCP port used to send emails.
/RequiresAuthentication:<true|false>

Specify if the mail server requires authentication. Supported values are:

  • True
  • False.
/User:<username>

Specify the username of the email address specified in the /SenderEmail parameter.

Note

Parameters that contain spaces must be enclosed in double quotes ().

/Pass:<password> Specify the password for the username specified in the /User parameter.

Example

ESMCmdConfig.exe /op:configureAlerting /Server:192.168.11.11 /SenderEmail:jsmith@domain.com /Port:25 /RequiresAuthentication:True /User:jsmith /Pass:p@ss

/op:setAdminEmail

This function enables you to configure the EventsManagerAdministrator email address. The following parameter is supported:

Parameter Description
/email:<email> Specify the EventsManagerAdministrator email address.

Example

ESMCmdConfig.exe /op:setAdminEmail /email:esmadmin@domain.com

/op:createProgramGroupShortcuts

This function enables you to create group shortcuts and has no additional parameters.

Example

ESMCmdConfig.exe /op:createProgramGroupShortcuts

/op:removeProgramGroupShortcuts

This function enables you to remove group shortcuts and has no additional parameters.

Example

ESMCmdConfig.exe /op:removeProgramGroupShortcuts

/op:getComputers

This function enables you to retrieve a text file containing the names of event sources managed by GFI EventsManager. The following parameter is supported:

Parameter Description

/filename:<fileName>

Specify the full path where the text file is exported to including the name of the text file.

Note

Parameters that contain spaces must be enclosed in double quotes ().

Example

ESMCmdConfig.exe /op:getComputers /filename:C:\ComputerNames.txt