自動安裝指令碼檔案金鑰
適用於：Configuration Manager (目前的分支)
本文會定義要在安裝腳本檔案中 .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 是否要在網際網路上使用。 |
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：沒有 Proxy- 1：使用 Proxy |
指定 SCP 是否使用 Proxy 伺服器。 * 只有在 等於 1 時 CloudConnector 才需要。 |
ProxyName |
是* | Proxy FQDN | SCP 所使用之 Proxy 伺服器的 FQDN。 * 只有在 等於 1 時 UseProxy 才需要。 |
ProxyPort |
是* | 連接埠號碼 | SCP 所使用的 Proxy 伺服器埠號碼。 * 只有在 等於 1 時 UseProxy 才需要。 |
SABranchOptions 月臺安裝區段
在 區段中 SABranchOptions 包含下列金鑰以安裝月臺：
| 機碼名稱 | 必要 | 值 | 詳細資料 |
|---|---|---|---|
SAActive |
是 |
-
0：您沒有 SA- 1：SA 為作用中 |
指定您是否有作用中的軟體保證 (SA) 。 如需詳細資訊，請參閱 產品和授權常見問題。 |
CurrentBranch |
是 |
-
0：安裝 LTSB- 1：安裝最新分支 |
指定要使用最新分支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 |
是* | 目錄路徑 | 月臺資料庫備份組的路徑。 * 當 為 或 時 ServerRecoveryOptions 為 ，且 DatabaseRecoveryOptions 為 時，則為必要 104 專案。 1 |
附注 4： ServerRecoveryOptions 值附注
1或2：若要使用月臺備份復原月臺，請指定 的值。SiteServerBackupLocation如果您未指定值，安裝程式會重新安裝月臺，而不需從備份組還原月臺。4BackupLocation：當您為DatabaseRecoveryOptions金鑰設定 的10值時，需要金鑰，也就是從備份還原月臺資料庫。
附注 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
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應