この記事の内容
皆様、こんにちは。Configuration Manager / WSUS サポート チームです。
本記事では、Configuration Manager のハードウェア インベントリについて、クライアントで収集が起動されてから、管理ポイントを経由してサイト データベースへ取り込まれるまでの動作とログの追跡方法をご案内します。全件更新と差分更新の違いも、同じクライアントのログを用いて説明します。
全体の流れ
- スケジュールまたは手動操作で収集サイクルを起動する
- レポートの種類を決定し、対象の情報を収集する
- インベントリ レポート (.xml ファイル) を生成し、送信を要求する
- クライアントから管理ポイントへレポートを配送する
- 管理ポイントでクライアントから届いた xml ファイルを MIF ファイルに変換し、サイトへ引き渡す
- サイト サーバーでサイト データベースへ取り込む
動作説明の前提
ハードウェア インベントリは、クライアント設定で有効にし、収集スケジュールと収集対象のクラス・属性を設定して使用します。設定を変更した場合は、クライアントがポリシーを取得してから収集に反映されます。
全件更新と差分更新では、サイトへ報告する情報の範囲が異なります。
| 種類 | 報告する内容 | ログで確認する点 |
|---|---|---|
| 全件更新 | 端末上のあらゆる情報ではなく、収集対象として設定された範囲の情報全体を報告します。 | 初回の Full や、再同期時の ReSync といったレポートの種類を確認します。 |
| 差分更新 | 前回の収集結果からの変更を報告します。 | Delta とレポート バージョンを確認します。 |
クライアントが最初に返すインベントリは全件で、その後は差分を返します。差分が欠落した場合、サイトは後続の差分を拒否し、クライアントへ全件収集を要求します。詳細は ハードウェア インベントリの概要 をご参照ください。
収集サイクルを手動で実行した場合も、クライアントの収集状態に応じて全件更新または差分更新が行われます。本記事の全件更新の例では、以下の PowerShell を使用して全件収集を強制的に実行しています。
1 | Get-WmiObject -Namespace root\ccm\invagt -Class InventoryActionStatus -Filter "InventoryActionID='{00000000-0000-0000-0000-000000000001}'" | Remove-WmiObject |
注意
対象の Configuration Manager クライアント上で、Windows PowerShell 5.1 を管理者として起動して実行します。
使用している WMI コマンドレットは PowerShell 7 では削除されているため、PowerShell 7 では実行できません。
1 行目では、前回の収集日時やレポート バージョンを保持する InventoryActionStatus クラス から、ハードウェア インベントリに対応する状態を削除します。2 行目では、収集サイクルを起動します。この全件収集の要求方法は、関連記事 ハードウェア インベントリ情報が採取されない場合のトラブルシューティング でもご案内していますので、ご確認ください。
差分更新の例では、その後、同じクライアントで収集サイクルを再度手動実行しています。収集サイクルを起動するだけの場合は 2 行目を実行し、全件収集を要求するための 1 行目の状態削除は行いません。
以下では、管理ポイントをプライマリ サイト サーバーと同じサーバーに配置した構成で、サイト データベースへの取り込みを追跡します。セカンダリ サイト経由の MIF 転送は対象外ですので、ご留意ください。
各ステップとログの追跡方法
関連ログ
| ログ名 | 保存場所 | 主な用途 |
|---|---|---|
| Scheduler.log | クライアントの C:\Windows\CCM\Logs |
定期スケジュールからの収集起動を確認します。 |
| smscliui.log | クライアントの C:\Windows\CCM\Logs |
クライアントの収集サイクルを実行した操作を確認します。 |
| InventoryAgent.log | クライアントの C:\Windows\CCM\Logs |
レポートの種類、情報の収集、レポート生成、送信要求を確認します。 |
| CcmMessaging.log | クライアントの C:\Windows\CCM\Logs |
管理ポイントへの実際の配送結果を確認します。 |
| MP_Hinv.log | 管理ポイントのログ フォルダー | レポートの受信情報と MIF への変換を確認します。 |
| mpfdm.log | 管理ポイントのログ フォルダー | クライアント ファイルをサイト サーバーへ引き渡す処理と、格納先の INBOXES フォルダーとの対応関係を確認します。 |
| dataldr.log | サイト サーバーの <Configuration Manager インストール先>\Logs |
MIF の処理とサイト データベースへの取り込みを確認します。 |
管理ポイントのログ フォルダーは、例えば C:\SMS_CCM\Logs です。役割の配置やインストール先によって異なるため、対象サーバー上の保存先をご確認ください。ログの役割は ログ ファイルのリファレンス でも確認できます。
ログ間の対応付け
同じ端末から複数回のレポートが届くため、端末名だけでなく、レポート バージョン、メッセージ ID、および MIF ファイル名を組み合わせて追跡します。
| 項目 | 全件更新の例 | 差分更新の例 |
|---|---|---|
| 対象クライアント | CLIENT01 | CLIENT01 |
| クライアント GUID | 631942E3-EC38-4623-8D15-22BFD5C175C5 | 631942E3-EC38-4623-8D15-22BFD5C175C5 |
| レポートの種類とバージョン | ReSync、3.0 | Delta、3.1 |
| 送信メッセージ ID | BC93BDBF-4295-4680-923F-37A910A7D869 | B04B4837-A7AD-4DF1-A013-604D40BEFF69 |
| MIF ファイル名 | HDUMCY0A.MIF | H31MBSZJ.MIF |
InventoryAgent.log と CcmMessaging.log は送信メッセージ ID で照合します。MP_Hinv.log の受信レポート情報でクライアント GUID、レポートの種類とバージョンを確認し、変換後の MIF ファイル名で dataldr.log へ追跡します。mpfdm.log では、ハードウェア インベントリの格納先フォルダーとの対応関係を確認します。ログごとに出力される識別情報が異なりますので、それぞれの確認項目を使い分けてご確認ください。
以下のログはメッセージ本文を抜粋し、行ごとの日時などの付帯情報を除外しています。端末名とサーバー名は匿名化し、途中の行を省略した箇所は「中略」と示しています。Scheduler.log の定期起動例は、全件更新 (3.0) および差分更新 (3.1) の手動起動とは別の収集サイクルです。
ステップ 1 : スケジュールまたは手動操作で収集サイクルを起動する
定期実行では、クライアント設定の収集スケジュールに従って処理が起動します。Scheduler.log では、ハードウェア インベントリのアクション ID と、宛先の InventoryAgent を確認します。
Scheduler.log の定期起動例です。
1 | Sending message for schedule 'Machine/{00000000-0000-0000-0000-000000000001}' (Target: 'direct:InventoryAgent', Name: '') |
手動で収集サイクルを実行した場合は、起動方法に対応するログも併せて確認します。今回の全件更新と差分更新では、smscliui.log に次のメッセージが記録されています。
全件更新の起動です。
1 | Perform Action: Hardware Inventory Collection Cycle - {00000000-0000-0000-0000-000000000101}. Message sent, id={6BBB030D-92B4-4B49-8519-3254F1191F99} |
差分更新の起動です。
1 | Perform Action: Hardware Inventory Collection Cycle - {00000000-0000-0000-0000-000000000101}. Message sent, id={95F6ADBA-F4D2-41EF-9B5A-D7197BCD83CF} |
末尾が 001 のハードウェア インベントリの ID と、末尾が 101 の収集サイクルの ID は、SMS_Client クラスの TriggerSchedule メソッド に記載されています。また、ここでの起動メッセージ ID と、後述のレポート送信メッセージ ID は異なります。
起動後は、InventoryAgent.log で処理の開始を確認します。全件更新と差分更新のどちらでも、次のメッセージが記録されています。
1 | Inventory: *********************** Start of message processing. *********************** |
開始が確認できない場合は、定期実行か手動実行かを整理し、対象クライアントに適用された有効化設定と収集スケジュールをご確認ください。Scheduler.log の定期起動の記録と、手動操作の記録を分けて確認すると、起動経路を整理しやすくなります。
ステップ 2 : レポートの種類を決定し、対象の情報を収集する
InventoryAgent.log では、Action=Hardware の行でハードウェア インベントリであることと、レポートの種類を確認します。このログにはソフトウェア インベントリやハートビート探索も記録されるため、Action=Hardware と ReportType を組み合わせて対象の収集サイクルを識別します。
PowerShell で全件収集を要求した今回の例では、バージョン不一致を検出し、全件レポートを生成することが記録されています。直後の種類は ReSync、バージョンは 3.0 です。
1 | CInvState::VerifyInventoryVersionNumber: Mismatch found for '{00000000-0000-0000-0000-000000000001}': 2.2 vs. 0.0 |
中略
1 | Inventory: Action=Hardware, ReportType=ReSync, MajorVersion=3, MinorVersion=0 |
この例の ReSync は全件の再同期レポートです。初回収集の Full という表記だけでなく、前後のメッセージと、ステップ 6 のサイト側の扱いまで確認することで、全件更新であることを追跡できます。
続く差分更新では、同じメジャー バージョンのままマイナー バージョンが進み、Delta、3.1 になっています。
1 | Inventory: Action=Hardware, ReportType=Delta, MajorVersion=3, MinorVersion=1 |
クライアントは、設定された収集対象に対して情報を取得します。例えば、差分更新でも次のような WMI クエリの実行が記録されています。
1 | Collection: Namespace = \\.\root\cimv2\sms; Query = SELECT __CLASS, __PATH, __RELPATH, SecureBoot, UEFI FROM SMS_Firmware; Timeout = 600 secs. |
差分更新でも収集対象のクラスから情報を取得し、前回の収集結果との差分をレポートにまとめます。必要な情報が含まれない場合は、対象クラスの収集設定と、そのクラスに対応するクエリの前後のメッセージをご確認ください。
ステップ 3 : インベントリ レポートを生成し、送信を要求する
収集後、クライアントはレポートを生成します。InventoryAgent.log では、生成したエントリ数と、宛先 MP_HinvEndpoint への送信要求を確認します。
全件更新の例です。
1 | Reporting: 1583 report entries created. |
中略
1 | Inventory: Successfully sent report. Destination:mp:MP_HinvEndpoint, ID: {BC93BDBF-4295-4680-923F-37A910A7D869}, Timeout: 80640 minutes MsgMode: Signed, Not Encrypted |
差分更新の例です。
1 | Reporting: 10 report entries created. |
中略
1 | Inventory: Successfully sent report. Destination:mp:MP_HinvEndpoint, ID: {B04B4837-A7AD-4DF1-A013-604D40BEFF69}, Timeout: 80640 minutes MsgMode: Signed, Not Encrypted |
この例では、同じ収集対象に対して全件側は 1,583 エントリ、差分側は 10 エントリを報告しています。エントリ数は端末の情報や変更内容によって異なりますので、変更した属性の数そのものではなく、レポートにまとめられたエントリの数としてご確認ください。
Successfully sent report は InventoryAgent 側の送信処理を確認するメッセージです。管理ポイントへの配送完了やサイト データベースへの取り込み完了は、次のステップ以降で確認します。レポートが生成されない場合は、同じ収集サイクル内の収集結果とレポート生成時のエラーを確認します。
ステップ 4 : クライアントから管理ポイントへレポートを配送する
CcmMessaging.log を、ステップ 3 のメッセージ ID で検索します。全件更新では、管理ポイントへの配送成功が次のように記録されています。
1 | OutgoingMessage(Queue='mp_mp_hinvendpoint', ID={BC93BDBF-4295-4680-923F-37A910A7D869}): Delivered successfully to host 'MP01.contoso.com'. |
差分更新も、同じく送信メッセージ ID で確認できます。
1 | OutgoingMessage(Queue='mp_mp_hinvendpoint', ID={B04B4837-A7AD-4DF1-A013-604D40BEFF69}): Delivered successfully to host 'MP01.contoso.com'. |
Delivered successfully により、対象メッセージの管理ポイントへの配送成功を確認できます。サイト データベースへの取り込み結果は、続くサーバー側のログでご確認ください。
配送成功が確認できない場合は、同じ ID の再試行や通信エラーの記録を追跡します。InventoryAgent.log の送信メッセージと対応させることで、別の種類のクライアント通信との混同を避けられます。
ステップ 5 : 管理ポイントで MIF ファイルに変換し、サイトへ引き渡す
管理ポイントはクライアントから受信した XML 形式のハードウェア インベントリを、サイトで処理する MIF (Management Information Format) ファイルへ変換します。MP_Hinv.log の受信レポート情報では、ClientID、NetBIOSName、ReportType、および Version を確認します。
掲載例では、同じクライアント GUID に対して Resync の 3.0 と Delta の 3.1 が記録され、それぞれ次の MIF ファイルへの変換成功を確認できます。
全件更新の例です。
1 | Hinv report translation created "E:\ConfigMgr\inboxes\auth\dataldr.box\HDUMCY0A.MIF" successfully |
差分更新の例です。
1 | Hinv report translation created "E:\ConfigMgr\inboxes\auth\dataldr.box\H31MBSZJ.MIF" successfully |
管理ポイントからサイト サーバーへのファイルの引き渡しは、mpfdm.log で確認します。掲載例のように管理ポイントとサイト サーバーが同じサーバーにある構成では、mpfdm.log に次の格納先の情報が記録されています。
1 | Inbox source is local on MP01.contoso.com |
中略
1 | ~MP Manager outbox Data Loader (Trusted) maps to E:\ConfigMgr\inboxes\auth\dataldr.box |
Data Loader (Trusted) の行から、ハードウェア インベントリの hinv.box と、サイト サーバーの格納先である E:\ConfigMgr\inboxes\auth\dataldr.box の対応関係を確認できます。この格納先は、先ほどの MP_Hinv.log に記録された MIF ファイルの出力先と一致しています。
ここでは、mpfdm.log で格納先の対応関係を確認し、個々の MIF ファイルの生成と取り込みは MP_Hinv.log と dataldr.log で追跡します。管理ポイントが別のサーバーにある場合は、mpfdm.log の転送処理も併せてご確認ください。
変換成功を確認した後は、MIF ファイル名を使って dataldr.log を検索します。変換に失敗している場合は、MP_Hinv.log の対象レポートを処理した箇所でエラーを確認します。
ステップ 6 : サイト サーバーでサイト データベースへ取り込む
サイト サーバーの Inventory Data Loader は、MIF ファイルを処理してサイト データベースへ情報を取り込みます。dataldr.log では、ファイル名で処理開始箇所を見つけ、クライアント GUID を確認しながら追跡します。
全件更新では、MP_Hinv.log で生成された HDUMCY0A.MIF が process フォルダーへ移動しています。
1 | Moving MIF file E:\ConfigMgr\inboxes\auth\dataldr.box\HDUMCY0A.MIF to E:\ConfigMgr\inboxes\auth\dataldr.box\process\HDUMCY0A.MIF |
中略
1 | CMachineSource::InsertMachine - machine info is resynced data (ie: MIF is a full/resync report). |
中略
1 | Begin transaction: Machine=CLIENT01(GUID:631942E3-EC38-4623-8D15-22BFD5C175C5) |
中略
1 | Done: Machine=CLIENT01(GUID:631942E3-EC38-4623-8D15-22BFD5C175C5) code=0 (1952 stored procs in XHDUMCY0A.MIF) |
full/resync report の行は、この MIF が全件の再同期として扱われたことを示しています。続く Commit transaction と、同じ処理の Done、code=0 により、取り込み成功を確認できます。
差分更新では、H31MBSZJ.MIF を追跡します。
1 | Moving MIF file E:\ConfigMgr\inboxes\auth\dataldr.box\H31MBSZJ.MIF to E:\ConfigMgr\inboxes\auth\dataldr.box\process\H31MBSZJ.MIF |
中略
1 | Begin transaction: Machine=CLIENT01(GUID:631942E3-EC38-4623-8D15-22BFD5C175C5) |
中略
1 | Commit transaction: Machine=CLIENT01(GUID:631942E3-EC38-4623-8D15-22BFD5C175C5) |
中略
1 | Done: Machine=CLIENT01(GUID:631942E3-EC38-4623-8D15-22BFD5C175C5) code=0 (12 stored procs in XH31MBSZJ.MIF) |
差分側も同じクライアントの取り込み成功を確認できます。処理完了行では、ここに示すように MIF 名の先頭に X が付いた名前が記録されています。
取り込みが確認できない場合は、dataldr.log の対象 MIF に対するエラーや拒否の記録を確認します。差分欠落時の全件要求と、通信やファイル変換の失敗を区別して、処理が止まっている工程を絞り込みます。全件収集の実行方法を含む確認手順は、関連記事 ハードウェア インベントリ情報が採取されない場合のトラブルシューティング もご参照ください。
このように、起動記録、InventoryAgent.log のレポート種類と送信 ID、CcmMessaging.log の配送結果、MP_Hinv.log の MIF ファイル名、dataldr.log の取り込み結果を順に確認すると、クライアントからサイト データベースまでを追跡できます。