サイトコントロールファイルのConfiguration Managerについて

  • [アーティクル]

Configuration Managerのサイト コントロールは、特定のサイトの設定を定義します。 各サイトの設定はデータベースに含まれており、スクリプト言語を操作する場合は Windows Management Instrumentation (WMI) を使用し、マネージド言語を使用する場合はマネージド SMS プロバイダー ライブラリを介してアクセスされます。

注:

以前のリリースのConfiguration Managerには、サイトコントロールファイルと呼ばれるサイト設定用に処理された物理ファイルがありました。 Configuration Managerサイト設定はサイト データベースに直接格納されますが、プログラムによってサイトを構成する場合は、ほとんど変更されません。

Configuration Managerのサイト コントロール ファイルは、各サイトの構成を含む ASCII テキスト ファイル (Sitectrl.ct0) です。 サイト コントロール ファイルには、次の 2 種類があります。

  • 実際のサイト コントロール ファイル - Configuration Manager サイト データベースとサイト コントロール マネージャーの受信トレイに格納されているサイト コントロール ファイルの作業コピー。

  • デルタ サイト コントロール ファイル - 処理するサイト コントロール ファイルの変更が提案されています。

    サイト コントロール ファイルは、サイト コントロール マネージャーの受信トレイの各サイト サーバーに格納されます。

    プライマリ サイトには、データベース内の現在のサイトのサイトコントロール ファイルのコピーがあります。 プライマリ サイトには、セカンダリ サイトを含め、階層内のすべての下位レベルのサイトのサイトコントロール ファイルのコピーもあります。

    各子サイトは、サイト コントロール ファイルのコピーを親サイトに渡します。 各親サイトは、サイト コントロール ファイルのコピーをそれ自体と子サイトごとに階層に渡します。 そのため、中央サイトのデータベースには、階層内のすべてのConfiguration Manager サイトのサイト コントロール ファイルのコピーが含まれます。

サイト コントロール ファイル形式

サイト コントロール ファイルは、埋め込みプロパティ、埋め込みプロパティ リスト、および複数文字列リストを含むリソース定義のコレクションです。 次の例は、クライアント コンポーネント情報を定義するサイト コントロール ファイルのセクションを示しています。 リソースは、BEGIN_CLIENT_COMPONENTによって宣言されます。 埋め込みプロパティは PROPERTY で示され、名前と値を持っています。 プロパティ リストは、BEGIN_PROPERTY_LIST セクションで示され、プロパティ リスト名と複数のプロパティ名と関連する値が一覧表示されます。 複数文字列リストは、BEGIN_CLIENT_REG_MULTI_STRING_LISTで示され、文字列値のリストを提供します。

BEGIN_CLIENT_COMPONENT  
    <SMS Client Base Components>  
    <65537>  
    SITE_KEY_FLAGS <1>  
    PROPERTY <Component Verify Interval><REG_SZ><00011700001000F0><0>  
    PROPERTY <Component Maintenance Interval (minutes)><REG_DWORD><><1500>  
    BEGIN_PROPERTY_LIST  
        <Copy Queue>  
        <(REG_DWORD)Item Lifetime=11520>  
        <(REG_DWORD)Wakeup cycle=1380>  
    END_PROPERTY_LIST  
    BEGIN_CLIENT_REG_MULTI_STRING_LIST  
        <Retry Sequence><Copy Queue>  
        SITE_KEY_FLAGS <1>  
        <15>  
        <30>  
        <60>  
        <360>  
    END_CLIENT_REG_MULTI_STRING_LIST  
END_CLIENT_COMPONENT

プロバイダーには、サイト コントロール ファイル内のリソースを表す複数の Windows Management Instrumentation (WMI) クラスがあります。 たとえば、SMS_SCI_Component サーバー WMI クラスは、Configuration Manager サイト サーバーに格納されているサーバー コンポーネントに関する情報を保持します。 これらのクラスは 、SMS_SiteControlItem サーバー WMI クラスから派生します。 詳細については、「サイト構成サーバー WMI クラスのConfiguration Manager [リファレンス]」を参照してください。

次の例は、 SMS_SCI_ClientConfig Server WMI クラスの宣言です。

Class SMS_SCI_ClientConfig : SMS_SiteControlItem   
{  
     String ClientConfigName;  
     UInt32 FileType;  
     UInt32 Flags;  
     String ItemName;  
     String ItemType;  
     String Platforms[];  
     SMS_EmbeddedPropertyList PropLists[];  
     SMS_EmbeddedProperty Props[];  
     SMS_Client_Reg_MultiString_List RegMultiStringLists[];  
     String SiteCode;  
};

宣言には、埋め込みプロパティ、プロパティ リスト、および複数の文字列リスト宣言の宣言が含まれています。

埋め込みプロパティ、プロパティ リスト、および複数文字列リストには、次のクラスを使用してアクセスします。

型 WMI クラス
埋め込みプロパティ SMS_EmbeddedProperty サーバー WMI クラス
埋め込みプロパティリスト SMS_EmbeddedPropertyList サーバー WMI クラス (配列)
複数文字列リスト SMS_Client_Reg_MultiString_List サーバー WMI クラス (配列)

このドキュメントには、埋め込みプロパティについて説明する次のトピックがあります。

Configuration Manager サイト コントロール ファイルの埋め込みプロパティ リストを読み取る方法

サイト コントロール ファイルの使用

サイト コントロール ファイルへのアクセス方法は、WMI とマネージド プロバイダーのどちらを使用しているかによって異なります。

WMI

WMI を使用している場合は、クラス メソッドを SMS_SiteControlFile 使用してサイト コントロール ファイルへの変更を管理します。 サイト コントロール ファイルへの書き込みは、指定したセッション コンテキスト情報を使用して管理されます。 これは、複数のアプリケーションのサイト コントロール ファイルへの同時書き込みを有効にするために使用されます。 詳細については、「WMI を使用してサイト コントロール ファイルをConfiguration Managerに読み書きする方法」を参照してください。サイト コントロール ファイルから読み取る場合は、セッションを設定せずにクエリを実行できます。

マネージド プロバイダー

ほとんどの場合、マネージド Configuration Manager ライブラリによってこの処理が行われるため、コードはConfiguration Manager サイトコントロール ファイルに対する変更をロックまたはコミットする必要はありません。 その結果、Configuration Managerサイトコントロールファイルのプログラミングは基本的に、Configuration Managerオブジェクトのプログラミングと同じです。 これは、セッション ハンドルを明示的に取得し、行った変更をコミットする必要がある WMI を介してConfiguration Manager サイトコントロール ファイルにアクセスする場合とは異なります。

詳細については、「マネージド コードを使用してサイト コントロール ファイルをConfiguration Managerに読み書きする方法」を参照してください。

関連項目

マネージド コードを使用してConfiguration Manager サイト コントロール ファイルの読み取りと書き込みを行う方法
WMI を使用してConfiguration Manager サイト コントロール ファイルの読み取りと書き込みを行う方法