Msvm_SummaryInformation 類別
用於Msvm_VirtualSystemManagementService類別中的GetSummaryInformation和GetDefinitionFileSummaryInformation方法,以快速擷取與虛擬機器或快照集相關的一般資訊。
下列語法是簡化 Managed 物件格式 (MOF) 程式碼。
語法
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SummaryInformation : Msvm_SummaryInformationBase
{
string InstanceID;
string AllocatedGPU;
boolean Shielded;
CIM_ConcreteJob AsynchronousTasks[];
DateTime CreationTime;
string ElementName;
uint16 EnabledState;
string OtherEnabledState;
string GuestOperatingSystem;
uint16 HealthState;
uint16 Heartbeat;
uint64 MemoryUsage;
sint32 MemoryAvailable;
sint32 AvailableMemoryBuffer;
boolean SwapFilesInUse;
string Name;
string Notes;
string Version;
uint16 NumberOfProcessors;
uint16 OperationalStatus[];
uint16 ProcessorLoad;
uint16 ProcessorLoadHistory[];
CIM_VirtualSystemSettingData Snapshots[];
string StatusDescriptions[];
uint8 ThumbnailImage[];
uint16 ThumbnailImageHeight;
uint16 ThumbnailImageWidth;
uint64 UpTime;
uint16 ReplicationState;
uint16 ReplicationStateEx[];
uint16 ReplicationHealth;
uint16 ReplicationHealthEx[];
uint16 ReplicationMode;
CIM_ComputerSystem REF TestReplicaSystem;
uint16 ApplicationHealth;
uint16 IntegrationServicesVersionState;
boolean MemorySpansPhysicalNumaNodes;
string ReplicationProviderId[];
uint16 EnhancedSessionModeState;
string VirtualSwitchNames[];
string VirtualSystemSubType;
string HostComputerSystemName;
};
成員
Msvm_SummaryInformation類別具有下列類型的成員:
屬性
Msvm_SummaryInformation類別具有這些屬性。
-
AllocatedGPU
-
-
資料類型: 字串
-
存取類型:唯讀
配置給此虛擬機器的實體圖形處理單位識別碼 (GPU) 。 此屬性僅適用于使用 RemoteFX 的虛擬機器。
-
-
ApplicationHealth
-
-
資料類型: uint16
-
存取類型:唯讀
虛擬機器目前的應用程式健康情況狀態。 此屬性對代表虛擬機器快照 集的Msvm_SummaryInformation 實例無效。
-
-
確定 (2)
-
應用程式關鍵 (32782)
-
已停用 (32896)
AsynchronousTasks
-
資料類型: CIM_ConcreteJob 陣列
-
存取類型:唯讀
-
限定詞: ArrayType (「Indexed」)
Msvm_ConcreteJob實例的陣列,表示與目前執行之虛擬機器相關的任何非同步作業。 此屬性對代表虛擬機器快照 集的Msvm_SummaryInformation 實例無效。
AvailableMemoryBuffer
-
資料類型: sint32
-
存取類型:唯讀
虛擬機器可用記憶體緩衝區的百分比。 為虛擬機器啟用動態記憶體時,此屬性代表可用記憶體緩衝區與虛擬機器的理想記憶體緩衝區比率。 理想的記憶體緩衝區大小是使用Msvm_MemorySettingData類別的TargetMemoryBuffer屬性來設定。
此屬性對 Msvm_SummaryInformation 類別的實例無效,表示未啟用動態記憶體的虛擬機器。
此屬性對代表虛擬機器快照 集之 Msvm_SummaryInformation 類別的實例無效。
CreationTime
-
資料類型: DateTime
-
存取類型:唯讀
建立虛擬機器或快照集的時間。
ElementName
-
資料類型: 字串
-
存取類型:唯讀
虛擬機器或快照集的顯示名稱。
EnabledState
-
資料類型: uint16
-
存取類型:唯讀
虛擬機器或快照集的目前狀態。 如需可能的值,請參閱Msvm_ComputerSystem類別的EnabledState屬性。
EnhancedSessionModeState
-
資料類型: uint16
-
存取類型:唯讀
指出主機是否允許增強模式連線,如果允許,則是否可供虛擬機器使用。
Windows 8.1:Windows 8.1 和 Windows Server 2012 R2 之前,不支援此值。
允許和可用的 (2)
不允許 (3)
允許但無法使用 (6 )
GuestOperatingSystem
-
資料類型: 字串
-
存取類型:唯讀
如果有的話,客體作業系統的名稱。 如果無法使用這項資訊,此屬性的值會是 Null。 此屬性對代表虛擬機器快照 集的Msvm_SummaryInformation 實例無效。
HealthState
-
資料類型: uint16
-
存取類型:唯讀
虛擬機器的目前健全狀態。 此屬性對代表虛擬機器快照 集的Msvm_SummaryInformation 實例無效。
活動訊號
-
資料類型: uint16
-
存取類型:唯讀
虛擬機器的目前活動訊號狀態。 如需詳細資訊,請參閱Msvm_HeartbeatComponent類別之 StatusDescriptions屬性的檔。 此屬性對代表虛擬機器快照 集的Msvm_SummaryInformation 實例無效。
-
確定 (2)
-
錯誤 (6)
-
沒有連絡人 (12)
-
遺失通訊 (13)
HostComputerSystemName
-
資料類型: 字串
-
存取類型:唯讀
裝載此虛擬機器的電腦名稱稱。
注意
已在 Windows 10 中新增。
InstanceID
InstanceID 是選擇性屬性,可用來在具現化命名空間的範圍內不透明且唯一地識別這個類別的實例。 這個類別的各種子類別可能會覆寫此屬性,使其成為必要專案或索引鍵。 這類子類別也可以修改慣用的演算法,以確保以下定義的唯一性。
若要確保 NameSpace 內的唯一性,應該使用下列「慣用」演算法來建構 InstanceID 的值:
<OrgID > : < LocalID>
其中 < OrgID 和 < LocalID >> 是以冒號分隔 (:) ,而 < OrgID > 必須包含著作權、商標或其他唯一名稱,該名稱是由建立或定義 InstanceID 的商務實體所擁有,或是由辨識的全域授權單位指派給商務實體的已註冊識別碼。 (這項需求類似于 < 架構類別 > 名稱名稱的架構名稱 >< 結構。) 此外,為了確保唯一性, < OrgID > 不得包含冒號 (:) 。 使用此演算法時,在 InstanceID 中顯示的第一個冒號必須出現在 OrgID > 與 < LocalID > 之間 < 。
<LocalID > 是由商務實體選擇,不應重複使用來識別不同的基礎 (真實世界) 元素。 如果未使用 Null,且未使用上述「慣用」演算法,則定義實體必須確保產生的 InstanceID 不會在這個實例的 NameSpace 或其他提供者所產生的任何 InstanceID 之間重複使用。
如果 DMTF 定義實例未設定為 null,則必須將 「preferred」 演算法與設定為 CIM 的 < OrgID > 搭配使用。
注意
已在 Windows 10 中新增。
IntegrationServicesVersionState
-
資料類型: uint16
-
存取類型:唯讀
指出虛擬機器中安裝的整合服務是否為最新狀態。
未知 (0)
UpToDate (1)
不相符 (2)
MemoryAvailable
-
資料類型: sint32
-
存取類型:唯讀
虛擬機器目前可用記憶體的百分比。 為虛擬機器啟用動態記憶體時,此屬性代表虛擬機器可用記憶體與指派給虛擬機器之實體記憶體總數的比例。 當虛擬機器沒有可用的記憶體時,這個屬性會是負數,而且會包含虛擬機器所需的記憶體與指派給虛擬機器的實體記憶體總數的比例。
此屬性對 Msvm_SummaryInformation 類別的實例無效,表示未啟用動態記憶體的虛擬機器。
此屬性對代表虛擬機器快照 集之 Msvm_SummaryInformation 類別的實例無效。
MemorySpansPhysicalNumaNodes
-
資料類型: 布林值
-
存取類型:唯讀
指出虛擬機器的一或多個虛擬非單一記憶體存取的記憶體 (NUMA) 節點是否跨越主控電腦的多個實體 NUMA 節點。 如果記憶體跨越多個實體 NUMA 節點,則包含 True ,否則為 False 。
MemoryUsage
-
資料類型: uint64
-
存取類型:唯讀
虛擬機器的目前記憶體使用量,以 MB 為單位。 此屬性對代表虛擬機器快照 集的Msvm_SummaryInformation 實例無效。
名稱
-
資料類型: 字串
-
存取類型:唯讀
虛擬機器或快照集的唯一名稱。
注意事項
-
資料類型: 字串
-
存取類型:唯讀
與虛擬機器或快照集相關聯的附注。
NumberOfProcessors
-
資料類型: uint16
-
存取類型:唯讀
配置給虛擬機器或快照集的虛擬處理器總數。
OperationalStatus
-
資料類型: uint16 陣列
-
存取類型:唯讀
-
限定詞: ArrayType (「Indexed」)
虛擬機器的目前作業狀態。 如需可能的值,請參閱Msvm_ComputerSystem類別的OperationalStatus屬性。
OtherEnabledState
-
資料類型: 字串
-
存取類型:唯讀
字串,描述 EnabledState 屬性設定為 1 時專案的啟用或停用狀態。 當EnabledState是 1 以外的任何值時,此屬性將會設定為Null。
ProcessorLoad
-
資料類型: uint16
-
存取類型:唯讀
虛擬機器目前的處理器使用量,以百分比表示。 此屬性對代表虛擬機器快照 集的Msvm_SummaryInformation 實例無效。
ProcessorLoadHistory
-
資料類型: uint16 陣列
-
存取類型:唯讀
-
限定詞: ArrayType (「Indexed」)
虛擬機器先前 100 個處理器使用量範例的陣列,以百分比表示。 此屬性對代表虛擬機器快照 集的Msvm_SummaryInformation 實例無效。
ReplicationHealth
-
資料類型: uint16
-
存取類型:唯讀
-
限定詞:已 淘汰 (「Msvm_SummaryInformation。ReplicationHealthEx「)
虛擬機器的複寫健康情況。 如需可能的值,請參閱Msvm_ComputerSystem類別的ReplicationHealth屬性。
注意
從 Windows 8.1 開始,這個屬性已被取代;請改用ReplicationHealthEx。
不適用 (0)
確定 (1)
警告 (2)
重大 (3)
ReplicationHealthEx
-
資料類型: uint16 陣列
-
存取類型:唯讀
-
限定詞: ArrayType (「Indexed」)
虛擬機器之各種複寫關聯性的複寫健全狀況值陣列。 如需可能的值,請參閱 Msvm_ReplicationRelationship類別的ReplicationHealth屬性。
不適用 (0)
確定 (1)
警告 (2)
重大 (3)
ReplicationMode
-
資料類型: uint16
-
存取類型:唯讀
虛擬機器的複寫類型。 如需可能的值,請參閱Msvm_ComputerSystem類別的ReplicationMode屬性。
無 (0)
主要 (1)
複 本 (2)
測試複 本 (3)
擴充複 本 (4)
ReplicationProviderId
-
資料類型: 字串 陣列
-
存取類型:唯讀
-
限定詞: ArrayType (「Indexed」)
對於主要或擴充複本虛擬機器,這是主要複寫提供者識別碼。 對於複本虛擬機器,如果已啟用擴充複寫,這是擴充關聯性的提供者識別碼。
Windows 8.1:Windows 8.1 和 Windows Server 2012 R2 之前,不支援此值。
ReplicationState
-
資料類型: uint16
-
存取類型:唯讀
-
限定詞:已 淘汰 (「Msvm_SummaryInformation。ReplicationStateEx「)
虛擬機器的複寫狀態。 如需可能的值,請參閱Msvm_ComputerSystem類別的ReplicationState屬性。
注意
從 Windows 8.1 開始,這個屬性已被取代;請改用ReplicationStateEx。
已停用 (0)
準備好進行複寫 (1)
等候完成初始複寫 (2)
複寫 (3)
同步複寫完成 (4)
復原 (5)
認可 (6)
已暫停 (7)
重大 (8)
等候開始重新同步 處理 (9)
重新同步 (10)
重新同步處理已暫停 (11)
進行中的容錯移轉 (12)
ReplicationStateEx
-
資料類型: uint16 陣列
-
存取類型:唯讀
-
限定詞: ArrayType (「Indexed」)
虛擬機器各種複寫關聯性的複寫狀態值陣列。 如需可能的值,請參閱Msvm_ReplicationRelationship類別的ReplicationState屬性。
已停用 (0)
準備好進行複寫 (1)
等候完成初始複 寫 (2)
複寫 (3)
同步複寫完成 (4)
復原 (5)
認可 (6)
暫停 (7)
重大 (8)
等候重新同步 處理 (9)
重新同步 處理 (10)
重新同步處理已暫停 (11)
進行中的容錯移轉 (12)
進行中的容錯回復 (13)
容錯回復完成 (14)
進行中的磁片更新 (15)
注意
已在 Windows 10 1703 版和Windows Server 2016中新增。
磁片更新重大 (16)
注意
已在 Windows 10 1703 版和Windows Server 2016中新增。
未知 (17)
注意
已在 Windows 10 1703 版和Windows Server 2016中新增。
重新規劃進行中的複 寫 (18)
注意
已在 Windows 10 1703 版和Windows Server 2016中新增。
準備同步複寫 (19)
注意
已在 Windows 10 1703 版和Windows Server 2016中新增。
準備群組反向複寫 (20)
注意
已在 Windows 10 1703 版和Windows Server 2016中新增。
(21) 引發的rill
注意
已在 Windows 10 1703 版和Windows Server 2016中新增。
受防護
-
資料類型: 布林值
-
存取類型:唯讀
指出是否已針對虛擬機器設定防護。
注意
已在 Windows 10 1703 版和Windows Server 2016中新增。
快照集
-
資料類型: CIM_VirtualSystemSettingData 陣列
-
存取類型:唯讀
-
限定詞: ArrayType (「Indexed」)
Msvm_VirtualSystemSettingData實例的陣列,表示虛擬機器的快照集。 此屬性對代表虛擬機器快照 集的Msvm_SummaryInformation 實例無效。
StatusDescriptions
-
資料類型: 字串 陣列
-
存取類型:唯讀
-
限定詞: ArrayType (「Indexed」)
描述對應 OperationalStatus 陣列值的字串。 這會對應至Msvm_ComputerSystem類別的StatusDescriptions屬性。
SwapFilesInUse
-
資料類型: 布林值
-
存取類型:唯讀
指出第二層分頁是否為使用中。 如果第二層分頁為使用中,則包含 True ,否則為 False 。
TestReplicaSystem
-
資料類型: CIM_ComputerSystem
-
存取類型:唯讀
代表虛擬機器之測試複本虛擬機器 之CIM_ComputerSystem 實例的參考。 此屬性對代表虛擬機器快照 集的Msvm_SummaryInformation 實例無效。
ThumbnailImage
-
資料類型: uint8 陣列
-
存取類型:唯讀
-
限定詞: OctetString、 ArrayType (「Indexed」) 、 ModelCorrespondence (「Msvm_SummaryInformation。ThumbnailImageWidth「、」Msvm_SummaryInformation。ThumbnailImageHeight「)
陣列,包含虛擬機器或快照集的小型縮圖大小影像,以 RGB565 格式顯示。
ThumbnailImageHeight
-
資料類型: uint16
-
存取類型:唯讀
-
限定詞: ModelCorrespondence (「Msvm_SummaryInformation。ThumbnailImage「)
ThumbnailImage 屬性中影像的高度以圖元為單位。
注意
已在 Windows 10 中新增。
ThumbnailImageWidth
-
資料類型: uint16
-
存取類型:唯讀
-
限定詞: ModelCorrespondence (「Msvm_SummaryInformation。ThumbnailImage「)
ThumbnailImage 屬性中影像的寬度,以圖元為單位。
注意
已在 Windows 10 中新增。
UpTime
-
資料類型: uint64
-
存取類型:唯讀
上次開機虛擬機器之後的時間量。 此屬性對代表虛擬機器快照 集的Msvm_SummaryInformation 實例無效。
版本
-
資料類型: 字串
-
存取類型:唯讀
「major.minor」 格式的虛擬系統版本,例如 「2.0」。
注意
已在 Windows 10 中新增。
VirtualSwitchNames
-
資料類型: 字串 陣列
-
存取類型:唯讀
-
限定詞: ArrayType (「Indexed」)
字串,指定虛擬機器所連線之虛擬交換器的易記名稱。
Windows 8.1:Windows 8.1 和 Windows Server 2012 R2 之前,不支援此值。
VirtualSystemSubType
-
資料類型: 字串
-
存取類型:唯讀
虛擬系統的子類型。
Windows 8.1:Windows 8.1 和 Windows Server 2012 R2 之前,不支援此值。
Microsoft:Hyper-V:SubType:1 ()
Microsoft:Hyper-V:SubType:2 ()
備註
Msvm_SummaryInformation類別的存取可能會受限於 UAC 篩選。 如需詳細資訊,請參閱 使用者帳戶控制和 WMI。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2012 [僅限傳統型應用程式] |
命名空間 |
Root\Virtualization\V2 |
MOF |
|
DLL |
|