Configuration Managerの階層メンテナンス ツール (Preinst.exe)

  • [アーティクル]

Configuration Manager (現在のブランチ) に適用

階層メンテナンス ツール (Preinst.exe) は、Hierarchy Manager サービスの実行中にConfiguration Manager階層マネージャーにコマンドを渡します。 階層メンテナンス ツールは、Configuration Manager サイトをインストールすると自動的にインストールされます。 Preinst.exeは、サイト サーバーの \bin\X64\00000409 フォルダーにあります。

次のシナリオでは、階層メンテナンス ツールを使用します。

  • セキュリティで保護されたキー交換が必要な場合は、サイト間で最初の公開キー交換を手動で行う必要がある場合があります。 詳細については、「 サイト間で公開キーを手動で交換する」を参照してください。

  • 使用できなくなった移行先サイトのアクティブなジョブを削除します。

  • セットアップでサイト サーバーをアンインストールできない場合は、Configuration Manager コンソールからサイト サーバーを削除します。 たとえば、最初にセットアップを実行せずにConfiguration Manager サイトを物理的に削除してサイトをアンインストールする場合などです。 サイト情報は引き続き親サイトのデータベースに存在し、親サイトは引き続き子サイトとの通信を試みます。 この問題を解決するには、階層メンテナンス ツールを実行し、親サイトのデータベースから子サイトを手動で削除します。

  • サービスを個別に停止することなく、サイト内のすべてのConfiguration Managerサービスを停止します。

  • サイトを復旧する場合は、 オプションを CHILDKEYS 使用して、複数の子サイトから回復サイトに公開キーを配布します。

階層メンテナンス ツールを実行するには、現在のユーザーにローカル コンピューターの管理者権限が必要です。 また、ユーザーは Site クラスの管理セキュリティ権限を明示的に持っている必要があります。 ユーザーがその権限を持つグループのメンバーであることによって、この権限を継承するだけでは十分ではありません。

階層メンテナンス ツールのコマンド ライン オプション

階層メンテナンス ツールを使用する場合は、中央管理サイト (CAS)、プライマリ サイト、またはセカンダリ サイト サーバーでローカルに実行する必要があります。 次の構文を使用します。 preinst.exe /<option> 次のコマンド ライン オプションを使用できます。

  • /DELJOB <SiteCode>: 現在のサイトから指定した宛先サイトにすべてのジョブまたはコマンドを削除します。

  • /DELSITE <ChildSiteCodeToRemove>: 親サイトのサイト データベースから子サイトのデータを削除するには、親サイトでこのオプションを使用します。 通常、このオプションは、サイト サーバー コンピューターからサイトをアンインストールする前に使用を停止した場合に使用します。

    注:

    オプションは /DELSITE 、 パラメーターで指定されたコンピューター上のサイトを ChildSiteCodeToRemove アンインストールしません。 このオプションは、Configuration Manager サイト データベースからのみサイト情報を削除します。

  • /DUMP <SiteCode>: サイトがインストールされているドライブのルート フォルダーにサイト コントロール イメージを書き込むには、ローカル サイト サーバーでこのオプションを使用します。 特定のサイト コントロール イメージをフォルダーに書き込むか、階層内のすべてのサイト コントロール ファイルを書き込むことができます。

    • /DUMP <SiteCode> は、指定したサイトのサイト コントロール イメージのみを書き込みます。

    • /DUMP は、すべてのサイトのサイト コントロール ファイルを書き込みます。

    イメージは、サイト コントロール ファイルのバイナリ表現であり、Configuration Manager サイト データベースに格納されます。 ダンプされたサイト コントロール ファイル イメージは、基本イメージと保留中の差分イメージの合計です。

    階層メンテナンス ツールを使用してサイト コントロール ファイル イメージをダンプした後、ファイル名は という形式 sitectrl_<SiteCode>.ct0になります。

  • /STOPSITE: ローカル サイト サーバーでこのオプションを使用して、サイトを部分的にリセットするConfiguration Manager サイト コンポーネント マネージャー サービスのシャットダウン サイクルを開始します。 このシャットダウン サイクルを開始すると、サイト サーバーとそのリモート サイト システム上のいくつかのConfiguration Manager サービスが停止します。 また、再インストールのためにこれらのサービスにフラグを設定します。 このシャットダウン サイクルの結果、サービスを再インストールすると、一部のパスワードが自動的に変更されます。

    注:

    サイト コンポーネント マネージャーのシャットダウン、再インストール、およびパスワードの変更の記録を表示する場合は、このコマンド ライン オプションを使用する前に、このコンポーネントのログ記録を有効にします。

    シャットダウン サイクルが開始されると、応答しないコンポーネントまたはコンピューターはスキップされ、自動的に続行されます。 ただし、サイト コンポーネント マネージャー サービスがシャットダウン サイクル中にリモート サイト システムにアクセスできない場合、リモート サイト システムにインストールされているコンポーネントは、サイト コンポーネント マネージャー サービスの再起動時に再インストールされます。 再起動されると、サイト コンポーネント マネージャー サービスは、再インストールのフラグが設定されているすべてのサービスの再インストールが成功するまで繰り返し試行します。

    Service Managerを使用して、サイト コンポーネント マネージャー サービスを再起動できます。 再起動後、影響を受けるすべてのサービスがアンインストール、再インストール、再起動されます。 オプションを/STOPSITE使用してシャットダウン サイクルを開始した後、サイト コンポーネント マネージャー サービスが再起動された後の再インストール サイクルを回避することはできません。

  • /KEYFORPARENT: サイトの公開キーを親サイトに配布します。

    オプションは /KEYFORPARENT 、プログラム ファイル ドライブのルートにあるファイル <SiteCode>.CT4 にサイトの公開キーを配置します。 このオプションpreinst.exe実行した後、このファイルを親サイトの \Inboxes\hman.box フォルダー (ではなく hman.box\pubkey) に手動でコピーします。

  • /KEYFORCHILD: サイトの公開キーを子サイトに配布します。

    オプションは /KEYFORCHILD 、プログラム ファイル ドライブのルートにあるファイル <SiteCode>.CT5 にサイトの公開キーを配置します。 このオプションを使用してpreinst.exeを実行した後、このファイルを子サイトの \Inboxes\hman.box フォルダー (ではなく hman.box\pubkey) に手動でコピーします。

  • /CHILDKEYS: 回復するサイトの子サイトで、このオプションを使用します。 複数の子サイトから回復サイトに公開キーを配布します。

    オプションは /CHILDKEYS 、オプションを実行するサイトからキーを配置し、そのサイトのすべての子サイトの公開キーを ファイル <SiteCode>.CT6に配置します。 このオプションを使用してpreinst.exeを実行した後、このファイルを回復サイトの \Inboxes\hman.box フォルダー (ではなく hman.box\pubkey) に手動でコピーします。

  • /PARENTKEYS: 回復するサイトの親サイトで、このオプションを使用します。 すべての親サイトから回復サイトに公開キーを配布します。

    オプションは /PARENTKEYS 、オプションを実行するサイトのキーと、そのサイトの上にある各親サイトのキーを ファイル <SiteCode>.CT7に配置します。 このオプションを使用してpreinst.exeを実行した後、このファイルを回復サイトの \Inboxes\hman.box フォルダー (ではなく hman.box\pubkey) に手動でコピーします。

サイト間で公開キーを手動で交換する

既定では、Configuration Manager サイトで [セキュリティで保護されたキー交換が必要] オプションが有効になっています。 セキュリティで保護されたキー交換が必要な場合、サイト間で最初のキー交換を手動で行う必要がある場合は、次の 2 つの状況があります。

  • Configuration Managerの Active Directory スキーマを拡張していない場合

  • サイトが Active Directory にサイト データを発行していないConfiguration Manager

階層メンテナンス ツールを使用して、各サイトの公開キーをエクスポートできます。 エクスポートしたら、サイト間でキーを手動で交換します。

注:

公開キーが手動で交換されたら、親サイト サーバーの hman.log ログ ファイルを確認します。 このログ ファイルは、サイト構成の変更とサイト情報の公開を Active Directory に記録します。 プライマリ サイトが新しい公開キーを処理したことを確認できます。

子サイトの公開キーを親サイトに手動で転送する方法

  1. 子サイト サーバーにサインインし、コマンド プロンプトを開き、 Preinst.exeの場所に移動します。

  2. 次のコマンドを入力して、子サイトの公開キーをエクスポートします。 Preinst /keyforparent

オプションは /keyforparent 、子サイトの公開キーをシステム ドライブの <SiteCode>.CT4 ルートにあるファイルに配置します。

  1. ファイルを<SiteCode>.CT4、Configuration Manager インストール ディレクトリ内の親サイトの\inboxes\hman.boxフォルダーに移動します。

親サイトの公開キーを子サイトに手動で転送する方法

  1. 親サイト サーバーにサインインし、コマンド プロンプトを開き、 Preinst.exeの場所に移動します。

  2. 親サイトの公開キーをエクスポートするには、次のコマンドを入力します。 Preinst /keyforchild

このオプションでは /keyforchild 、親サイトの公開キーがシステム ドライブの <SiteCode>.CT5 ルートにあるファイルに配置されます。

  1. ファイルを<SiteCode>.CT5、Configuration Manager インストール ディレクトリ内の子サイトの\inboxes\hman.boxフォルダーに移動します。