無人セットアップ スクリプト ファイル キー

  • [アーティクル]

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。DatabaseRecoveryOptions4

注 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 はい* * が と等しい場合 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