Автоматическая настройка HWID для разных инфраструктур

В версии Staffcop Enterprise 5.5 для Windows‑агентов 5.8.2583+ реализованы новые механизмы присвоения HWID с помощью параметров. Они позволяют:

  • присваивать HWID одному агенту;

  • массово присваивать HWID нескольким агентам;

  • выбирать тип HWID для разных инфрастуктур.

Примечание

Другие способы настройки HWID описаны в статье Настройка HWID. Они не позволяют указать тип HWID — только сбросить или изменить текущее значение. Кроме этого, с помощью этих способов нельзя массово назначать HWID.

Способы передачи параметров

Настроить тип и присвоить HWID можно двумя способами:

Типы HWID

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

  • HWID — идентификатор на основе уникальных аппаратных данных компьютера в формате GUID, например: 076ee660-54b6-49c3-baaf-b0f8bb81f9e1.

    Сохраняется в реестре, не изменяется при смене имени или настроек сети. При удалении генерируется повторно.

    Используйте на стационарных компьютерах с неизменяемой конфигурацией железа.

  • HWID-FQDN — идентификатор на основе доменного имени компьютера в нижнем регистре.

    Сохраняется в реестре и не меняется. При удалении из реестра генерируется повторно.

    Используйте на виртуальных машинах и шаблонных образах, у которых совпадают аппаратные HWID.

  • FQDN — динамический идентификатор на основе полного доменного имени компьютера.

    Не сохраняется и не читается из реестра. Генерируется при каждом запуске агента. При удалении из реестра заново не создается.

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

Примечание

По умолчанию устанавливается HWID на основе аппаратных данных (GUID).

Посмотреть идентификаторы агентов можно в ветке реестра: [HKEY_LOCAL_MACHINE\SYSTEM\SCHWID].

  • hwid — значение идентификатора устройства. Способ его формирования определяется параметром use_fqdn.

  • use_fqdn — определяет алгоритм формирования идентификатора. Может принимать следующие значения:

    • 0 или отсутствие параметра — HWID;

    • 1 — HWID-FQDN;

    • 2 — FQDN.

Передача параметров через команду msiexec

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

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

  • DROPHWID:

    • DROPHWID=1 — удаляет текущий HWID и генерирует новое значение.

    • DROPHWID=0 — не удаляет текущий идентификатор.

При некорректном значении тип HWID не изменится, а в логе инсталлятора появится сообщение.

  • HWIDMODE:

    • HWIDMODE=HWID, HWIDMODE=HWIDFQDN, HWIDMODE=FQDN — задает тип HWID. При некорректном значении в логе будет сообщение об ошибке.

Пример команды, которая удалит текущий HWID и установит HWID-FQDN:

msiexec.exe /norestart /l*vx install.log /qn /i "C:\Windows\agent.msi" GATE_URL="staffcop_server" GATE_URL2="staffcop_server_reserve" GATE_PORT=port GATE_PORT2=port2 ALLUSERS=1 REBOOT=ReallySuppress DROPHWID=1 HWIDMODE=HWIDFQDN

Примечание

Если параметры указаны и в названии MSI-файла, и в командной строке, приоритет будет у параметров командной строки.

Передача параметров при отложенной установке

Новые параметры можно применять при отложенной установке.

Пример команды, которая сбросит HWID и применит параметр HWID-FQDN после перезагрузки системы:

msiexec.exe /i "Agent.msi" /qn /l*vx "install.log" GATE_URL="main.server.url" ALLUSERS=1 REBOOT=ReallySuppress REINSTALLMODE=amus DROPHWID=1 HWIDMODE=HWIDFQDN AGENT_FORCE_REBOOT=delayed

Передача параметров через название MSI-файла

Этот способ позволяет генерировать HWID и его тип через изменение имени установочного MSI-файла. Достаточно добавить параметры в название. Они будут автоматически извлечены и применены при запуске установки.

Способ подходит:

  • для удаленной установки через утилиту версии 1.2.0.18+;

  • локальной установки через инсталлятор агента.

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

  • drophwid— удаляет текущий HWID из реестра и генерирует новое значение;

  • hwidmode=hwid, hwidmode=hwidfqdn или hwidmode=fqdn — указывает тип HWID.

Правила указания параметров:

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

  • один или оба параметра могут отсутствовать;

  • если параметр не указан или указан некорректно, тип идентификатора не изменится, а в логе инсталлятора появится сообщение о некорректном значении;

  • при установке через утилиту: сервер извлекает параметры HWID из названия MSI‑файла, но игнорирует указанные в нем URL‑адреса серверов — они берутся из настроек самой утилиты;

  • если у вас есть резервный сервер, укажите его внутри квадратных скобок в фигурных кнопках {}; адрес основного сервера задается в квадратных скобках []:

    • IPv4-адрес сервера:

    Agent-5.8.2585-[10.10.14.241{10.10.12.114}].msi

    • DNS-имя сервера:

    Agent-5.8.2585-[main.server{reserve.server}].msi

Пример названия файла, которое заменит старый HWID на HWID-FQDN:

Agent[main.server.url{reserve.server.url}]-drophwid-hwidmode=hwidfqdn.msi

где знак «минус» (-) — разделительный символ.

Примечание

Для более развернутых настроек обратитесь в техническую поддержку.

Предупреждение

Не используйте переименованный MSI-файл для операции Repair, если у него тот же Product Code. Операция завершится с ошибкой, потому что Windows Installer не сможет найти правильный установочный файл по исходному имени.

Последнее обновление: 15.04.26