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
- /op:enable
- /op:disable
- /op:SetLicense
- /op:configureAlerting
- /op:setAdminEmail
- /op:createProgramGroupShortcuts
- /op:removeProgramGroupShortcuts
- /op:getComputers
/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:
|
/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