IConfigurationDataCollector

収集時点でのコンピューターの設定を収集します。

以下の例は、このオブジェクトを作成するために CreateDataCollectorFromXml を呼び出す場合に、このオブジェクトの初期化に使用できる XML を示しています。IDataCollector::Xml プロパティもこの XML を返します。

<ConfigurationDataCollector>
    <FileMaxCount/>  
    <FileMaxRecursiveDepth/>  
    <FileMaxTotalSize/>  
    <File/>  <!-- Specify this element for each file -->
    <ManagementQuery/>  <!-- Specify this element for each WMI query -->
    <QueryNetworkAdapters/>
    <RegistryKey/>  <!-- Specify this element for each registry key -->
    <RegistryMaxRecursiveDepth/>
    <SystemStateFile/>  
</ConfigurationDataCollector>

この例には、同様に指定する必要がある IDataCollector から継承されたプロパティ要素は示されていない点に注意してください。

コレクターを作成する XML を指定する際は、設定したいプロパティの要素のみを指定できます。プロパティを指定しない場合、PLA は既定値を提供します。コレクターの XML を取得すると、その XML には IDataCollector の要素を含むすべての要素が含まれます。

収集するファイルの最大数を取得または設定します。(Get)

収集するファイルの最大数を取得または設定します。(Put)

ファイルを再帰的に収集するサブフォルダーの最大数を取得または設定します。(Get)

ファイルを再帰的に収集するサブフォルダーの最大数を取得または設定します。(Put)

収集できるすべてのファイルを合計した最大ファイルサイズを取得または設定します。(Get)

収集できるすべてのファイルを合計した最大ファイルサイズを取得または設定します。(Put)

収集するファイルを取得または設定します。(Get)

IConfigurationDataCollector::FileMaxCount、IConfigurationDataCollector::FileMaxRecursiveDepth、IConfigurationDataCollector::FileMaxTotalSize プロパティを使用して、PLA が収集するファイルの数を制限できます。

PLA は IDataCollectorSet::LatestOutputLocation プロパティで指定された場所にファイルをコピーします。同じ名前のファイルが複数ある場合、PLA は最初のファイル名はそのまま残し、同じ名前を持つ以降のすべてのファイルに _n(n は 1 から始まる連番)を付加します。XML レポートを使用して各ファイルの由来を判別できます。

このプロパティは FindFirstFile 関数と FindNextFile 関数を使用して深さ優先探索を実行します。たとえば、次のディレクトリ構造を想定します。

MyDir
    Subdir1
        Subdir1.1
            a.txt
            b.txt
        Subdir1.2
            c.txt
        g.txt  (folder in Subdir1)
        h.txt  (folder in Subdir1)
    Subdir 2
        subdir2.1
            y.txt
            z.txt
            subdir2.1.1
                m.txt
    q.txt  (folder in MyDir)
    s.txt  (folder in MyDir)

PLA は次の順序でファイルを収集します(制限に達しなかった場合)。

q.txt
s.txt
g.txt
h.txt
a.txt
b.txt
c.txt
y.txt
z.txt
m.txt

収集するファイルを取得または設定します。(Put)

IConfigurationDataCollector::FileMaxCount、IConfigurationDataCollector::FileMaxRecursiveDepth、IConfigurationDataCollector::FileMaxTotalSize プロパティを使用して、PLA が収集するファイルの数を制限できます。

PLA は IDataCollectorSet::LatestOutputLocation プロパティで指定された場所にファイルをコピーします。同じ名前のファイルが複数ある場合、PLA は最初のファイル名はそのまま残し、同じ名前を持つ以降のすべてのファイルに _n(n は 1 から始まる連番)を付加します。XML レポートを使用して各ファイルの由来を判別できます。

このプロパティは FindFirstFile 関数と FindNextFile 関数を使用して深さ優先探索を実行します。たとえば、次のディレクトリ構造を想定します。

MyDir
    Subdir1
        Subdir1.1
            a.txt
            b.txt
        Subdir1.2
            c.txt
        g.txt  (folder in Subdir1)
        h.txt  (folder in Subdir1)
    Subdir 2
        subdir2.1
            y.txt
            z.txt
            subdir2.1.1
                m.txt
    q.txt  (folder in MyDir)
    s.txt  (folder in MyDir)

PLA は次の順序でファイルを収集します(制限に達しなかった場合)。

q.txt
s.txt
g.txt
h.txt
a.txt
b.txt
c.txt
y.txt
z.txt
m.txt

実行する Windows Management Instrumentation (WMI) クエリを取得または設定します。(Get)

WMI クエリの記述方法の詳細については、WQL (SQL for WMI) を参照してください。

実行する Windows Management Instrumentation (WMI) クエリを取得または設定します。(Put)

WMI クエリの記述方法の詳細については、WQL (SQL for WMI) を参照してください。

インストールされているネットワークアダプターに対して、オフロード機能やその他の構成情報を照会するかどうかを示す値を取得または設定します。(Get)

インストールされているネットワークアダプターに対して、オフロード機能やその他の構成情報を照会するかどうかを示す値を取得または設定します。(Put)

収集するレジストリキーの一覧を取得または設定します。

次のレジストリハイブからレジストリデータを収集できます。

• HKEY_CLASSES_ROOT
• HKEY_CURRENT_CONFIG
• HKEY_CURRENT_USER
• HKEY_LOCAL_MACHINE
• HKEY_USERS

レジストリ値を収集するには、値名までのフルパスを指定します。たとえば \HKEY_LOCAL_MACHINE\MyKey\MyValue のように指定します。

レジストリキー配下のすべての値を収集するには、レジストリキーまでのフルパスを指定します。たとえば \HKEY_LOCAL_MACHINE\MyKey\ のように指定します。

レジストリキーとそのサブキー配下のすべての値を収集するには、パスの最後の区切りにバックスラッシュを 2 つ使用します。たとえば \\computername\HKEY_LOCAL_MACHINE\MyKey\\ のように指定します。PLA は IConfigurationDataCollector::RegistryMaxRecursiveDepth プロパティで指定されたレベルまでレジストリデータを再帰的に収集します。

リモートコンピューターからレジストリ情報を収集するには、レジストリパスの先頭にコンピューター名を含めます。たとえば \\computername\HKEY_LOCAL_MACHINE\MyKey\MyValue のように指定します。

収集するレジストリキーの一覧を取得または設定します。(Put)

次のレジストリハイブからレジストリデータを収集できます。

• HKEY_CLASSES_ROOT
• HKEY_CURRENT_CONFIG
• HKEY_CURRENT_USER
• HKEY_LOCAL_MACHINE
• HKEY_USERS

レジストリキー配下のすべての値を収集するには、レジストリキーまでのフルパスを指定します。たとえば \HKEY_LOCAL_MACHINE\MyKey\ のように指定します。

レジストリキーとそのサブキー配下のすべての値を収集するには、パスの最後の区切りにバックスラッシュを 2 つ使用します。たとえば \\computername\HKEY_LOCAL_MACHINE\MyKey\\ のように指定します。PLA は IConfigurationDataCollector::RegistryMaxRecursiveDepth プロパティで指定されたレベルまでレジストリデータを再帰的に収集します。

リモートコンピューターからレジストリ情報を収集するには、レジストリパスの先頭にコンピューター名を含めます。たとえば \\computername\HKEY_LOCAL_MACHINE\MyKey\MyValue のように指定します。

レジストリ値を再帰的に収集するサブキーの最大数を取得または設定します。(Get)

レジストリ値を再帰的に収集するサブキーの最大数を取得または設定します。(Put)

保存されたシステム状態を格納するファイルの名前を取得または設定します。(Get)

ファイル名にはパスを含めないでください。ファイルへのパスは IDataCollectorSet::RootPath プロパティと IDataCollectorSet::Subdirectory プロパティによって決まります。

ファイルの名前を指定しない場合、システム状態は取得されません。

この状態情報は Circular Kernel Context Logger のスナップショットです。このコンテキストロガーはコンピューターの現在の状態のスナップショットを提供します。このファイルにはカーネルイベントが含まれます。TraceRpt.exe ツールを使用してイベントをデコードできます。

保存されたシステム状態を格納するファイルの名前を取得または設定します。(Put)

ファイル名にはパスを含めないでください。ファイルへのパスは IDataCollectorSet::RootPath プロパティと IDataCollectorSet::Subdirectory プロパティによって決まります。

ファイルの名前を指定しない場合、システム状態は取得されません。

この状態情報は Circular Kernel Context Logger のスナップショットです。このコンテキストロガーはコンピューターの現在の状態のスナップショットを提供します。このファイルにはカーネルイベントが含まれます。TraceRpt.exe ツールを使用してイベントをデコードできます。