Ключи файла сценария автоматической установки
Относится к Configuration Manager (Current Branch)
В этой статье определяются все ключи и значения, которые необходимо указать в файле скрипта .ini установки. Используйте этот файл с параметром /SCRIPT командной строки для автоматической установки или восстановления сайта Configuration Manager. В таблицах этой статьи показано следующее:
- Доступные ключи скрипта установки и соответствующие им значения
- Если они необходимы
- Тип установки, для которого они используются
- Краткое описание ключа
Дополнительные сведения см. в следующих статьях:
Укажите имена разделов в квадратных скобках ([]): [<Section name>]. Например, [Identification].
При указании значений для ключей за именем ключа должен следовать знак равенства (=) и значение ключа: <Key name>=<Value>. Например, CDLatest=1. Убедитесь, что ключи находятся в соответствующем разделе.
Каждый раздел и каждое значение должны быть уникальными в одном скрипте. Например, может быть только один [Identification] раздел и только один Action ключ.
Поддерживаемые действия
Скрипт в основном определяется ключом Action в Identification разделе . В следующем списке перечислены все поддерживаемые в настоящее время действия для автоматического запуска программы установки.
-
InstallCAS: установка сайта центра администрирования (CAS) -
InstallPrimarySite: установка первичного сайта -
ManageLanguages: добавление или удаление клиентских и серверных языков -
RecoverPrimarySite: восстановление первичного сайта -
RecoverCCAR: восстановление CAS
Установка сайта
Identification раздел для установки сайта
В зависимости от типа устанавливаемого сайта добавьте в раздел следующие ключи с соответствующими значениями Identification :
| Имя ключа | Обязательный | Значения | Details |
|---|---|---|---|
Action |
Да | - InstallPrimarySite- InstallCAS |
— Установка первичного сайта. — Установка сайта центра администрирования (CAS) |
CDLatest |
Да 2 |
1: программа установки выполняется из CD.Latest |
При запуске программы установки из CD.Latest папки включите этот ключ и значение. Это значение сообщает программе установки о том, что вы используете носитель из CD.Latest. |
Примечание 2. Обязательный CDLatest
Ключ CDLatest требуется только при запуске программы установки из CD.Latest папки для установки первичного сайта или сайта центра администрирования. Дополнительные сведения см. в разделе Сведения о файле скрипта командной строки.
Options раздел для установки сайта
Добавьте следующие ключи в раздел Параметры , чтобы установить сайт:
| Имя ключа | Обязательный | Значения | Details |
|---|---|---|---|
ProductID |
Да |
-
xxxxx-xxxxx-xxxxx-xxxxx-xxxxx: допустимый ключ продукта с дефисами.- Eval: установка ознакомительной версии |
Тип устанавливаемой лицензии. |
SiteCode |
Да | Три символьных кода, например XYZ |
Код сайта из трех символов, который однозначно идентифицирует сайт в иерархии. |
SiteName |
Да | Имя сайта | Понятное имя для этого сайта, чтобы помочь идентифицировать его. |
SMSInstallDir |
Да | Путь к локальному каталогу | Папка установки для Configuration Manager программных файлов. |
SDKServer |
Да | Полное доменное имя поставщика SMS | Полное доменное имя первого сервера, на котором размещен поставщик SMS. |
PrerequisiteComp |
Да |
-
0:Скачать- 1: уже скачан |
Укажите, были ли уже скачаны необходимые файлы. Если используется значение 0, программа установки скачивает файлы. |
PrerequisitePath |
Да | Путь к локальному каталогу | Путь к необходимым файлам. В зависимости PrerequisiteComp от значения программа установки использует этот путь для хранения скачанных файлов или поиска ранее скачанных файлов. |
AdminConsole |
Да |
-
0: не устанавливайте- 1:Установить |
Укажите, следует ли установить консоль Configuration Manager на сервере сайта. |
JoinCEIP |
Да | 0 |
Хотя поддержка программы улучшения качества программного обеспечения (CEIP) была удалена из продукта, этот ключ по-прежнему необходим. |
MobileDeviceLanguage |
Да |
-
0: не устанавливайте- 1:Установить |
Укажите, установлены ли клиентские языки мобильных устройств. |
При установке сайта можно также указать ключи для управления языками, такими как AddServerLanguages или AddClientLanguages. Дополнительные сведения см. в Options разделе о языках.
Следующие ключи Options в разделе относятся к основному сайту:
| Имя ключа | Обязательный | Значения | Details |
|---|---|---|---|
ManagementPoint |
Нет | Полное доменное имя MP | Полное доменное имя сервера, на котором будет размещена первая роль системы сайта точки управления (MP). |
ManagementPointProtocol |
Нет |
HTTPS или HTTP |
Протокол, используемый для mp. |
DistributionPoint |
Нет | Полное доменное имя DP | Полное доменное имя сервера, на котором будет размещена первая роль системы сайта точки распространения (DP). |
DistributionPointProtocol |
Нет |
HTTPS или HTTP |
Протокол, используемый для DP. |
DistributionPointInstallIIS |
Нет |
-
0: не устанавливайте- 1:Установить |
Укажите, следует ли устанавливать СЛУЖБЫ IIS на DP. |
RoleCommunicationProtocol |
Да |
EnforceHTTPS или HTTPorHTTPS |
Укажите, следует ли настроить все системы сайта для приема только httpS-связи от клиентов или настроить метод связи для каждой роли системы сайта. Если выбран параметр EnforceHTTPS, клиентам требуется действительный сертификат инфраструктуры открытых ключей (PKI) для проверки подлинности клиента. |
ClientsUsePKICertificate |
Да |
-
0: не используйте- 1:Использовать |
Укажите, будут ли клиенты использовать PKI-сертификат клиента для взаимодействия с ролями системы сайта. |
UseFQDN |
Нет |
-
0: не используйте- 1:Использовать |
Укажите, будет ли полное доменное имя систем сайта использоваться в Интернете. |
ParentSiteCode |
Нет | Код сайта | При добавлении дочернего первичного сайта в существующую иерархию укажите код сайта cass. |
ParentSiteServer |
Нет | Полное доменное имя | При добавлении дочернего первичного сайта в существующую иерархию укажите полное доменное имя сервера CAS. |
SQLConfigOptions раздел для установки сайта
Добавьте следующие ключи SQLConfigOptions в раздел, чтобы установить сайт:
| Имя ключа | Обязательный | Значения | Details |
|---|---|---|---|
SQLServerName |
Да | Полное доменное имя SQL Server | Имя сервера или кластеризованного экземпляра, на котором выполняется SQL Server для размещения базы данных сайта. |
DatabaseName |
Да | Имя или Instance\Name |
Имя базы данных SQL Server для создания или использования. Если он находится на экземпляре по умолчанию, просто укажите имя базы данных. В противном случае укажите экземпляр и имя. |
SQLServerPort |
Нет | Номер порта | Порт, используемый SQL Server. По умолчанию используется 1433. |
SQLSSBPort |
Нет | Номер порта | Порт SQL Server Service Broker (SSB). По умолчанию SSB использует TCP-порт 4022. |
SQLDataFilePath |
Нет | Путь к локальному каталогу | Альтернативное расположение для создания MDB-файла базы данных. |
SQLLogFilePath |
Нет | Путь к локальному каталогу | Альтернативное расположение для создания LDF-файла журнала базы данных. |
AGBackupShare |
Нет | Путь к общей сетевой папке | Сетевое расположение для совместного использования резервных копий базы данных при создании базы данных сайта в группе доступности. Резервная папка требуется только в том случае, если автоматическое заполнение не задано. |
CloudConnectorOptions раздел для установки сайта
Добавьте следующие ключи CloudConnectorOptions в раздел, чтобы установить сайт:
| Имя ключа | Обязательный | Значения | Details |
|---|---|---|---|
CloudConnector |
Да |
-
0: не устанавливайте- 1:Установить |
Укажите, следует ли установить точку подключения службы (SCP) на этом сайте. Так как SCP можно установить только на сайте верхнего уровня иерархии, присвойте этому значению 0 значение для дочернего первичного сайта. |
CloudConnectorServer |
Да* | Полное доменное имя SCP | Полное доменное имя сервера, на котором будет размещена роль SCP. * Требуется только в том случае, если CloudConnector равно 1. |
UseProxy |
Да* |
-
0: нет прокси-сервера.- 1: использование прокси-сервера |
Укажите, использует ли SCP прокси-сервер. * Требуется только в том случае, если CloudConnector равно 1. |
ProxyName |
Да* | Полное доменное имя прокси-сервера | Полное доменное имя прокси-сервера, который использует SCP. * Требуется только в том случае, если UseProxy равно 1. |
ProxyPort |
Да* | Номер порта | Номер порта прокси-сервера, который использует SCP. * Требуется только в том случае, если UseProxy равно 1. |
SABranchOptions раздел для установки сайта
Добавьте следующие ключи SABranchOptions в раздел, чтобы установить сайт:
| Имя ключа | Обязательный | Значения | Details |
|---|---|---|---|
SAActive |
Да |
-
0: у вас нет SA- 1: SA активна |
Укажите, есть ли у вас активная программа Software Assurance (SA). Дополнительные сведения см. в статье Вопросы и ответы о продукте и лицензировании. |
CurrentBranch |
Да |
-
0: установите LTSB.- 1: установка текущей ветви |
Укажите, следует ли использовать Configuration Manager текущую ветвь или долгосрочную ветвь обслуживания (LTSB). Дополнительные сведения см. в статье Какая ветвь Configuration Manager следует использовать? |
SAExpiration |
Нет | Дата | Дата истечения срока действия SA, используемая в качестве удобного напоминания об этой дате. Дополнительные сведения см. в разделе Лицензирование и ветви. |
HierarchyExpansionOption раздел для расширения сайта
При установке CAS для расширения автономного первичного сайта в иерархию используйте следующие ключи HierarchyExpansionOption в разделе:
| Имя ключа | Обязательный | Значения | Details |
|---|---|---|---|
CCARSiteServer |
Нет | Полное доменное имя cas | Полное доменное имя центра обслуживания, к которому присоединяется первичный сайт при присоединении к иерархии Configuration Manager. Укажите CAS во время установки. |
CASRetryInterval |
Нет | Минуты | Если подключение к cass завершается сбоем, основной сайт ожидает это количество минут, а затем повторно выполняет его. |
WaitForCASTimeout |
Нет |
0 меняется на 100 |
Максимальное значение времени ожидания в минутах для подключения первичного сайта к CAS. |
UseDistributionView |
Нет |
-
0: не включать- 1:Включить |
Укажите, следует ли использовать распределенные представления для оптимизации репликации базы данных. |
JoinPrimarySiteName |
Нет | Полное доменное имя сервера сайта | Полное доменное имя развертываемого сервера первичного сайта. |
Управление языками
Identification раздел для языков
Добавьте следующий ключ в раздел для Identification управления языками:
| Имя ключа | Обязательный | Значения | Details |
|---|---|---|---|
Action |
Да | ManageLanguages |
Управляет поддержкой сервера, клиента и мобильного клиента на сайте. |
Options раздел для языков
Добавьте в раздел следующие ключи для Options управления языками:
| Имя ключа | Обязательный | Значения | Details |
|---|---|---|---|
AddServerLanguages |
Нет | См. примечание 1. | Языки сервера, которые будут доступны для Configuration Manager консоли, отчетов и других объектов. |
AddClientLanguages |
Нет | См. примечание 1. | Языки, которые будут доступны клиентским компьютерам. |
DeleteServerLanguages |
Нет | См. примечание 1. | Языки для удаления. Они больше не будут доступны для консоли Configuration Manager, отчетов и других объектов. |
DeleteClientLanguages |
Нет | См. примечание 1. | Языки, которые нужно удалить, и которые больше не будут доступны клиентским компьютерам. Английский язык доступен по умолчанию, удалить его невозможно. |
MobileDeviceLanguage |
Да |
-
0: не устанавливайте- 1:Установить |
Укажите, установлены ли клиентские языки мобильных устройств. |
PrerequisiteComp |
Да |
-
0:Скачать- 1: уже скачан |
Укажите, были ли уже скачаны необходимые файлы. Например, если используется значение 0, программа установки скачивает файлы. |
PrerequisitePath |
Да | Путь к локальному каталогу | Путь к необходимым файлам. В зависимости PrerequisiteComp от значения программа установки использует этот путь для хранения скачанных файлов или поиска ранее скачанных файлов. |
ResetSecSiteLangs |
Нет |
-
0: не сбрасывайте- 1:Сброс |
Сброс языковых пакетов, установленных на вторичном сайте. |
Примечание 1. Поддерживаемые языковые значения
Используйте трехбуквенный код для языков сервера или клиентских языков, которые Configuration Manager поддерживаются. Например, чтобы добавить поддержку немецкого языка в клиенте, укажите следующую пару "ключ - значение": AddClientLanguages=DEU
Английский (ENG) доступен по умолчанию. Вам не нужно добавлять его, и вы не можете удалить его.
Восстановление сайта
Identification раздел для site recovery
В зависимости от типа восстанавливаемого сайта добавьте в раздел следующие ключи с соответствующими значениями Identification :
| Имя ключа | Обязательный | Значения | Details |
|---|---|---|---|
Action |
Да | - RecoverPrimarySite- RecoverCCAR |
— Восстановление первичного сайта — Восстановление CAS |
CDLatest |
Да 3 |
1: программа установки выполняется из CD.Latest |
При запуске программы установки из папки CD.Latest добавьте этот ключ и значение. Это значение сообщает программе установки о том, что вы используете носитель из CD.Latest. |
Примечание 3: CDLatest обязательный
Ключ CDLatest требуется только при запуске программы установки из CD.Latest папки для восстановления сайта. Дополнительные сведения см. в разделе Сведения о файле скрипта командной строки.
RecoveryOptions раздел для site recovery
Добавьте в раздел следующие ключи RecoveryOptions , чтобы восстановить сайт:
| Имя ключа | Обязательный | Значения | Details |
|---|---|---|---|
ServerRecoveryOptions |
Да |
-
1: сервер сайта и SQL Server- 2: только сервер сайта- 4: только SQL Server |
Какие компоненты следует восстановить. См. примечание 4 |
DatabaseRecoveryOptions |
Да* |
-
10: восстановление из резервной копии- 20: восстановлено вручную.- 40: создание базы данных- 80:Пропустить |
Укажите способ восстановления базы данных сайта в SQL Server. * Требуется только в том случае, если ServerRecoveryOptions имеет значение 1 или 4. |
ReferenceSite |
Да* | Полное доменное имя | Эталонный первичный сайт, который CAS использует для восстановления глобальных данных. * Требуется только в том случае, если DatabaseRecoveryOptions имеет значение 40.
См. примечание 5 |
SiteServerBackupLocation |
Нет | Путь к каталогу | Путь к набору резервных копий сервера сайта. Если значение не указано, программа установки переустановит сайт, не восстанавливая его из резервного набора данных. |
BackupLocation |
Да* | Путь к каталогу | Путь к резервному набору базы данных сайта. * Требуется, если ServerRecoveryOptions имеет значение 1 или 4, а DatabaseRecoveryOptions — 10. |
Примечание 4. ServerRecoveryOptions Заметки о значении
1или2: чтобы восстановить сайт с помощью резервной копии сайта, укажите значение дляSiteServerBackupLocation. Если значение не указано, программа установки переустановит сайт, не восстанавливая его из резервного набора данных.4BackupLocation: ключ требуется при настройке значения10дляDatabaseRecoveryOptionsключа, то есть для восстановления базы данных сайта из резервной копии.
Примечание 5. ReferenceSite Заметки о значении
Если резервная копия базы данных старше периода хранения отслеживания изменений или при восстановлении сайта без резервной копии укажите ссылочный первичный сайт, который cass использует для восстановления глобальных данных.
Если не указать ссылочный сайт, а резервная копия старше периода хранения отслеживания изменений, все первичные сайты повторно инициализируются с восстановленными данными из центра доступности.
Если ссылочный сайт не указан, а резервная копия находится в течение периода хранения отслеживания изменений, с первичных сайтов реплицируются только изменения, внесенные после резервной копии. При наличии конфликтующих изменений с разных первичных сайтов cass использует первый полученный.
Options раздел для site recovery
Многие ключи в Options разделе также необходимы для восстановления сайта. Дополнительные сведения см. в Options разделе об установке сайта. В следующей таблице перечислены ключи в Options разделе site recovery.
| Имя ключа | Обязательный | Comment |
|---|---|---|
ProductID |
Да | |
SiteCode |
Да | Используйте тот же код сайта, который использовался до сбоя. |
SiteName |
Нет | |
SMSInstallDir |
Да | |
SDKServer |
Да | Используйте тот же сервер, на котором размещалась эта роль до сбоя. |
PrerequisiteComp |
Да | |
PrerequisitePath |
Да | |
AdminConsole |
Да* | * Требуется только в том случае, если ServerRecoveryOptions имеет значение 1 или 2. |
JoinCEIP |
Да |
SQLConfigOptions раздел для site recovery
Многие ключи в SQLConfigOptions разделе также необходимы для восстановления сайта. Дополнительные сведения см. в SQLConfigOptions разделе об установке сайта. В следующей таблице перечислены ключи в SQLConfigOptions разделе site recovery.
| Имя ключа | Обязательный | Comment |
|---|---|---|
SQLServerName |
Да | Используйте тот же сервер, на котором размещалась база данных сайта до сбоя. |
DatabaseName |
Да | Используйте то же имя базы данных, которое использовалось до сбоя. |
SQLSSBPort |
Да | Используйте тот же порт, который использовался до сбоя. |
SQLDataFilePath |
Нет | |
SQLLogFilePath |
Нет |
CloudConnectorOptions раздел для site recovery
Многие ключи в CloudConnectorOptions разделе также необходимы для восстановления сайта. Дополнительные сведения см. в CloudConnectorOptions разделе об установке сайта. В следующей таблице перечислены ключи в CloudConnectorOptions разделе site recovery.
| Имя ключа | Обязательный | Comment |
|---|---|---|
CloudConnector |
Да | |
CloudConnectorServer |
Да* | * Требуется только в том случае, если CloudConnector равно 1. |
UseProxy |
Да* | * Требуется только в том случае, если CloudConnector равно 1. |
ProxyName |
Да* | * Требуется только в том случае, если UseProxy равно 1. |
ProxyPort |
Да* | * Требуется только в том случае, если UseProxy равно 1. |
HierarchyExpansionOption раздел для site recovery
Многие ключи в HierarchyExpansionOption разделе также необходимы для восстановления сайта. Дополнительные сведения см. в HierarchyExpansionOption разделе об установке сайта. В следующей таблице перечислены ключи в HierarchyExpansionOption разделе site recovery.
| Имя ключа | Обязательный | Comment |
|---|---|---|
CCARSiteServer |
Да* | * Требуется только в том случае, если первичный сайт был подключен к CAS до сбоя. |
CASRetryInterval |
Нет | |
WaitForCASTimeout |
Нет |
Примеры
Пример сценария для установки первичного сайта
[Identification]
Action=InstallPrimarySite
CDLatest=1
[Options]
ProductID=Eval
SiteCode=XYZ
SiteName=Contoso eval site
SMSInstallDir=D:\Program Files\Microsoft Configuration Manager
SDKServer=cmsite.contoso.com
PrerequisiteComp=0
PrerequisitePath=C:\Sources\Redist
AdminConsole=1
JoinCEIP=0
ManagementPoint=cmsite.contoso.com
ManagementPointProtocol=HTTP
DistributionPoint=cmsite.contoso.com
DistributionPointProtocol=HTTP
DistributionPointInstallIIS=1
RoleCommunicationProtocol=HTTPorHTTPS
ClientsUsePKICertificate=0
MobileDeviceLanguage=0
[SQLConfigOptions]
SQLServerName=cmsql.contoso.com
SQLServerPort=1433
DatabaseName=CM_XYZ
SQLSSBPort=4022
SQLDataFilePath=E:\Program Files\Microsoft SQL Server\MSSQL15.MSSQLSERVER\MSSQL\DATA\
SQLLogFilePath=E:\Program Files\Microsoft SQL Server\MSSQL15.MSSQLSERVER\MSSQL\DATA\
[CloudConnectorOptions]
CloudConnector=1
CloudConnectorServer=cmsite.contoso.com
UseProxy=0
[SABranchOptions]
SAActive=1
CurrentBranch=1