Как управлять задачами с помощью командной строки

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

• Защита от файловых угроз. Эта задача позволяет включать и выключать защиту от файловых угроз в реальном времени и определяет параметры компонента Защита от файловых угроз. Задача запускается автоматически при запуске приложения.
• Поиск вредоносного ПО. Эта задача позволяет выполнять проверку объектов файловой системы на наличие вредоносного ПО по требованию и определяет параметры проверки. Вы можете использовать эту задачу для полной или выборочной проверки устройства.
• Проверка важных областей. Эта задача позволяет выполнять проверку важных областей операционной системы по требованию и определяет параметры проверки.
• Выборочная проверка файлов. Эта задача предназначена для настройки и хранения параметров, которые используются во время проверки указанных файлов и директорий по команде kfl-control --scan-file. В результате выполнения команды приложение создает и запускает временную задачу проверки файлов.
• Проверка съемных дисков. Эта задача позволяет в реальном времени контролировать подключение съемных дисков к устройству и определяет параметры проверки съемных дисков и их загрузочных секторов на наличие вредоносного ПО.
• Защита от веб-угроз. Эта задача позволяет включать и выключать защиту от веб-угроз и определяет параметры работы компонента Защита от веб-угроз.
• Анализ поведения. Эта задача позволяет контролировать вредоносную активность приложений в операционной системе. Задача запускается автоматически при запуске приложения Kaspersky.
• Лицензирование. Эта задача обеспечивает возможность активировать приложение, установленное на устройстве. Задача запускается автоматически при запуске приложения и постоянно находится в оперативной памяти устройства. Задача не имеет параметров, управление лицензионными ключами реализовано с помощью специальных команд управления. Задача недоступна для запуска, остановки и удаления.
• Обновление. С помощью этой задачи вы можете выполнять обновление баз и модулей приложения по расписанию и по требованию и настраивать параметры обновления.
• Откат обновления баз. С помощью этой задачи вы можете выполнять откат последнего обновления баз и модулей приложения.

Каждая задача приложения имеет имя, используемое в командной строке, идентификатор и тип (см. таблицу ниже).

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

Имена задач не чувствительны к регистру.

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

Задачи, которые вы создаете во время работы с приложением, называются пользовательские задачи. Имена этих задач вы задаете при создании задачи. Идентификаторы пользовательских задач приложение задает и присваивает задаче при ее создании. Идентификаторы пользовательских задач начинаются со 100.

Во время работы приложение создает временные задачи проверки. Имена и идентификаторы временных задач задаются приложением. Временные задачи автоматически удаляются после завершения.

Задачи приложения

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

• Запускать и останавливать все предустановленные и пользовательские задачи, кроме задач типа License.
• Приостанавливать и возобновлять задачи типа ODS.
• Создавать и удалять пользовательские задачи. Вы можете создавать задачи следующих типов: ODS, Update, Rollback.
• Изменять параметры всех пользовательских задач и всех предустановленных задач, кроме задач типов Rollback и License.
• Настраивать расписание запуска задач.

Как просмотреть список задач в командной строке

Чтобы просмотреть список задач приложения, выполните следующую команду:

kfl-control --get-task-list [--json]

где:

--json – формат вывода списка задач приложения. Если вы не укажете формат, вывод будет выполнен в формате INI.

Отобразится список задач приложения Kaspersky.

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

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

Как просмотреть состояние задачи в командной строке

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

kfl-control --get-task-state <идентификатор/имя задачи> [--json]

где:

• <идентификатор/имя задачи> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.
• --json – выводить параметры в формате JSON.

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

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

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

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

Как создать задачу в командной строке

Вы можете создавать задачи следующих типов: ODS, Update и Rollback.

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

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

kfl-control -create-task <имя задачи> --type <тип задачи>

где:

• <имя задачи> – имя, которое вы задаете для новой задачи;
• <тип задачи> – обозначение типа создаваемой задачи.

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

kfl-control --create-task <имя задачи> --type <тип задачи> --file <путь к конфигурационному файлу> [--json]

где:

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

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

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

Вы можете приостанавливать и возобновлять задачи типа ODS.

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

kfl-control --start-task <идентификатор/имя задачи> [-W] [--progress]

где:

• <идентификатор/имя задачи> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.
• [-W] – используйте эту команду совместно с командой запуска задачи, если вы хотите включить вывод текущих событий, связанных с этой задачей.
• [--progress] – укажите этот ключ, если вы хотите отображать ход выполнения задачи.

  Пример: Запустить задачу с идентификатором 1 и включить вывод текущих событий, связанных с задачей: kfl-control --start-task 1 -W

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

kfl-control --stop-task <идентификатор/имя задачи> [-W]

где:

• <идентификатор/имя задачи> – идентификатор, присвоенный задаче в момент создания, или имя задачи в командной строке.
• [-W] – используйте эту команду совместно с командой остановки задачи, если вы хотите включить вывод текущих событий, связанных с этой задачей.

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

kfl-control --suspend-task <идентификатор/имя задачи>

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

kfl-control --resume-task <идентификатор/имя задачи>

Как удалить задачу в командной строке

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

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

kfl-control --delete-task <идентификатор/имя задачи>

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

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

Вы можете выводить текущие значения параметров всех пользовательских задач и всех предустановленных задач, кроме задач Rollback и License (эти задачи не имеют параметров).

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

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

kfl-control --get-settings <идентификатор/имя задачи> [--json]

где:

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

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

kfl-control --get-settings <идентификатор/имя задачи> --file <путь к конфигурационному файлу> [--json]

где:

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