前回から始まった「Hyper-V健康診断」シリーズでは、PowerShellによるHyper-Vのプラットフォーム側の管理の効率化を目指しています。前回はHyper-Vホストの構成情報を1つのCLIXMLファイル（.xml）として保存する棚卸スクリプト「get-hypervhostinventory.ps1」（プレーンテキストで表示/ダウンロード）とそのデータを参照して概要をレポートする「get-hypervhostsummary.ps1」（プレーンテキストで表示/ダウンロード）を紹介しました。今回はCLIXMLファイル（.xml）の棚卸データの参照方法について説明します。前回指摘したように、「get-hypervhostsummary.ps1」は参照方法の一例です。

棚卸データの読み取りとオブジェクトの構造

　前回の棚卸スクリプト「get-hypervhostinventory.ps1」は、コンピューターの基本情報（Get-ComputerInfo、Get-WindowsFeatureなど）、Hyper-Vの設定（Get-VMHost、Get-Clusterなど）、ネットワーク（Get-NetAdapter、Get-VMSwitch、Get-NetIPConfigurationなど）、ストレージ（Get-PhysicalDisk、Get-Volume、Get-ClusterSharedVolumeなど）、イベントログ（Get-WinEvent）の各コマンドレットが返すオブジェクトを、Export-Clixmlを使用して1つのCLIXMLファイル（.xml）に保存します。

　CLIXMLファイル（.xml）に保存されたHyper-Vホストの棚卸データは、次のようにImport-Clixmlを使用してPowerShellオブジェクトとして復元することができます。ただし、前回も指摘しましたが、Import-Clixmlで完全に元のオブジェクトを復元できるわけではない点には注意が必要です。読み込んだオブジェクトは、Deserialized.*オブジェクト（元のオブジェクトの状態を保存したコピー、スナップショットのようなもの）となり、メソッドやライブオブジェクトとしての動作は失われます。

　XML（CLIXML）からインポートしたPowerShellオブジェクト（上記の$inventory）には、次のような階層構造に各種情報が格納されています。

　例えば、ホストのオペレーティングシステム名やOSビルドは、$inventory.osInfo.OperatingSystemや$inventory.osInfo.OSBuildで参照できます。$inventory.VirtualMachinesは、データ取得時点のGet-VMと同じ内容に加えて、クラスター化されているか（.HA）、および各VMに紐づくGet-VMProcessor（.VCPU）、Get-VMMemory（.VRAM）、Get-VMFirmware（.VMFirmware）などの追加情報が格納されていています（画面1）。$inventory.Network.IPAddressesは取得時点のIPアドレス関連設定が、$inventory.HyperVLogsには、取得時点から過去24時間の重大/エラー/警告レベルのログが格納されています（画面2）。

画面1　Import-ClixmlでデータをPowerShellオブジェクトとして読み込めば、データ取得時点の各種オブジェクトの内容を参照できる

画面2　データ取得時過去24時間の重大/エラーレベルのシステム、アプリケーション、セキュリティ、Hyper-V関連イベントの表示

新旧データの比較

　次のように、異なるタイミングで取得した棚卸データをImport-Clixmlで読み込んで、それぞれオブジェクト変数に格納すれば、オブジェクトのプロパティの変更点を調査することができます（画面3）。

画面3　新旧棚卸データを読み込んでGet-VMHostの違いを比較

　棚卸データと現在の最新値を比較することもできます。例えば、棚卸データのGet-VMと、現在のGet-VMの結果を比較するには、次のようにそれぞれをオブジェクト変数に格納して比較します（画面4）。

画面4　棚卸データから読み込んだ過去のGet-VMの結果と、最新（現在）のGet-VMの結果を比較する

　比較対象が明確な場合、新旧データのオブジェクトのプロパティを突き合わせて調べればよいわけですが、膨大なプロパティの値をすべて調べるのは少し厄介です。PowerShellにはCompare-Objectというオブジェクトを比較するコマンドレットがありますが、例えば深いレベルを持つオブジェクトのルートで比較しても、オブジェクト内部のプロパティを再帰的に比較してくれるわけではありません。少なくとも、比較対象のプロパティを-Propertiesパラメーターで指定する必要があります。また、CLIXMLから読み込んだ複雑なオブジェクトでは、内部の設定値に違いがあっても差分として検出されないことがあります。

　実際の比較では、VMやホストなどの比較対象を取り出し、比較するプロパティを指定して新旧の値を比較する必要があります（画面2のスクリプトの例）。また、Get-VMHostやGet-VMなどの最新の実行結果と比較する場合は、オブジェクトの型の違いにも配慮する必要があります（例、Get-VMHostが返すMicrosoft.HyperV.PowerShell.VMHostオブジェクトに対して、棚卸データのHyperV.VMHostに格納されているのはDeserialized.Microsoft.HyperV.PowerShell.VMHostオブジェクト）。また、比較の際には、データ取得時の状態によって変化するプロパティ（Get-ComputerInfoのOsFreePhysicalMemory、OsLocalDateTime、Get-VMのStatus、CPUUsageなど）を比較対象から除外するなどの考慮も必要です。さらに、配列や複合オブジェクトを含むプロパティは、CLIXMLから読み込んだオブジェクトと現在のコマンドレットが返すオブジェクトで型や内部構造が異なる場合があり、単純な比較では不要な差分が検出されることがあります。そのため、棚卸データの比較では、構成変更として意味のあるプロパティを選んで比較することが重要です。

　そこで次回は、2つの棚卸データ間、または棚卸データと現在値の差分をレポートするスクリプトを作成して紹介します。　

ファイル形式をJSONに変換

　棚卸スクリプトは棚卸データをPowerShellで扱うためExport-Clixmlを使用しましたが、外部のツールと連携するためにJSON形式に変換して保存したり、JSON形式から読み込んだりすることもできます。それには、次のように実行します。なお、JSONへの変換では注意が必要なデータ型もあります。例えばEnum（列挙型）の値は、ConvertTo-Jsonで既定では数値として出力される場合があります。そのため、画面上では「Running」などと表示されていた値が、JSONでは対応する数値として保存されることがあります。PowerShell 6/7のConvertTo-JSONを使用する場合、-EnumsAsStringsパラメーターを使用すると、すべてのEnumを数値ではなく文字列として出力させることができます。また、棚卸データは深いオブジェクトを持ちますが、-Depth 15で十分であるかどうかは未確認です（超えた深さは切り捨てられます）。一方で、展開の深さの指定が大きすぎるとメモリ不足や例外エラーが発生することがあるので注意してください。

サーバー設定仕様書の自動生成サービス、SSD-assistanceのご紹介 　弊社の主力製品の1つ設定仕様書自動生成サービス「SSD-assistance」は、設定仕様書作成のためのデータ収集やドキュメント作成の手間と時間を省き、高品質で標準化された設定仕様書を自動生成するサービスです。SSD-assistanceは、「Hyper-V ホスト 設定仕様書」の作成に対応している上、「差分比較リスト」で構成の変更差分を視覚的に強調表示させることができます。これまで、そして次回以降の記事でやろうとしていることと同等のことは、実はSSD-assistanceを利用すれば誰でも、簡単に、すぐに実現することができます。ただこの連載記事では、SSD-assistanceでは手の届かない、Hyper-Vの深くて、細かいところまで手を伸ばせればと考えています。 Hyper-Vホスト設定仕様書のサンプル（クリックで拡大） 差分比較リストのサンプル（クリックで拡大）

リファレンス（Microsoft Learn）:

Get-ComputerInfo（PowerShell Management）｜Get-Service（PowerShell Management）｜Get-HotFix（PowerShell Management）｜Get-VMHost（Hyper-V）｜Get-VMHostNumaNode（Hyper-V）｜Get-VM（Hyper-V）｜Get-VMProcessor（Hyper-V）｜Get-VMMemory（Hyper-V）｜Get-VMFirmware（Hyper-V）｜Get-VMSecurity（Hyper-V）｜Get-VMNetworkAdapter（Hyper-V）｜Get-VMHardDiskDrive（Hyper-V）｜Get-VMSnapshot（Hyper-V）｜Get-VMReplicationServer（Hyper-V）｜Get-VMReplication（Hyper-V）｜Get-VMSwitch（Hyper-V）｜Get-Cluster（FailoverClusters）｜Get-ClusterGroup（FailoverClusters）｜Get-ClusterSharedVolume（FailoverClusters）｜Get-NetAdapter（NetAdapter）｜Get-PhysicalDisk（Storage）｜Get-Volume（Storage）｜Get-WinEvent（PowerShell Dignostics）｜Export-Clixml（PowerShell Utility）｜Import-Clixml（PowerShell Utility）｜ConvertTo-JSON（PowerShell Utility）｜ConvertFrom-JSON（PowerShell Utility）｜Compare-Object（PowerShell Utility） 

Hyper-V 小技・裏技集 目次｜(1) ｜(2)｜(3)