Msvm_SummaryInformation class

Used in the GetSummaryInformation method in the Msvm_VirtualSystemManagementService class to quickly retrieve common information related to a virtual machine or snapshot.

The following syntax is simplified Managed Object Format (MOF) code.

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SummaryInformation
{
  string                       Name;
  string                       ElementName;
  uint16                       EnabledState;
  uint16                       HealthState;
  string                       Notes;
  uint16                       NumberOfProcessors;
  uint8                        ThumbnailImage[];
  DateTime                     CreationTime;
  uint16                       ProcessorLoad;
  uint16                       ProcessorLoadHistory[];
  uint64                       MemoryUsage;
  sint32                       MemoryAvailable;
  sint32                       AvailableMemoryBuffer;
  uint16                       Heartbeat;
  uint64                       UpTime;
  string                       GuestOperatingSystem;
  uint16                       OperationalStatus[];
  string                       StatusDescriptions[];
  CIM_VirtualSystemSettingData Snapshots[];
  CIM_ConcreteJob              AsynchronousTasks[];
  string                       AllocatedGPU;
};

Members

The Msvm_SummaryInformation class has these types of members:

• Properties

Properties

The Msvm_SummaryInformation class has these properties.

AllocatedGPU

Data type: string

Access type: Read-only

The identifier of the physical graphics processing unit (GPU) allocated to this virtual machine (VM). This property only applies to VMs that use RemoteFX.

Windows Server 2008 R2 and Windows Server 2008: This property is not supported before Windows Server 2008 R2 with SP1.

AsynchronousTasks

Data type: CIM_ConcreteJob array

Access type: Read-only

Qualifiers: ArrayType ("Indexed")

An array of Msvm_ConcreteJob instances that represent any asynchronous operations related to the virtual system which are currently executing. This property is not valid for instances of Msvm_SummaryInformation that represent a virtual system snapshot.

AvailableMemoryBuffer

Data type: sint32

Access type: Read-only

The percentage of available memory buffer for the virtual machine (VM). When dynamic memory is enabled for a VM, this property represents the ratio of available memory buffer to the ideal memory buffer for the VM. The ideal memory buffer size is configured by using the TargetMemoryBuffer property of the Msvm_MemorySettingData class.

This property is not valid for instances of the Msvm_SummaryInformation class that represent virtual machines for which dynamic memory is not enabled.

This property is not valid for instances of the Msvm_SummaryInformation class that represent a virtual system snapshot.

Windows Server 2008 R2 and Windows Server 2008: This property is not supported before Windows Server 2008 R2 with SP1.

CreationTime

Data type: DateTime

Access type: Read-only

The time at which the virtual system or snapshot was created.

ElementName

Data type: string

Access type: Read-only

The friendly name for the virtual system or snapshot.

EnabledState

Data type: uint16

Access type: Read-only

The current state of the virtual system or snapshot.

GuestOperatingSystem

Data type: string

Access type: Read-only

The name of the guest operating system, if available. If this information is not available, the value of this property is NULL. This property is not valid for instances of Msvm_SummaryInformation that represent a virtual system snapshot.

HealthState

Data type: uint16

Access type: Read-only

The current health state for the virtual system. This property is not valid for instances of Msvm_SummaryInformation that represent a virtual system snapshot.

Heartbeat

Data type: uint16

Access type: Read-only

The current heartbeat status for the virtual system. For more information, see the documentation for the StatusDescriptions property of the Msvm_HeartbeatComponent class. This property is not valid for instances of Msvm_SummaryInformation that represent a virtual system snapshot.

OK (2)

Error (6)

No Contact (12)

Lost Communication (13)

MemoryAvailable

Data type: sint32

Access type: Read-only

The percentage of the current memory available to the virtual machine (VM). When dynamic memory is enabled for a VM, this property represents the ratio of available memory of the VM to the total physical memory assigned to the VM. When a VM has no available memory, this property will be negative, and it will contain the ratio of memory needed for the VM to the total physical memory assigned to the VM.

This property is not valid for instances of the Msvm_SummaryInformation class that represent virtual machines for which dynamic memory is not enabled.

This property is not valid for instances of the Msvm_SummaryInformation class that represent a virtual system snapshot.

Windows Server 2008 R2 and Windows Server 2008: This property is not supported before Windows Server 2008 R2 with SP1.

MemoryUsage

Data type: uint64

Access type: Read-only

The current memory usage of the virtual system. This property is not valid for instances of Msvm_SummaryInformation that represent a virtual system snapshot.

Name

Data type: string

Access type: Read-only

The unique name for the virtual system or snapshot.

Notes

Data type: string

Access type: Read-only

The notes associated with the virtual system or snapshot.

NumberOfProcessors

Data type: uint16

Access type: Read-only

The total number of virtual processors allocated to the virtual system or snapshot.

OperationalStatus

Data type: uint16 array

Access type: Read-only

Qualifiers: ArrayType ("Indexed")

The current statuses of the virtual system. This corresponds to the OperationalStatus property of the Msvm_ComputerSystem class.

Windows Server 2008: This property is not supported before Windows Server 2008 R2.

ProcessorLoad

Data type: uint16

Access type: Read-only

The current processor usage of the virtual system. This property is not valid for instances of Msvm_SummaryInformation representing a virtual system snapshot.

ProcessorLoadHistory

Data type: uint16 array

Access type: Read-only

Qualifiers: ArrayType ("Indexed")

An array of the previous 100 samples of the processor usage for the virtual system. This property is not valid for instances of Msvm_SummaryInformation that represent a virtual system snapshot.

Snapshots

Data type: CIM_VirtualSystemSettingData array

Access type: Read-only

Qualifiers: ArrayType ("Indexed")

An array of Msvm_VirtualSystemSettingData instances representing the snapshots for the virtual system. This property is not valid for instances of Msvm_SummaryInformation that represent a virtual system snapshot.

StatusDescriptions

Data type: string array

Access type: Read-only

Qualifiers: ArrayType ("Indexed")

Strings that describe the corresponding OperationalStatus array values. This corresponds to the StatusDescriptions property of the Msvm_ComputerSystem class.

Windows Server 2008: This property is not supported before Windows Server 2008 R2.

ThumbnailImage

Data type: uint8 array

Access type: Read-only

Qualifiers: ArrayType ("Indexed")

An array that contains a small, thumbnail-sized image of the desktop for the virtual system or snapshot in RGB565 format.

UpTime

Data type: uint64

Access type: Read-only

The amount of time since the virtual system was last booted. This property is not valid for instances of Msvm_SummaryInformation representing a virtual system snapshot.

Remarks

Access to the Msvm_SummaryInformation class might be restricted by UAC Filtering. For more information, see User Account Control and WMI.

Requirements

Minimum supported client	None supported
Minimum supported server	Windows Server 2008
End of client support	None supported
End of server support	Windows Server 2012 R2
Namespace	Root\Virtualization
MOF	WindowsVirtualization.mof

See also

Virtual System Classes