Средство обслуживания иерархии (Preinst.exe) для Configuration Manager

Статья
04/04/2023

Относится к Configuration Manager (Current Branch)

Средство обслуживания иерархии (Preinst.exe) передает команды в диспетчер иерархии Configuration Manager во время выполнения службы Hierarchy Manager. Средство обслуживания иерархии устанавливается автоматически при установке сайта Configuration Manager. Вы можете найти Preinst.exe в папке \bin\X64\00000409 на сервере сайта.

Используйте средство обслуживания иерархии в следующих сценариях:

Если требуется безопасный обмен ключами, существуют ситуации, когда необходимо вручную выполнить первоначальный обмен открытыми ключами между сайтами. Дополнительные сведения см. в статье Обмен открытыми ключами между сайтами вручную.
Удалите активные задания для целевого сайта, который больше недоступен.
Удалите сервер сайта из консоли Configuration Manager, если его невозможно удалить с помощью программы установки. Например, если вы физически удаляете сайт Configuration Manager без предварительного запуска программы установки для удаления сайта. Сведения о сайте по-прежнему будут существовать в базе данных родительского сайта, и родительский сайт будет продолжать пытаться взаимодействовать с дочерним сайтом. Чтобы устранить эту проблему, запустите средство обслуживания иерархии и вручную удалите дочерний сайт из базы данных родительского сайта.
Остановите все службы Configuration Manager на сайте без необходимости останавливать службы по отдельности.
При восстановлении сайта используйте CHILDKEYS параметр для распространения открытых ключей с нескольких дочерних сайтов на восстанавливающийся сайт.

Чтобы запустить средство обслуживания иерархии, текущему пользователю требуются права администратора на локальном компьютере. Кроме того, пользователь должен явно иметь право администрирования безопасности для класса Site . Недостаточно того, чтобы пользователь наследовал это право, будучи членом группы, которая имеет это разрешение.

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

При использовании средства обслуживания иерархии его необходимо запустить локально на сайте центра администрирования (CAS), первичном сайте или сервере вторичного сайта. Используйте следующий синтаксис: preinst.exe /<option>. Доступны следующие параметры командной строки:

/DELJOB <SiteCode>: удалите все задания или команды с текущего сайта на указанный целевой сайт.
/DELSITE <ChildSiteCodeToRemove>: используйте этот параметр на родительском сайте, чтобы удалить данные дочерних сайтов из базы данных родительского сайта. Как правило, этот параметр используется, если компьютер сервера сайта выведен из эксплуатации перед удалением сайта с него.

Примечание.

Параметр /DELSITE не удаляет сайт на компьютере, указанном параметром ChildSiteCodeToRemove . Этот параметр удаляет только сведения о сайте из базы данных сайта Configuration Manager.
/DUMP <SiteCode>: используйте этот параметр на локальном сервере сайта для записи образов элементов управления сайтом в корневую папку диска, на котором установлен сайт. Вы можете написать в папку определенный образ элемента управления сайтом или все файлы элементов управления сайтом в иерархии.
- /DUMP <SiteCode> записывает образ элемента управления сайтом только для указанного сайта.
- /DUMP записывает файлы элементов управления сайтом для всех сайтов.
Изображение — это двоичное представление файла элемента управления сайтом, которое хранится в базе данных сайта Configuration Manager. Образ файла дампа элемента управления сайтом — это сумма базового образа и ожидающих разностных образов.

После дампа образа файла элемента управления сайтом с помощью средства обслуживания иерархии имя файла будет в формате sitectrl_<SiteCode>.ct0.
/STOPSITE: используйте этот параметр на локальном сервере сайта, чтобы запустить цикл завершения работы службы Configuration Manager диспетчер компонентов сайта, которая частично сбрасывает сайт. При запуске этого цикла завершения работы некоторые службы Configuration Manager на сервере сайта и его удаленных системах сайта останавливается. Он также помечает эти службы для переустановки. В результате этого цикла завершения работы некоторые пароли автоматически изменяются при переустановке служб.

Примечание.

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

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

Вы можете перезапустить службу диспетчер компонентов сайта с помощью Service Manager. После перезапуска все затронутые службы удаляются, переустановляются и перезапускаются. После использования /STOPSITE параметра запуска цикла завершения работы вы не сможете избежать циклов переустановки после перезапуска службы диспетчер компонентов сайта.
/KEYFORPARENT: распространение открытого ключа сайта на родительский сайт.

Параметр /KEYFORPARENT помещает открытый ключ сайта в файл <SiteCode>.CT4 в корне диска файлов программы. После запуска preinst.exe с этим параметром вручную скопируйте этот файл в папку родительского сайта \Inboxes\hman.box (не hman.box\pubkey).
/KEYFORCHILD: распространить открытый ключ сайта на дочерний сайт.

Параметр /KEYFORCHILD помещает открытый ключ сайта в файл <SiteCode>.CT5 в корне диска файлов программы. После запуска preinst.exe с этим параметром вручную скопируйте этот файл в папку дочернего сайта \Inboxes\hman.box (не hman.box\pubkey).
/CHILDKEYS: используйте этот параметр на дочерних сайтах восстанавливаемого сайта. Он распространяет открытые ключи с нескольких дочерних сайтов на восстанавливающийся сайт.

Параметр /CHILDKEYS помещает ключ с сайта, на котором выполняется параметр, и все это размещает открытые ключи дочерних сайтов в файл <SiteCode>.CT6. После запуска preinst.exe с этим параметром вручную скопируйте этот файл в папку восстанавливаемого \Inboxes\hman.box сайта (не hman.box\pubkey).
/PARENTKEYS: используйте этот параметр на родительском сайте восстанавливаемого сайта. Он распространяет открытые ключи со всех родительских сайтов на восстанавливающийся сайт.

Параметр /PARENTKEYS помещает ключ с сайта, на котором выполняется параметр, и ключи с каждого родительского сайта над этим сайтом в файл <SiteCode>.CT7. После запуска preinst.exe с этим параметром вручную скопируйте этот файл в папку восстанавливаемого \Inboxes\hman.box сайта (не hman.box\pubkey).

Обмен открытыми ключами между сайтами вручную

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

Если вы не расширили схему Active Directory для Configuration Manager
Configuration Manager сайты не публикуют данные сайта в Active Directory

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

Примечание.

После ручного обмена открытыми ключами просмотрите файл журнала hman.log на родительском сервере сайта. Этот файл журнала записывает изменения конфигурации сайта и публикацию сведений о сайте в Active Directory. Вы можете убедиться, что первичный сайт обработал новый открытый ключ.

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

Войдите на дочерний сервер сайта, откройте командную строку и перейдите к расположению Preinst.exe.
Введите следующую команду, чтобы экспортировать открытый ключ дочернего сайта: Preinst /keyforparent

Параметр /keyforparent помещает открытый ключ дочернего сайта в файл, <SiteCode>.CT4 расположенный в корне системного диска.

Переместите файл в <SiteCode>.CT4 папку родительского сайта \inboxes\hman.box в каталоге установки Configuration Manager.

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

Войдите на сервер родительского сайта, откройте командную строку и перейдите к расположению Preinst.exe.
Введите следующую команду, чтобы экспортировать открытый ключ родительского сайта: Preinst /keyforchild

Параметр /keyforchild помещает открытый ключ родительского сайта в файл, <SiteCode>.CT5 расположенный в корне системного диска.

Переместите файл в <SiteCode>.CT5 папку дочернего сайта \inboxes\hman.box в каталоге установки Configuration Manager.