Команды управления задачами

kesl-control --get-task-list

Команда позволяет вывести список существующих задач приложения.

kesl-control [-T] --get-task-list [--json]

Где:

--json – выводить параметры в формате JSON.

Для каждой задачи отображается следующая информация:

• Name – имя задачи.
• ID – идентификатор задачи.
• Type – тип задачи.
• State – текущее состояние задачи.

Если политика Kaspersky Security Center запрещает пользователям просматривать и изменять локальные задачи, информация о задачах Scan_My_Computer, Critical_Areas_Scan, Container_Scan, Inventory_Scan, Update и Rollback недоступна.

kesl-control --get-task-state

Команда позволяет вывести состояние указанной задачи.

kesl-control [-T] --get-task-state <task ID|name> [--json]

Где:

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

--json – выводить параметры в формате JSON.

Для задач приложения предусмотрены следующие состояния:

• Started – задача запущена
• Starting – задача запускается
• Stopped – задача остановлена
• Stopping – задача останавливается

Задачи типов ODS, ODFIM и InventoryScan могут также находиться в одном из следующих состояний:

• Pausing – приостанавливается
• Suspended – приостановлена
• Resuming – возобновляется

kesl-control --create-task

Команда позволяет создать задачу указанного типа с параметрами по умолчанию или с параметрами, указанными в конфигурационном файле.

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

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

• стандартный режим: ODS, Update, Rollback, ODFIM, ContainerScan и InventoryScan;
• режим Легкого агента: ODS, ODFIM, ContainerScan и InventoryScan.

Создать задачу с параметрами по умолчанию

kesl-control [-T] --create-task <task name> --type <task type>

Создать задачу с параметрами из конфигурационного файла

kesl-control [-T] --create-task <task name> --type <task type> [--file <path to file>] [--json]

Где:

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

<task type> – обозначение типа создаваемой задачи.

--file <path to file> – полный путь к конфигурационному файлу, параметры из которого будут использоваться при создании задачи.

--json – импортировать параметры из конфигурационного файла формата JSON. Если вы не укажете ключ --json, приложение попытается выполнить импорт из файла формата INI. При невозможности импорта отображается ошибка.

kesl-control --delete-task

Команда позволяет удалить задачу.

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

kesl-control [-T] --delete-task <task ID|name>

Где:

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

kesl-control --start-task

Команда позволяет запустить задачу.

Можно запускать все предустановленные и пользовательские задачи, кроме задачи типа License.

kesl-control [-T] --start-task <task ID|name> [-W] [--progress]

Где:

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

-W – включить вывод текущих событий.

--progress – отображать ход выполнения задачи.

Пример запуска задачи с идентификатором 1 и включением вывода текущих событий, связанных с задачей

kesl-control --start-task 1 -W

Если при запуске задачи произошла ошибка и задача не запустилась, то после перезапуска приложения выполняется повторная попытка запуска задачи.

kesl-control --stop-task

Команда позволяет остановить задачу.

Можно останавливать все предустановленные и пользовательские задачи, кроме задачи типа License.

kesl-control [-T] --stop-task <task ID|name> [-W]

Где:

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

-W – включить вывод текущих событий.

kesl-control --suspend-task

Команда позволяет приостановить задачу.

Можно приостановить только задачи типов ODS, ODFIM и InventoryScan.

kesl-control [-T] --suspend-task <task ID|name>

Где:

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

kesl-control --resume-task

Команда позволяет возобновить выполнение задачи.

Можно возобновить только задачи типов ODS, ODFIM и InventoryScan.

kesl-control [-T] --resume-task <task ID|name>

Где:

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

kesl-control --scan-file

Команда позволяет создать и запустить задачу выборочной проверки.

kesl-control [-T] --scan-file <path> [--action <action>]

Где:

<path> – путь к файлу или директории, которые нужно проверить. Вы можете указать несколько путей, разделяя их пробелами.

--action <action> – действие, которое приложение будет выполнять над зараженными объектами. Если вы не укажете ключ --action, приложение будет выполнять рекомендуемое действие.

kesl-control --scan-container

Команда позволяет создать и запустить задачу выборочной проверки контейнера или образа.

kesl-control [-T] --scan-container <ID|name[:tag]>

Где:

<ID|name[:tag]> – имя или идентификатор контейнера или образа. Для проверки нескольких объектов можно использовать маски.

Полезные статьи

Как задавать маски