無人セットアップ スクリプト ファイル キー
Configuration Manager (現在のブランチ) に適用
この記事では、インストール スクリプト ファイルで指定するすべてのキーと値を .ini
定義します。 このファイルを/SCRIPT
コマンド ライン オプションと共に使用して、Configuration Manager サイトの無人インストールまたは復旧を実行します。 この記事の表は次のとおりです。
- 使用可能なセットアップ スクリプト キーとそれに対応する値
- 必要な場合
- 使用するインストールの種類
- キーの簡単な説明
詳細については、次の記事を参照してください。
セクション名を角かっこ ([]
): [<Section name>]
で指定します。 たとえば、「 [Identification]
」のように入力します。
キーの値を指定する場合、キーの名前の後に等号 (=
) とキーの値を指定する必要があります。 <Key name>=<Value>
たとえば、「 CDLatest=1
」のように入力します。 キーが適切なセクションの下にあることを確認します。
各セクションと各値は、1 つのスクリプトで一意である必要があります。 たとえば、セクションは 1 つだけ [Identification]
、キーは 1 つだけ Action
です。
サポートされているアクション
スクリプトは、主に セクションの Action
キーによって Identification
定義されます。 次の一覧には、セットアップを無人で実行するために現在サポートされているすべてのアクションが含まれています。
-
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 :インストール |
モバイル デバイス クライアント言語をインストールするかどうかを指定します。 |
サイトをインストールするときに、 や AddClientLanguages
などのAddServerLanguages
言語を管理するためのキーを指定することもできます。 詳細については、言語のセクションを参照してください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 |
いいえ | 日付 | 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でのサイト データベースのセットアップによる復旧方法を指定します。 * が 1 または 4 の場合ServerRecoveryOptions にのみ必要です。 |
ReferenceSite |
はい* | FQDN | CAS がグローバル データの復旧に使用する参照プライマリ サイト。 * が の場合 DatabaseRecoveryOptions にのみ必要です 40 。
注 5 を参照してください |
SiteServerBackupLocation |
いいえ | ディレクトリ パス | サイト サーバー バックアップ セットへのパス。 値を指定しない場合は、バックアップ セットから復元せずにサイトが再インストールされます。 |
BackupLocation |
はい* | ディレクトリ パス | サイト データベース バックアップ セットへのパス。 * が または で、 が 1 の場合ServerRecoveryOptions は必須です10 。DatabaseRecoveryOptions 4 |
注 4: ServerRecoveryOptions
値のメモ
1
または2
: サイト バックアップを使用してサイトを回復するには、 の値を指定しますSiteServerBackupLocation
。 値を指定しない場合は、バックアップ セットから復元せずにサイトが再インストールされます。4
: キーのBackupLocation
値10
DatabaseRecoveryOptions
を構成するときにキーが必要です。これは、バックアップからサイト データベースを復元することです。
注 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 |
はい* | * が と等しい場合 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