ESET DEM plugins DEM plugin Owner's manual

ESET Direct Endpoint Management

plugin for NinjaOne

User guide

Click here to display the online version of this document

ESET Direct Endpoint Management plugin for NinjaOne was developed by ESET, spol. s r.o.

For more information visit https://www.eset.com.

in any form or by any means, electronic, mechanical, photocopying, recording, scanning, or otherwise without

permission in writing from the author.

ESET, spol. s r.o. reserves the right to change any of the described application software without prior notice.

Technical Support: https://support.eset.com

REV. 3/31/2023

1 Introduction 1 .......................................................................................................................................

2 System Requirements 1 .......................................................................................................................

3 Download 2 ..........................................................................................................................................

4 Integrating and using the Windows plugin 2 ........................................................................................

4.1 Create an ESET category for Windows 3 ...........................................................................................

4.2 Import an ESET script for Windows 3 ...............................................................................................

4.3 On-demand scripts for Windows 5 ...................................................................................................

4.3 Install and activate 6 .....................................................................................................................

4.3 Uninstall 8 .................................................................................................................................

4.3 Activate 11 ...............................................................................................................................

4.3 Deactivate 13 .............................................................................................................................

4.3 Scan 16 ...................................................................................................................................

4.3 Update 18 .................................................................................................................................

4.3 Upgrade 21 ...............................................................................................................................

4.3 Conﬁgure 23 ..............................................................................................................................

4.4 Monitoring for Windows 26 ............................................................................................................

4.4 Transfer logs to Windows Event Log 26 .................................................................................................

4.4 Conditions 29 .............................................................................................................................

5 Integrating and using the macOS plugin 34 .........................................................................................

5.1 Create an ESET category for macOS 34 ............................................................................................

5.2 Import an ESET script for macOS 35 ................................................................................................

5.3 On-demand scripts for macOS 37 ....................................................................................................

5.3 Install and activate 38 ...................................................................................................................

5.3 Uninstall 40 ...............................................................................................................................

5.3 Activate 43 ...............................................................................................................................

5.3 Deactivate 45 .............................................................................................................................

5.3 Scan 48 ...................................................................................................................................

5.3 Update 50 .................................................................................................................................

5.3 Upgrade 53 ...............................................................................................................................

5.3 Conﬁgure 55 ..............................................................................................................................

5.4 Monitoring for macOS 58 ...............................................................................................................

6 Integrating and using the Linux plugin 58 ............................................................................................

6.1 Create an ESET category for Linux 58 ..............................................................................................

6.2 Import an ESET script for Linux 59 ..................................................................................................

6.3 On-demand scripts for Linux 61 ......................................................................................................

6.3 Install and activate 62 ...................................................................................................................

6.3 Uninstall 64 ...............................................................................................................................

6.3 Activate 67 ...............................................................................................................................

6.3 Deactivate 69 .............................................................................................................................

6.3 Scan 72 ...................................................................................................................................

6.3 Update 74 .................................................................................................................................

6.3 Conﬁgure 77 ..............................................................................................................................

6.4 Monitoring for Linux 79 .................................................................................................................

6.4 Conditions 79 .............................................................................................................................

7 Support and Troubleshooting 85 ..........................................................................................................

7.1 Feedback 86 .................................................................................................................................

7.2 Known issues 86 ...........................................................................................................................

7.3 Changelog 87 ...............................................................................................................................

1

Introduction

The ESET Direct Endpoint Management plugin for NinjaOne is a Remote Management and Monitoring (RMM) tool

that enables you to deploy ESET endpoint protection software to your Windows, macOS and Linux workstations

and servers. ESET endpoint protection software will collect logs about your workstations and the server's security

statuses when deployed.

Integrating with ESET endpoint products

The ESET Direct Endpoint Management plugin for NinjaOne deploys and manages your endpoints without

needing additional servers or an intermediary console. ESET Direct Endpoint Management establishes a

connection between ESET endpoint products and NinjaOne.

Tasks

The ESET Direct Endpoint Management plugin for NinjaOne automatically schedules scans and updates for your

ESET endpoint products, and also enables you to perform on-demand scans and off-schedule updates. You can

change the configuration of your endpoint products, activate and deactivate your licenses and uninstall your

endpoint products, all from the NinjaOne console.

Before you begin

Set up the ESET Direct Endpoint Management plugin for NinjaOne according to the instructions on the customer's

NinjaOne account. Verify that you have already set up and deployed NinjaOne to your endpoints. Also verify that

you can log in to NinjaOne with administrator privileges and that endpoint users receive notifications from your

organization.

System Requirements

Products supported

The ESET Direct Endpoint Management plugin for NinjaOne works without a remote management server.

Currently, NinjaOne supports the following ESET products:

Windows:

• ESET Endpoint Antivirus (EEA) version 7.3, 8.1 and later

• ESET Endpoint Security (EES) version 7.3, 8.1 and later

• ESET File Security for Microsoft Windows Server (EFSW) version 7.3 and later

• ESET Mail Security for Microsoft Exchange Server (EMSX) version 7.3 and later

macOS:

• ESET Endpoint Antivirus (EEA) for macOS version 6.11 and later

2

• ESET Endpoint Security (EES) for macOS version 6.10 and later

Linux:

• ESET Endpoint Antivirus (EEA) for Linux version 8.1 and later

• ESET Server Security (ESS) for Linux version 8.1 and later

For ESET endpoint System Requirements, refer to the System Requirements for Windows (EEA, EES), macOS (EEA,

EES) and Linux (EEA, ESS).

.NET Framework version 4.0.3 required

All Windows endpoints must have a minimum of .NET Framework version 4.0.3 installed for the ESET DEM plugin

for NinjaOne components to function properly.

eRMM program

The ESET DEM plugin for NinjaOne components rely on a companion program, eRMM, that is automatically

downloaded to endpoints when an ESET-specific automation policy has been run on each endpoint. This software

is auto-updating and only requires a working internet connection. The eRMM software communicates between

ESET products and NinjaOne.

Read the eRMM End User License Agreement.

Download

1. Download the ESET Direct Endpoint Management plugin for NinjaOne.

2. When the file download is complete, extract the .zip file.

The

eset_dem_ninjaone_plugin.zip

contains:

• An

EULA.pdf

file

• A PowerShell script for Windows

• A ShellScript script for macOS and Linux

Adjust downloaded scripts

Edit the ESET-supplied macOS scripts with the correct End of Line (EOL) characters: CR instead of CR LF.

Edit the ESET-supplied Linux scripts with the correct End of Line (EOL) characters: LF instead of CR LF.

Integrating and using the Windows plugin

This section includes the following topics:

• Create an ESET category for Windows

3

• Import an ESET script for Windows

• On-demand scripts for Windows

• Monitoring for Windows

Create an ESET category for Windows

Create an ESET category to store your Windows scripts.

1. In the NinjaOne console, click Administration > Library > Scripting.

2. Click Categories > Create New Category.

3. In the Name field, type ESET—Windows and click Save.

The new category ESET—Windows appears in the Categories window.

Import an ESET script for Windows

To import an ESET script for Windows:

1. In the NinjaOne console, click Administration > Library > Scripting.

2. In the Scripts section, click Import New Script > From my computer.

4

3. In the next window, navigate to the folder containing the PowerShell script for Windows. Select the script

file and click Open.

4. When the script editor window appears, type a script Name, Description, and select ESET—Windows from

the Category drop-down menu. Use the default settings for Language (PowerShell), Operating System

(Windows) and Architecture (All).

5. Add your desired Parameters for the script. The following Windows parameters are available: INSTALL,

UNINSTALL, ACTIVATE, DEACTIVATE, SCAN, UPDATE, UPGRADE and CONFIGURE.

5

6. When done, click Save.

Note

Two-Factor Authentication may be required to save changes.

On-demand scripts for Windows

On-demand scripts can be applied per device and include the following:

• Install with activate—Install and activate a supported ESET product. To directly activate the ESET product,

you must specify the product's License Key (XXXX-XXXX-XXXX-XXXX-XXXX) or use the ESET Business Account

(EBA)/ESET MSP Administrator 2 (EMA2) credentials (login and password) along with the public license ID.

Note

To use the second option, we recommend creating many installation packages to account for each

product and company, which should be separate.

• Uninstall—Remove the ESET product currently running on a specific endpoint and set up automatic

notifications to the administrator for every uninstall that processes.

• Activate—Activate a supported ESET product. The available activation methods are the same as those for

the Install On-demand script.

• Deactivate—Deactivate the ESET product currently running on a specific endpoint and set up automatic

notifications to the administrator for every deactivation that processes.

• Scan—Initiate an On-demand scan. You can scan all files and folders using the Smart Scan profile or specify

the exact files and folders to scan.

6

• Update—Perform a modules update.

• Upgrade—Download and install the latest version of your ESET security product. If the product was

activated before upgrading, it remains activated after the upgrade. You will need to specify the product ESET

Endpoint Antivirus (EEA), ESET Endpoint Security (EES), ESET File Security for Windows Server (EFSW) and

ESET Mail Security for Exchange Server (EMSX).

• Configure—Configure your ESET product's settings. To set up this On-demand script, you must create a

configuration file by exporting the setting from a properly configured endpoint or the configuration engine.

When this script is set up, you can configure each endpoint with your desired settings.

Install and activate

To install and activate a supported ESET product on your Windows workstations:

1. In the NinjaOne console, click Administration > Policies > Agent Policies.

2. In the Agent Policies section, select the Windows policy.

3. In the next window, click Scheduled Scripts > Add a Scheduled Script.

4. Type the Name and a Description for the scheduled script.

5. In the Schedule drop-down menu, select Run Once Immediately.

6. Click Add Script.

7

7. Click the ESET—Windows category and select the applicable script.

8. Next to Preset Parameter, type: INSTALL -product EES -activation XXXX-XXXX-XXXX-XXXX-

XXXX. Replace the Xs with your License Key or your EBA/EMA2 (or similar) credentials: INSTALL -product

EES -activation "username password publicLicenseID". Replace EES with your desired product:

8

ESET Endpoint Antivirus (EEA), ESET Endpoint Security (EES), ESET File Security for Windows Server (EFSW) and

ESET Mail Security for Exchange Server (EMSX).

Forbidden characters

Some special characters in your password may cause the ESET plugin script to fail. Do not use the following

characters in your password: ! $ & ` > < ; \ |

9. In the Run As drop-down menu, select System.

10. Click Apply.

11. Click Add.

12. Click Save.

Note

Two-Factor Authentication may be required to save changes.

13. When saved, click Close to leave the Policy Editor.

You have created an install with activate script in NinjaOne for Windows. We recommend creating a separate On-

demand script for each product if you plan to use different ESET products in your environment.

Uninstall

To uninstall a supported ESET product from your Windows workstations:

1. In the NinjaOne console, click Administration > Policies > Agent Policies.

2. In the Agent Policies section, select the Windows policy.

9

3. In the next window, click Scheduled Scripts > Add a Scheduled Script.

4. Type the Name and a Description for the scheduled script.

5. In the Schedule drop-down menu, select Run Once Immediately.

6. Click Add Script.

10

7. Click the ESET—Windows category and select the applicable script.

8. Next to Preset Parameters, type: UNINSTALL.

9. In the Run As drop-down menu, select System.

11

10. Click Apply.

11. Click Add.

12. Click Save.

Note

Two-Factor Authentication may be required to save changes.

13. When saved, click Close to leave the Policy Editor.

You have created an uninstall script in NinjaOne for Windows. We recommend creating a separate On-demand

script for each product if you plan to use different ESET products in your environment.

Activate

To activate your supported ESET product on your Windows workstations with your License Key:

1. In the NinjaOne console, click Administration > Policies > Agent Policies.

2. In the Agent Policies section, select the Windows policy.

3. In the next window, click Scheduled Scripts > Add a Scheduled Script.

4. Type the Name and a Description for the scheduled script.

5. In the Schedule drop-down menu, select Run Once Immediately.

12

6. Click Add Script.

7. Click the ESET—Windows category and select the applicable script.

8. Next to Preset Parameters, type: ACTIVATE -activation XXXX-XXXX-XXXX-XXXX-XXXX. Replace the

13

Xs with your License Key or EBA/EMA2 (or similar) credentials: ACTIVATE -activation "username

password publicLicenseID".

Forbidden characters

Some special characters in your password may cause the ESET plugin script to fail. Do not use the following

characters in your password: ! $ & ` > < ; \ |

9. In the Run As drop-down menu, select System.

10. Click Apply.

11. Click Add.

12. Click Save.

Note

Two-Factor Authentication may be required to save changes.

13. When saved, click Close to leave the Policy Editor.

You have created an activation script in NinjaOne for Windows.

Deactivate

To deactivate the License Key of your supported ESET product on your Windows workstations:

1. In the NinjaOne console, click Administration > Policies > Agent Policies.

2. In the Agent Policies section, select the Windows policy.

14

3. In the next window, click Scheduled Scripts > Add a Scheduled Script.

4. Type the Name and a Description for the scheduled script.

5. In the Schedule drop-down menu, select Run Once Immediately.

6. Click Add Script.

15

7. Click the ESET—Windows category and select the applicable script.

8. Next to Preset Parameters, type: DEACTIVATE.

9. In the Run As drop-down menu, select System.

16

10. Click Apply.

11. Click Add.

12. Click Save.

Note

Two-Factor Authentication may be required to save changes.

13. When saved, click Close to leave the Policy Editor.

You have created a deactivate script in NinjaOne for Windows.

Scan

To scan all files and folders (or scan specific files and folders) on your Windows workstations using the Smart Scan

profile:

1. In the NinjaOne console, click Administration > Policies > Agent Policies.

2. In the Agent Policies section, select the Windows policy.

3. In the next window, click Scheduled Scripts > Add a Scheduled Script.

4. Type the Name and a Description for the scheduled script.

5. In the Schedule drop-down menu, select Run Once Immediately.

17

6. Click Add Script.

7. Click the ESET—Windows category and select the applicable script.

8. You can scan all files and folders or just specific ones.

Page is loading ...

ESET DEM plugins DEM plugin Owner's manual

ESET DEM plugins DEM plugin Owner's manual

Related papers