Configuration Manager (現在のブランチ) に適用
この記事では、 .ini インストール スクリプト ファイルで指定するすべてのキーと値を定義します。 このファイルを /SCRIPT コマンド ライン オプションと共に使用して、Configuration Manager サイトの無人インストールまたは復旧を実行します。 この記事の表は次のとおりです。
- 使用可能なセットアップ スクリプト キーとそれに対応する値
- 必要な場合
- 使用するインストールの種類
- キーの簡単な説明
詳細については、次の記事を参照してください。
セクション名を角かっこ ([]): [<Section name>]で指定します。 たとえば、「 [Identification] 」のように入力します。
キーの値を指定する場合、キーの名前の後に等号 (=) とキーの値が続く必要があります: <Key name>=<Value>。 たとえば、「 CDLatest=1 」のように入力します。 キーが適切なセクションの下にあることを確認します。
各セクションと各値は、1 つのスクリプトで一意である必要があります。 たとえば、 [Identification] セクションは 1 つだけ、 Action キーは 1 つだけです。
サポートされているアクション
スクリプトは、主に 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 |
はい | たとえば、3 つの文字コード XYZ |
階層内のサイトを一意に識別する 3 文字のサイト コード。 |
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 | 最初の管理ポイント (MP) サイト システムの役割をホストするサーバーの FQDN。 |
ManagementPointProtocol |
不要 |
HTTPS または HTTP |
MP に使用するプロトコル。 |
DistributionPoint |
不要 | DP FQDN | 最初の配布ポイント (DP) サイト システムの役割をホストするサーバーの FQDN。 |
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。 * CloudConnector が 1と等しい場合にのみ必要です。 |
UseProxy |
はい* |
-
0: プロキシなし- 1: プロキシを使用する |
SCP でプロキシ サーバーを使用するかどうかを指定します。 * CloudConnector が 1と等しい場合にのみ必要です。 |
ProxyName |
はい* | プロキシ FQDN | SCP が使用するプロキシ サーバーの FQDN。 * UseProxy が 1と等しい場合にのみ必要です。 |
ProxyPort |
はい* | ポート番号 | SCP が使用するプロキシ サーバーのポート番号。 * UseProxy が 1と等しい場合にのみ必要です。 |
SABranchOptions サイトのインストールのセクション
[ SABranchOptions ] セクションに次のキーを含め、サイトをインストールします。
| キー名 | 必須 | 値 | 詳細 |
|---|---|---|---|
SAActive |
はい |
-
0: SA がありません- 1: SA がアクティブです |
アクティブなソフトウェア アシュアランス (SA) があるかどうかを指定します。 詳細については、「 製品とライセンスに関する FAQ」を参照してください。 |
CurrentBranch |
はい |
-
0: LTSB をインストールします- 1: 現在のブランチをインストールする |
現在のブランチConfiguration Manager使用するか、長期サービス ブランチ (LTSB) を使用するかを指定します。 詳細については、「使用する必要があるConfiguration Managerの分岐」を参照してください。 |
SAExpiration |
不要 | Date | 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サポートされているサーバー言語またはクライアント言語には、3 文字のコードを使用します。 たとえば、クライアントでドイツ語のサポートを追加するには、次のキーと値のペアを指定します。 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でのサイト データベースのセットアップによる復旧方法を指定します。 * ServerRecoveryOptions が 1 または 4の場合にのみ必要です。 |
ReferenceSite |
はい* | FQDN | CAS がグローバル データの復旧に使用する参照プライマリ サイト。 * DatabaseRecoveryOptions が 40されている場合にのみ必要です。
注 5 を参照してください |
SiteServerBackupLocation |
不要 | ディレクトリ パス | サイト サーバー バックアップ セットへのパス。 値を指定しない場合は、バックアップ セットから復元せずにサイトが再インストールされます。 |
BackupLocation |
はい* | ディレクトリ パス | サイト データベース バックアップ セットへのパス。 * ServerRecoveryOptions が 1 または 4で、 DatabaseRecoveryOptions が 10場合に必要です。 |
注 4: ServerRecoveryOptions 値のメモ
1または2: サイト バックアップを使用してサイトを回復するには、SiteServerBackupLocationの値を指定します。 値を指定しない場合は、バックアップ セットから復元せずにサイトが再インストールされます。4:BackupLocationキーは、サイト データベースをバックアップから復元するDatabaseRecoveryOptionsキーに対して10の値を構成するときに必要です。
注 5: ReferenceSite 値のメモ
データベースのバックアップが変更追跡保有期間より古い場合、またはバックアップなしでサイトを復旧する場合は、CAS がグローバル データの復旧に使用する参照プライマリ サイトを指定します。
参照サイトを指定せず、バックアップが変更追跡保持期間より古い場合、すべてのプライマリ サイトが CAS から復元されたデータで再初期化されます。
参照サイトを指定せず、バックアップが変更追跡保持期間内の場合、バックアップ後に行われた変更のみがプライマリ サイトからレプリケートされます。 異なるプライマリ サイトから競合する変更がある場合、CAS は最初に受け取った変更を使用します。
Options サイトの回復に関するセクション
Options セクションのキーの多くは、サイトの回復にも必要です。 詳細については、「サイトのインストールのOptions」セクションを参照してください。 次の表は、サイトの回復の Options セクションのキーをまとめたものです。
| キー名 | 必須 | コメント |
|---|---|---|
ProductID |
はい | |
SiteCode |
はい | エラーの前に使用したのと同じサイト コードを使用します。 |
SiteName |
不要 | |
SMSInstallDir |
はい | |
SDKServer |
はい | エラーの前にこのロールをホストしていたのと同じサーバーを使用します。 |
PrerequisiteComp |
はい | |
PrerequisitePath |
はい | |
AdminConsole |
はい* | * ServerRecoveryOptions が 1 または 2の場合にのみ必要です。 |
JoinCEIP |
はい |
SQLConfigOptions サイトの回復に関するセクション
SQLConfigOptions セクションのキーの多くは、サイトの回復にも必要です。 詳細については、「サイトのインストールのSQLConfigOptions」セクションを参照してください。 次の表は、サイトの回復の SQLConfigOptions セクションのキーをまとめたものです。
| キー名 | 必須 | コメント |
|---|---|---|
SQLServerName |
はい | 障害が発生する前にサイト データベースをホストしていたのと同じサーバーを使用します。 |
DatabaseName |
はい | エラーの前に使用したのと同じデータベース名を使用します。 |
SQLSSBPort |
はい | エラーの前に使用したのと同じポートを使用します。 |
SQLDataFilePath |
不要 | |
SQLLogFilePath |
不要 |
CloudConnectorOptions サイトの回復に関するセクション
CloudConnectorOptions セクションのキーの多くは、サイトの回復にも必要です。 詳細については、「サイトのインストールのCloudConnectorOptions」セクションを参照してください。 次の表は、サイトの回復の CloudConnectorOptions セクションのキーをまとめたものです。
| キー名 | 必須 | コメント |
|---|---|---|
CloudConnector |
はい | |
CloudConnectorServer |
はい* | * CloudConnector が 1と等しい場合にのみ必要です。 |
UseProxy |
はい* | * CloudConnector が 1と等しい場合にのみ必要です。 |
ProxyName |
はい* | * UseProxy が 1と等しい場合にのみ必要です。 |
ProxyPort |
はい* | * UseProxy が 1と等しい場合にのみ必要です。 |
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