Изменение параметров задач

Вы можете выводить текущие значения параметров задачи в консоль или в конфигурационный файл. Этот файл затем можно использовать для изменения параметров задачи.

Вывести в консоль текущие значения параметров задачи

kesl-control --get-settings <task ID|name>

Где:

• <task ID|name> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.

Вывести в конфигурационный файл текущие значения параметров задачи

kesl-control --get-settings <task ID/name> --file <path to configuration file> [--json]

Где:

• --file <path to configuration file> – путь к конфигурационному файлу, в который будут выведены параметры задачи. Если вы укажете имя файла без пути, файл будет создан в текущей директории. Если файл существует по указанному пути, он будет перезаписан. Если указанной директории не существует, конфигурационный файл не будет создан.
• --json – выводить параметры в файл формата JSON. Если вы не укажете ключ --json, параметры будут выведены в формате INI.

1. Выведите параметры задачи в конфигурационный файл с помощью команды:

   kesl-control --get-settings --file <path to configuration file> [--json]

   где:

   • --file <path to configuration file> – полный путь к конфигурационному файлу, из которого будут импортированы параметры задачи.
   • --json – укажите этот ключ, если вы хотите вывести параметры в конфигурационный файл формата JSON. Если вы не укажете ключ --json, приложение выведет параметры в файла формата INI.
2. Откройте конфигурационный файл, измените значения нужных параметров и сохраните изменения.

   Для задач типа OAS, ODS, OAFIM, ODFIM и AntiCryptor вы можете добавлять или удалять области проверки и области исключения.

   Если вы хотите добавить область проверки, добавьте в файл секцию [ScanScope.item_#] со следующими параметрами:

   • AreaDesc – описание области проверки, содержащее дополнительную информацию об этой области.
   • UseScanArea – включить проверку указанной области.
   • Path – путь к директории с проверяемыми объектами. Вы можете указывать путь к локальной директории или включать проверку удаленных директорий, смонтированных на клиентском устройстве.
   • AreaMask.item_# – ограничение области проверки. Вы можете указать маску имени файлов, которые нужно проверять. По умолчанию проверка включена для всех объектов области проверки. Вы можете указать несколько элементов AreaMask.item_#.

   Если вы хотите добавить область исключения, добавьте в файл секцию [ExcludedFromScanScope.item_#] со следующими параметрами:

   • AreaDesc – описание области исключения, содержащее дополнительную информацию об области исключения.
   • UseScanArea – включить исключение указанной области.
   • Path – путь к директории с исключаемыми объектами. Вы можете указывать путь к локальной директории или исключать удаленные директории, смонтированные на клиентском устройстве. Возможные значения параметра зависят от типа задачи.
   • AreaMask.item_# – ограничение области исключения. Вы можете указать маску имени файлов, которые вы хотите исключить из области проверки. По умолчанию исключаются все объекты области.

     Пример

     [ExcludedFromScanScope.item_0000]

     AreaDesc=

     UseScanArea=Yes

     Path=/tmp/notchecked

     AreaMask.item_0000=*

   Вы можете указать несколько секций [ScanScope.item_#] и [ExcludedFromScanScope.item_#]. Приложение будет обрабатывать области по индексу в порядке возрастания.

3. Выполните команду:

   kesl-control --set-settings <task ID/name> --file <path to configuration file> [--json]

   где:

   • <task ID/name> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.
   • --file <path to configuration file> – полный путь к конфигурационному файлу, из которого будут импортированы параметры задачи.
   • --json – укажите этот ключ, если вы импортируете параметры из конфигурационного файла формата JSON. Если вы не укажете ключ --json, приложение попытается выполнить импорт из файла формата INI. При невозможности импорта отображается ошибка.

Все значения параметров задачи, заданные в файле, будут импортированы в приложение.

Если в параметрах задачи Контроль приложений вы меняете разрешающий список или запрещаете запуск всех приложений и/или приложений, влияющих на работу приложения Kaspersky Endpoint Security, требуется запускать команду --set-settings с ключом --accept.

Выполните команду:

kesl-control --set-settings <task ID|name> <setting name >=<setting value> [<setting name >=<setting value>]

Где:

• <task ID|name> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.
• <setting name >=<setting value> – имя и значение одного из параметров задачи. Текущие значения параметров задачи вы можете получить с помощью команды вывода параметров задачи.

Значения указанных параметров задачи будут изменены.

Если в параметрах задачи Контроль приложений вы меняете разрешающий список или запрещаете запуск всех приложений и/или приложений, влияющих на работу приложения Kaspersky Endpoint Security, требуется запускать команду --set-settings с ключом --accept.

Добавить область проверки с помощью ключей командной строки

kesl-control --set-settings <task ID|name> --add-path <path>

Где:

• <task ID|name> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.
• <path> – путь к директории с проверяемыми объектами.

В результате выполнения команды в параметры задачи будет добавлена новая секция [ScanScope.item_#]. Приложение будет проверять объекты в директории, указанной параметром Path. Остальные параметры области проверки принимают значения по умолчанию.

Если в параметрах задачи уже есть секция [ScanScope.item_#] с указанным значением параметра Path, дублирующая секция не добавляется.

Если для параметра UseScanArea установлено значение No, после выполнения этой команды значение изменится на Yes и будет выполняться проверка объектов, расположенных в этой директории.

Пример добавления директории /home в область проверки для задачи с ID=100

kesl-control --set-settings 100 ScanScope.item_0000.UseScanArea=Yes ScanScope.item_0000.Path=/home

В задачу будут добавлены следующие параметры области проверки:

[ScanScope.item_0001]

AreaDesc=

UseScanArea=Yes

Path=/home

AreaMask.item_0000=*

Удалить область проверки с помощью ключей командной строки

kesl-control --set-settings <task ID|name> --del-path <path>

В результате выполнения команды из параметров задачи будет удалена секция [ScanScope.item_#], содержащая указанный путь. Приложение не будет проверять объекты в указанной директории.

Добавить область исключения с помощью ключей командной строки

kesl-control --set-settings <task ID|name> --add-exclusion <path>

Где:

• <task ID|name> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.
• <path> – путь к директории с исключаемыми объектами.

В результате выполнения команды в параметры задачи будет добавлена новая секция [ExcludedFromScanScope.item_#]. Приложение будет исключать из проверки объекты в директории, указанной параметром Path. Остальные параметры области исключения принимают значения по умолчанию.

Если в параметрах задачи уже есть секция [ExcludedFromScanScope.item_#] с указанным значением параметра Path, дублирующая секция не добавляется.

Если для параметра UseScanArea установлено значение No, после выполнения этой команды значение изменится на Yes и объекты, расположенные в этой директории, будут исключаться из проверки.

Удалить область исключения с помощью ключей командной строки

kesl-control --set-settings <task ID|name> --del-exclusion <path>

В результате выполнения команды из параметров задачи будет удалена секция [ExcludedFromScanScope.item_#], содержащая указанный путь. Приложение не будет исключать из проверки объекты в указанной директории.

Выполните команду:

kesl-control --set-settings <task ID|name> --set-to-default

Где <task ID|name> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.

Приложение изменит значения параметров на заданные по умолчанию.