Присвоение HWID через параметры установки¶
В версии Staffcop Enterprise 5.5 для Windows‑агентов 5.8.2583+ реализован новый способ присвоения HWID с помощью параметров. Он позволяет:
присвоить HWID одному агенту;
массово присвоить HWID нескольким агентам;
выбрать тип HWID под конкретную инфраструктуру.
Примечание
Другие способы настройки HWID описаны в статье Настройка HWID. Они не позволяют указать тип HWID — только сбросить или изменить текущее значение. Кроме этого, с помощью этих способов нельзя массово назначать HWID. Они могут быть полезны, когда агент уже установлен и нужно точечно поправить идентификатор.
Зачем нужен тип HWID¶
Разные сценарии развертывания предъявляют разные требования к идентификации устройств:
на физических компьютерах идентификатор должен быть привязан к оборудованию и оставаться неизменным;
на виртуальных машинах из одного шаблона важно, чтобы у каждого экземпляра был свой идентификатор, несмотря на одинаковое «железо»;
на временных системах может требоваться, чтобы каждый запуск агента регистрировался как новое устройство.
Выбор типа HWID позволяет:
выбрать алгоритм генерации идентификатора под вашу инфраструктуру;
гарантировать уникальность HWID для клонированных машин.
Прежде чем выбрать параметр, разберитесь какой тип HWID вам нужен.
Типы HWID¶
Staffcop поддерживает три типа идентификатора, которые различаются способом формирования, степенью постоянства и областью применения.
Примечание
По умолчанию устанавливается HWID на основе аппаратных данных.
Тип |
Описание |
Когда использовать |
|---|---|---|
HWID |
Идентификатор на основе уникальных аппаратных данных компьютера |
На стационарных ПК с неизменяемой конфигурацией железа |
HWID-FQDN |
Идентификатор на основе доменного имени компьютера в нижнем регистре |
На виртуальных машинах и шаблонных образах, |
FQDN |
Динамический идентификатор на основе |
На временных системах, на которых каждый запуск |
Где хранится HWID¶
Посмотреть идентификаторы агентов можно в ветке реестра: [HKEY_LOCAL_MACHINE\SYSTEM\SCHWID].
hwid— значение идентификатора устройства. Способ его формирования определяется параметромuse_fqdn.use_fqdn— определяет алгоритм формирования идентификатора:0или отсутствие параметра — HWID;1— HWID-FQDN;2— FQDN.
Способы передачи параметров¶
Когда вы определились с типом HWID, выберите способ передачи параметров. Он зависит от того, как вы устанавливаете агент. Настроить тип и присвоить HWID можно двумя способами:
через команду msiexec в командной строке — используйте этот способ при Тихой установке и установки из Active Directory;
изменение названия установочного MSI-файла — подходит для установки через Утилиту удаленной установки и Локальную установку.
Передача параметров через команду 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 не сможет найти правильный установочный файл по исходному имени.
Последнее обновление: 29.09.26