适用于: Configuration Manager(current branch)
本文定义要在安装脚本文件中指定 .ini 的所有键和值。 将此文件与命令行选项结合使用/SCRIPT，可对Configuration Manager站点执行无人参与安装或恢复。 本文中的表显示：
- 可用的安装脚本密钥及其相应的值
- 如果需要
- 它们用于哪种类型的安装
- 密钥的简短说明
有关详细信息，请参阅以下文章：
在方括号中指定节名称， ([]) ： [<Section name>]。 例如，[Identification]。
为键提供值时，键名称后必须跟等号 (=) 和键的值： <Key name>=<Value>。 例如，CDLatest=1。 确保密钥位于相应的部分下。
每个部分和每个值都需要在单个脚本中是唯一的。 例如，只能有一个 [Identification] 节和一个 Action 键。
支持的操作
脚本主要由 节中的 Identification 键定义Action。 以下列表包括当前支持在无人参与的情况下运行安装程序的所有操作：
-
InstallCAS： (CAS) 安装管理中心站点 -
InstallPrimarySite：安装主站点 -
ManageLanguages：添加或删除客户端和服务器语言 -
RecoverPrimarySite：恢复主站点 -
RecoverCCAR：恢复 CAS
安装站点
Identification 站点安装部分
根据要安装的站点类型，在 节中包含 Identification 具有相应值的以下键：
| 项名称 | 必需 | 值 | 详细信息 |
|---|---|---|---|
Action |
是 | - InstallPrimarySite- InstallCAS |
- 安装主站点。 - 安装管理中心站点 (CAS) |
CDLatest |
是 2 |
1：安装程序从 CD.Latest 运行 |
从 CD.Latest 文件夹运行安装程序时，请包含此键和值。 此值告知安装程序你正在使用 中的 CD.Latest媒体。 |
注释 2： CDLatest 必需
CDLatest仅当从 CD.Latest 文件夹运行安装程序以安装主站点或管理中心站点时，才需要密钥。 有关详细信息，请参阅 关于命令行脚本文件。
Options 站点安装部分
在 “选项” 部分中包含以下密钥以安装站点：
| 项名称 | 必需 | 值 | 详细信息 |
|---|---|---|---|
ProductID |
是 |
-
xxxxx-xxxxx-xxxxx-xxxxx-xxxxx：带短划线的有效产品密钥- Eval：安装评估版 |
要安装的许可证类型。 |
SiteCode |
是 | 三个字符的代码，例如 XYZ |
在层次结构中唯一标识站点的三个字符站点代码。 |
SiteName |
是 | 站点名称 | 此网站的友好名称，可帮助识别它。 |
SMSInstallDir |
是 | 本地目录路径 | Configuration Manager程序文件的安装文件夹。 |
SDKServer |
是 | SMS 提供程序 FQDN | 要托管 SMS 提供程序的第一台服务器的 FQDN。 |
PrerequisiteComp |
是 |
-
0：下载- 1：已下载 |
指定是否已下载先决条件文件。 如果使用 值 0，安装程序将下载文件。 |
PrerequisitePath |
是 | 本地目录路径 | 先决条件文件的路径。 根据 PrerequisiteComp 值，安装程序使用此路径来存储下载的文件或查找以前下载的文件。 |
AdminConsole |
是 |
-
0：不安装- 1：安装 |
指定是否在站点服务器上安装 Configuration Manager 控制台。 |
JoinCEIP |
是 | 0 |
虽然从产品中删除了对客户体验改善计划 (CEIP) 的支持，但仍需要此密钥。 |
MobileDeviceLanguage |
是 |
-
0：不安装- 1：安装 |
指定是否安装移动设备客户端语言。 |
安装站点时，还可以指定用于管理语言的密钥，例如 AddServerLanguages 或 AddClientLanguages。 有关详细信息，请参阅 Options 语言部分。
部分中的 Options 以下键特定于 主站点：
| 项名称 | 必需 | 值 | 详细信息 |
|---|---|---|---|
ManagementPoint |
否 | MP FQDN | 将托管第一个管理点的服务器 FQDN (MP) 站点系统角色。 |
ManagementPointProtocol |
否 |
HTTPS 或 HTTP |
用于 MP 的协议。 |
DistributionPoint |
否 | DP FQDN | 将托管第一个分发点的服务器的 FQDN (DP) 站点系统角色。 |
DistributionPointProtocol |
否 |
HTTPS 或 HTTP |
用于 DP 的协议。 |
DistributionPointInstallIIS |
否 |
-
0：不安装- 1：安装 |
指定是否在 DP 上安装 IIS。 |
RoleCommunicationProtocol |
是 |
EnforceHTTPS 或 HTTPorHTTPS |
指定是将所有站点系统配置为仅接受来自客户端的 HTTPS 通信，还是为每个站点系统角色配置通信方法。 选择 时 EnforceHTTPS，客户端需要有效的公钥基础结构 (PKI) 证书进行客户端身份验证。 |
ClientsUsePKICertificate |
是 |
-
0：请勿使用- 1：使用 |
指定客户端是否将使用客户端 PKI 证书与站点系统角色通信。 |
UseFQDN |
否 |
-
0：请勿使用- 1：使用 |
指定站点系统的 FQDN 是否用于 Internet。 |
ParentSiteCode |
否 | 站点代码 | 将子主站点添加到现有层次结构时，请指定 CAS 的站点代码。 |
ParentSiteServer |
否 | FQDN | 将子主站点添加到现有层次结构时，请指定 CAS 服务器的 FQDN。 |
SQLConfigOptions 站点安装部分
在 安装站点的 SQLConfigOptions 部分中包含以下密钥：
| 项名称 | 必需 | 值 | 详细信息 |
|---|---|---|---|
SQLServerName |
是 | SQL Server的 FQDN | 运行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 部分中包含以下密钥：
| 项名称 | 必需 | 值 | 详细信息 |
|---|---|---|---|
CloudConnector |
是 |
-
0：不安装- 1：安装 |
指定是否在此站点 (SCP) 安装服务连接点。 由于只能在层次结构的顶层站点上安装 SCP，因此请将子主站点的此值设置为 0 。 |
CloudConnectorServer |
是* | SCP FQDN | 将托管 SCP 角色的服务器 FQDN。 * 仅当 等于 1时CloudConnector需要 。 |
UseProxy |
是* |
-
0：无代理- 1：使用代理 |
指定 SCP 是否使用代理服务器。 * 仅当 等于 1时CloudConnector需要 。 |
ProxyName |
是* | 代理 FQDN | SCP 使用的代理服务器的 FQDN。 * 仅当 等于 1时UseProxy需要 。 |
ProxyPort |
是* | 端口号 | SCP 使用的代理服务器的端口号。 * 仅当 等于 1时UseProxy需要 。 |
SABranchOptions 站点安装部分
在 安装站点的 SABranchOptions 部分中包含以下密钥：
| 项名称 | 必需 | 值 | 详细信息 |
|---|---|---|---|
SAActive |
是 |
-
0：没有 SA- 1：SA 处于活动状态 |
指定是否具有有效的软件保障 (SA) 。 有关详细信息，请参阅 产品和许可常见问题解答。 |
CurrentBranch |
是 |
-
0：安装 LTSB- 1：安装 Current Branch |
指定是使用Configuration Manager当前分支还是长期服务分支 (LTSB) 。 有关详细信息，请参阅我应使用Configuration Manager的哪个分支？ |
SAExpiration |
否 | 日期 | SA 到期的日期，用作该日期的方便提醒。 有关详细信息，请参阅 许可和分支。 |
HierarchyExpansionOption 网站扩展部分
安装 CAS 以将独立主站点扩展到层次结构中时，请使用 节中的 HierarchyExpansionOption 以下键：
| 项名称 | 必需 | 值 | 详细信息 |
|---|---|---|---|
CCARSiteServer |
否 | CAS FQDN | 主站点加入Configuration Manager层次结构时附加到的 CAS 的 FQDN。 在安装过程中指定 CAS。 |
CASRetryInterval |
否 | 分钟 | 如果与 CAS 的连接失败，主站点将等待此分钟数，然后重新尝试连接。 |
WaitForCASTimeout |
否 |
0 重命名为 100 |
主站点连接到 CAS 的最大超时值（以分钟为单位）。 |
UseDistributionView |
否 |
-
0：不启用- 1：使 |
指定是否使用 分布式视图 来优化数据库复制。 |
JoinPrimarySiteName |
否 | 站点服务器 FQDN | 要扩展的主站点服务器的 FQDN。 |
管理语言
Identification 用于语言的部分
在管理语言的 部分中包含以下密钥 Identification ：
| 项名称 | 必需 | 值 | 详细信息 |
|---|---|---|---|
Action |
是 | ManageLanguages |
管理站点上的服务器、客户端和移动客户端语言支持。 |
Options 用于语言的部分
在用于管理语言的 Options 部分中包含以下键：
| 项名称 | 必需 | 值 | 详细信息 |
|---|---|---|---|
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 站点恢复部分
根据要恢复的站点类型，在 节中 Identification 包含以下具有相应值的密钥：
| 项名称 | 必需 | 值 | 详细信息 |
|---|---|---|---|
Action |
是 | - RecoverPrimarySite- RecoverCCAR |
- 恢复主站点 - 恢复 CAS |
CDLatest |
是 3 |
1：安装程序从 CD.Latest 运行 |
从 CD.Latest 文件夹运行安装程序时，请包含此键和值。 此值告知安装程序你正在使用 CD.Latest 中的媒体。 |
注释 3： CDLatest 必需
CDLatest仅当从 文件夹中运行安装程序以恢复站点时，CD.Latest才需要密钥。 有关详细信息，请参阅 关于命令行脚本文件。
RecoveryOptions 站点恢复部分
在 部分包括 RecoveryOptions 以下密钥以恢复站点：
| 项名称 | 必需 | 值 | 详细信息 |
|---|---|---|---|
ServerRecoveryOptions |
是 |
-
1：站点服务器和SQL Server- 2：仅限站点服务器- 4：仅SQL Server |
要恢复的组件。 请参阅注释 4 |
DatabaseRecoveryOptions |
是* |
-
10：从备份还原- 20：手动恢复- 40：创建新数据库- 80：跳 |
指定安装程序如何在 SQL Server 中恢复站点数据库。 * 仅当 为 1 或 4时才ServerRecoveryOptions需要。 |
ReferenceSite |
是* | FQDN | CAS 用于恢复全局数据的引用主站点。 * 仅当 为 40时才DatabaseRecoveryOptions需要 。
请参阅注释 5 |
SiteServerBackupLocation |
否 | 目录路径 | 站点服务器备份集的路径。 如果未指定值，安装程序会重新安装站点，而不从备份集还原站点。 |
BackupLocation |
是* | 目录路径 | 站点数据库备份集的路径。 * 当 为 1 或 4且 DatabaseRecoveryOptions 为 10时ServerRecoveryOptions是必需的。 |
注释 4： ServerRecoveryOptions 值说明
1或2：若要使用站点备份恢复站点，请为SiteServerBackupLocation指定值。 如果未指定值，安装程序会重新安装站点，而不从备份集还原站点。4：为BackupLocation密钥配置 值10DatabaseRecoveryOptions（即从备份还原站点数据库）时，需要密钥。
注释 5： ReferenceSite 值注释
如果数据库备份早于更改跟踪保留期，或者在没有备份的情况下恢复站点时，请指定 CAS 用于恢复全局数据的引用主站点。
如果未指定引用站点，并且备份时间早于更改跟踪保留期，则会使用 CAS 中还原的数据重新初始化所有主站点。
如果未指定引用站点，并且备份在更改跟踪保留期内，则只会从主站点复制备份后所做的更改。 当不同主站点发生冲突更改时，CAS 将使用它收到的第一个更改。
Options 站点恢复部分
站点恢复还需要部分中 Options 的许多密钥。 有关详细信息，请参阅 Options 站点安装部分。 下表汇总了站点恢复部分中 Options 的密钥：
| 项名称 | 必需 | 评论 |
|---|---|---|
ProductID |
是 | |
SiteCode |
是 | 使用故障前所用的相同站点代码。 |
SiteName |
否 | |
SMSInstallDir |
是 | |
SDKServer |
是 | 使用故障前托管此角色的同一服务器。 |
PrerequisiteComp |
是 | |
PrerequisitePath |
是 | |
AdminConsole |
是* | * 仅当 为 1 或 2时才ServerRecoveryOptions需要。 |
JoinCEIP |
是 |
SQLConfigOptions 站点恢复部分
站点恢复还需要部分中 SQLConfigOptions 的许多密钥。 有关详细信息，请参阅 SQLConfigOptions 站点安装部分。 下表汇总了站点恢复部分中 SQLConfigOptions 的密钥：
| 项名称 | 必需 | 评论 |
|---|---|---|
SQLServerName |
是 | 使用故障前托管站点数据库的同一服务器。 |
DatabaseName |
是 | 使用失败前使用的相同数据库名称。 |
SQLSSBPort |
是 | 使用失败前使用的相同端口。 |
SQLDataFilePath |
否 | |
SQLLogFilePath |
否 |
CloudConnectorOptions 站点恢复部分
站点恢复还需要部分中 CloudConnectorOptions 的许多密钥。 有关详细信息，请参阅 CloudConnectorOptions 站点安装部分。 下表汇总了站点恢复部分中 CloudConnectorOptions 的密钥：
| 项名称 | 必需 | 评论 |
|---|---|---|
CloudConnector |
是 | |
CloudConnectorServer |
是* | * 仅当 等于 1时CloudConnector需要 。 |
UseProxy |
是* | * 仅当 等于 1时CloudConnector需要 。 |
ProxyName |
是* | * 仅当 等于 1时UseProxy需要 。 |
ProxyPort |
是* | * 仅当 等于 1时UseProxy需要 。 |
HierarchyExpansionOption 站点恢复部分
站点恢复还需要部分中 HierarchyExpansionOption 的许多密钥。 有关详细信息，请参阅 HierarchyExpansionOption 站点安装部分。 下表汇总了站点恢复部分中 HierarchyExpansionOption 的密钥：
| 项名称 | 必需 | 评论 |
|---|---|---|
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