Kickidler Agent 2.0 для Windows — удалённая и массовая установка

Kickidler Agent 2.0 для Windows — удалённая и массовая установка


1. Назначение

Этот документ описывает базовый порядок удалённой установки Kickidler Agent 2.0 на рабочие станции Windows.

Инструкция предназначена для системных администраторов, которые выполняют массовое развёртывание через:

  • групповые политики Windows;
  • Kaspersky Security Center;
  • Microsoft Configuration Manager;
  • PDQ Deploy;
  • UEM / RMM-системы;
  • другие средства централизованного развёртывания ПО.

2. Важные ограничения для GPO и MST

ПРЕДУПРЕЖДЕНИЕ

На текущий момент не используйте прямое назначение MSI через стандартный раздел GPO: «Конфигурация компьютера → Политики → Настройки программного обеспечения → Установка программ». Такой сценарий пока не является поддерживаемым основным способом установки, потому что базовая установка MSI через этот раздел GPO не позволяет надёжно передать все необходимые параметры установки Kickidler Agent 2.0.

Также на текущий момент не используйте MST-трансформ как основной поддерживаемый сценарий.

Для развёртывания используйте один из поддерживаемых вариантов:

  • сценарий запуска GPO, который вызывает msiexec с параметрами установки;
  • Kaspersky Security Center, RMM или UEM с запуском MSI через msiexec и параметрами установки;
  • подготовленный MSI-файл с уже записанным ключом как источник пакета для Kaspersky Security Center / RMM / UEM. Этот вариант может работать в системах развёртывания, но не является гарантированным решением для прямого назначения MSI через базовый GPO Windows.

3. Перед началом

Подготовьте:

  • установочный файл Kickidler Agent 2.0 в формате.msi;
  • актуальный ключ активации из личного кабинета https://my.kickidler.ru;
  • скрипт подготовки MSI, если ключ нужно заранее записать в MSI-файл;
  • сетевой ресурс, доступный рабочим станциям по UNC-пути;
  • права локального администратора или запуск установки от имени локальной системы (Local System / SYSTEM).

Пример UNC-пути:

\\SERVER\Software\Kickidler\

MSI-файл должен быть доступен именно по сетевому UNC-пути, а не с локального диска администратора.

Права на сетевую папку должны быть выданы не только администратору, но и компьютерам, на которые будет выполняться установка.

Рекомендуемые права:

Разрешения общего ресурса:Компьютеры домена → ЧтениеРазрешения NTFS:Компьютеры домена → Чтение и выполнение

ВАЖНО

Если используется отдельная группа компьютеров, можно выдать права этой группе вместо группы «Компьютеры домена».

4. Подготовка MSI с ключом активации

Если используется скрипт подготовки MSI, ключ активации можно заранее записать в установочный файл. Это удобно, когда система развёртывания поддерживает MSI-пакеты, но не отменяет необходимость запускать установку через msiexec или штатную задачу развёртывания.

Такой вариант удобен для Kaspersky Security Center, RMM и UEM, где подготовленный MSI можно использовать как пакет. Для базового GPO Windows не используйте прямое назначение MSI: применяйте сценарий запуска, который вызывает msiexec.

Общий порядок:

  1. Создайте отдельную рабочую папку на компьютере администратора.
  2. Поместите в неё исходный MSI-файл Kickidler Agent 2.0.
  3. Поместите туда скрипт подготовки MSI.
  4. Запустите скрипт согласно инструкции к нему.
  5. Укажите ключ активации из личного кабинета my.kickidler.ru.
  6. Получите подготовленный MSI-файл.
  7. Разместите подготовленный MSI-файл на сетевом ресурсе для развёртывания.

ВАЖНО

Рекомендуется не изменять исходный MSI-файл напрямую. Лучше сохранять подготовленную копию с отдельным именем.

Пример имени:

Kickidler_Agent_2.x.x.x_configured.msi


ПРЕДУПРЕЖДЕНИЕ

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

5. Установка через сценарий запуска GPO

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

Создайте файл:

install_kickidler_agent.cmd

Пример для обычной установки MSI с записанным ключом:

@echo offset MSI_PATH=\\SERVER\Software\Kickidler\Kickidler_Agent_2.x.x.x_configured.msimsiexec /i "%MSI_PATH%" /qn /norestartexit /b %errorlevel%

Пример для скрытой установки MSI с записанным ключом:

@echo offset MSI_PATH=\\SERVER\Software\Kickidler\Kickidler_Agent_2.x.x.x_configured.msimsiexec /i "%MSI_PATH%" /qn /norestart HIDDEN_MODE=1


exit /b %errorlevel%

Если используется MSI без заранее записанного ключа, ключ можно передать через параметр:

ACTIVATION_KEY="ВАШ_КЛЮЧ"

Пример обычной установки без заранее подготовленного MSI:

msiexec /i "\\SERVER\Software\Kickidler\Kickidler_Agent_2.x.x.x.msi" /qn /norestart ACTIVATION_KEY="ВАШ_КЛЮЧ"


ВАЖНО

Для GPO используйте сценарий запуска, который вызывает msiexec. Если ключ не записан в MSI, передайте ACTIVATION_KEY в параметрах. Если ключ уже записан в MSI, параметр ACTIVATION_KEY не требуется, но установка всё равно должна запускаться через msiexec.

6. Опциональные параметры установки

В этом разделе указаны параметры, которые можно добавлять к базовой команде msiexec при необходимости.

6.1. Логирование установки

Если установка завершается с ошибкой или нужно сохранить подробный MSI-лог для диагностики, добавьте параметр:

/L*V "C:\Windows\Temp\kickidler_agent_install.log"

Пример обычной установки с логированием:

msiexec /i "\\SERVER\Software\Kickidler\Kickidler_Agent_2.x.x.x_configured.msi" /qn /norestart /L*V "C:\Windows\Temp\kickidler_agent_install.log"

Пример скрытой установки с логированием:

msiexec /i "\\SERVER\Software\Kickidler\Kickidler_Agent_2.x.x.x_configured.msi" /qn /norestart HIDDEN_MODE=1 /L*V "C:\Windows\Temp\kickidler_agent_install.log"


ВАЖНО

Если команда запускается от имени локальной системы (Local System / SYSTEM), лог удобно сохранять в C:\Windows\Temp\.

При обращении в техническую поддержку приложите файл, если логирование было включено:

C:\Windows\Temp\kickidler_agent_install.log

6.2. Скрытый режим установки

Для скрытой установки добавьте параметр:

HIDDEN_MODE=1

Пример:

msiexec /i "\\SERVER\Software\Kickidler\Kickidler_Agent_2.x.x.x_configured.msi" /qn /norestart HIDDEN_MODE=1


ВАЖНО

Используйте этот параметр только если агент нужно установить в скрытом режиме.

6.3. Передача ключа активации

Если MSI не был заранее подготовлен скриптом, ключ активации можно передать параметром:

ACTIVATION_KEY="ВАШ_КЛЮЧ"

Пример:

msiexec /i "\\SERVER\Software\Kickidler\Kickidler_Agent_2.x.x.x.msi" /qn /norestart ACTIVATION_KEY="ВАШ_КЛЮЧ"


ПРЕДУПРЕЖДЕНИЕ

Не передавайте ключ активации в открытом виде в обращениях, скриншотах, логах или переписке.

6.4. Комбинированный пример

Пример скрытой установки неподготовленного MSI с передачей ключа и созданием MSI-лога:

msiexec /i "\\SERVER\Software\Kickidler\Kickidler_Agent_2.x.x.x.msi" /qn /norestart ACTIVATION_KEY="ВАШ_КЛЮЧ" HIDDEN_MODE=1 /L*V "C:\Windows\Temp\kickidler_agent_install.log"


ВАЖНО

Этот вариант используйте только для диагностики или тестового развёртывания. Для постоянного массового развёртывания предпочтительнее подготовить MSI заранее и не передавать ключ в командной строке.

7. Настройка сценария запуска GPO

  1. Откройте Управление групповой политикой.
  2. Создайте новый объект групповой политики, например: Установка Kickidler Agent 2.0.
  3. Привяжите GPO к нужному организационному подразделению (OU) с рабочими станциями.
  4. Откройте редактирование GPO.
  5. Перейдите по пути: Конфигурация компьютера → Политики → Конфигурация Windows → Сценарии (запуск/завершение) → Запуск.
  6. Откройте раздел Запуск.
  7. Нажмите Показать файлы.
  8. Скопируйте туда файл install_kickidler_agent.cmd.
  9. Нажмите Добавить.
  10. Выберите добавленный CMD-файл.
  11. Сохраните изменения.

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

Конфигурация компьютера → Политики → Административные шаблоны → Система → Вход в систему → Всегда ожидать сеть при запуске и входе в систему → Включено

После применения политики на тестовой рабочей станции выполните:

gpupdate /force

Затем перезагрузите компьютер.

ВАЖНО

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

8. Установка через Kaspersky Security Center / UEM / RMM

Этот вариант подходит для:

  • Kaspersky Security Center;
  • Microsoft Configuration Manager;
  • PDQ Deploy;
  • ManageEngine Endpoint Central;
  • NinjaOne;
  • Action1;
  • RMM-систем;
  • других систем централизованного развёртывания.

Общий порядок:

  1. Создайте новый пакет или задачу установки приложения.
  2. Укажите MSI-файл Kickidler Agent 2.0. Это может быть подготовленный MSI с записанным ключом или обычный MSI с передачей ключа через параметры.
  3. Если система поддерживает загрузку файлов внутрь пакета, добавьте MSI в пакет.
  4. Если система использует сетевой путь, укажите UNC-путь к MSI.
  5. Настройте запуск от имени локальной системы (Local System / SYSTEM).
  6. Укажите тихие параметры установки.
  7. При необходимости добавьте опциональные параметры из раздела 6.
  8. Запустите установку сначала на тестовой группе из 2–3 компьютеров.
  9. После успешной проверки примените задачу к основной группе устройств.

Пример команды для обычной установки MSI с записанным ключом:

msiexec /i "Kickidler_Agent_2.x.x.x_configured.msi" /qn /norestart

Пример команды для скрытой установки MSI с записанным ключом:

msiexec /i "Kickidler_Agent_2.x.x.x_configured.msi" /qn /norestart HIDDEN_MODE=1

Если система развёртывания разделяет поля «MSI-пакет» и «параметры MSI», в поле параметров укажите только параметры, без msiexec /i.

Пример для обычной установки:

/qn /norestart

Пример для скрытой установки:

/qn /norestart HIDDEN_MODE=1

Пример для обычной установки с логированием:

/qn /norestart /L*V "C:\Windows\Temp\kickidler_agent_install.log"

Пример для скрытой установки с логированием:

/qn /norestart HIDDEN_MODE=1 /L*V "C:\Windows\Temp\kickidler_agent_install.log"

Если используется неподготовленный MSI, дополнительно передайте ключ:

ACTIVATION_KEY="ВАШ_КЛЮЧ"

9. Базовые шаги для Kaspersky Security Center

Названия пунктов могут отличаться в зависимости от версии Kaspersky Security Center, но общий порядок обычно следующий:

  1. Откройте консоль Kaspersky Security Center.
  2. Перейдите в раздел задач или удалённой установки приложений.
  3. Создайте новую задачу установки приложения.
  4. Выберите установку приложения из MSI-пакета или через команду.
  5. Добавьте MSI-файл Kickidler Agent 2.0. Если ключ записан в MSI, отдельный параметр ACTIVATION_KEY обычно не требуется. Если ключ не записан, передайте его в параметрах установки.
  6. Укажите параметры тихой установки.
  7. Убедитесь, что задача будет выполняться от имени системной учётной записи или с правами администратора.
  8. Выберите тестовую группу компьютеров.
  9. Запустите задачу.
  10. Проверьте результат выполнения задачи и, если включали логирование, MSI-лог на целевой машине.

ВАЖНО

Если Kaspersky Security Center блокирует установку или удаляет файлы агента, необходимо проверить политики защиты, доверенную зону и исключения.

10. Исключения антивируса

Если на компьютерах используется антивирус, EDR или централизованная защита, заранее добавьте каталог установки Kickidler Agent в исключения.

Для обычной установки:

C:\Program Files\TeleLinkSoftV2

Для скрытой установки:

C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}


ПРЕДУПРЕЖДЕНИЕ

Не рекомендуется добавлять в исключения весь диск C:\, весь каталог C:\ProgramData, профиль пользователя или временные каталоги полностью.


ВАЖНО

Если защита блокирует установку, временно отключите её только в том случае, если это разрешено политиками организации. После установки защиту нужно включить обратно.

11. Проверка установки

После установки проверьте, что агент установлен и работает.

Проверка служб:

Get-Service ngs_v2,ngs_updater_v2,tls_v2,tls_updater_v2 -ErrorAction SilentlyContinue

Для обычной установки обычно используются службы:

ngs_v2ngs_updater_v2

Для скрытой установки обычно используются службы:

tls_v2tls_updater_v2

Также проверьте:

  • появился ли компьютер или сотрудник в веб-интерфейсе Kickidler;
  • получила ли рабочая станция лицензию в личном кабинете my.kickidler.ru;
  • нет ли ошибок установки в MSI-логе, если логирование было включено;
  • нет ли блокировок со стороны антивируса или EDR.

MSI-лог при включённом логировании:

C:\Windows\Temp\kickidler_agent_install.log

12. Где смотреть логи агента

Для обычной установки:

C:\Program Files\TeleLinkSoftV2\logs\agent.logC:\Program Files\TeleLinkSoftV2\logs\updater.log

Для скрытой установки:

C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}\logs\agent.logC:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}\logs\updater.log

Посмотреть последние строки основного лога обычной установки:

Get-Content 'C:\Program Files\TeleLinkSoftV2\logs\agent.log' -Tail 80

Посмотреть последние строки основного лога скрытой установки:

Get-Content 'C:\ProgramData\{9e7a7972-b921-4537-06fe-e4e40085e8ce}\logs\agent.log' -Tail 80

13. Типовые ошибки

13.1. Ошибки 1619 / 1620

MSI-файл недоступен или повреждён.

Проверьте:

  • корректность UNC-пути;
  • доступность сетевого ресурса с целевой рабочей станции;
  • права общего ресурса и NTFS;
  • что файл не заблокирован антивирусом;
  • что MSI-файл не повреждён.

13.2. Ошибка 1638

На компьютере уже установлена другая версия или конфликтующий продукт.

Проверьте:

  • установлен ли старый агент;
  • установлен ли другой продукт на той же базе;
  • не требуется ли предварительное удаление старой версии.

13.3. Ошибка 1720

Ошибка пользовательского действия MSI.

Частые причины:

  • блокировка со стороны антивируса или EDR;
  • повреждённый MSI-файл;
  • некорректно подготовленный MSI;
  • запуск без нужных прав;
  • конфликт с уже установленной версией.

13.4. Агент не появляется в веб-интерфейсе

Проверьте:

  • корректность ключа активации;
  • наличие лицензии в личном кабинете my.kickidler.ru;
  • статус служб Windows;
  • логи agent.log и updater.log;
  • доступность сервера по сети;
  • блокировки со стороны антивируса, EDR или межсетевого экрана.

14. Что передать в техническую поддержку

Если установка не выполняется или агент не появляется в веб-интерфейсе, передайте в техническую поддержку:

  • версию MSI-файла Kickidler Agent;
  • способ установки: сценарий запуска GPO, Kaspersky Security Center, RMM, ручной запуск и т. д.;
  • команду установки или параметры задачи;
  • MSI-лог установки, если логирование было включено;
  • лог агента agent.log;
  • лог обновления updater.log;
  • скриншот ошибки, если она отображается;
  • информацию о типе установки: обычная или скрытая;
  • информацию об антивирусе, EDR или политике безопасности на целевой машине.

MSI-лог при включённом логировании:

C:\Windows\Temp\kickidler_agent_install.log


ПРЕДУПРЕЖДЕНИЕ

Не отправляйте ключ активации в открытом виде в скриншотах, логах или переписке.



    • Related Articles

    • Kickidler Agent 2.0 для Windows — руководство администратора

      1. Назначение Этот документ описывает базовые действия администратора при установке, проверке, диагностике и удалении Kickidler Agent на рабочей станции Windows. Инструкция предназначена для системных администраторов, инженеров технической поддержки ...

    • Kickidler Agent 2.0 для Windows — быстрый старт по установке

      1. Назначение Этот документ поможет быстро установить Kickidler Agent на компьютер с Windows. 2. Перед установкой Подготовьте: установочный файл Kickidler Agent; ключ активации из личного кабинета my.kickidler.ru; доступ к компьютеру с правами ...

    • Kickidler Server 2.0 для Linux — руководство администратора

      1. Назначение Этот документ описывает основные административные действия по установке, проверке, диагностике и удалению Kickidler Server на Linux-серверах семейства Debian. Руководство предназначено для системных администраторов, инженеров ...

    • Быстрый старт по установке и удалению Kickidler Server 2.0 на Windows

      1. Назначение Этот документ поможет быстро установить и удалить Kickidler Server на компьютере с Windows. 2. Перед установкой Подготовьте: установочный файл Kickidler Server; ключ сервера из личного кабинета my.kickidler.ru; доступ к компьютеру с ...

    • Kickidler Agent 2.0 для macOS — быстрый старт

      1. Назначение В этой статье описана быстрая установка Kickidler Agent на компьютер с macOS. 2. Перед установкой Подготовьте: установочный файл Kickidler Agent в формате .dmg; ключ активации из личного кабинета my.kickidler.ru; доступ к Mac с правами ...