Msvm_StorageAlert class

Article
08/25/2021

Represents an event that is raised each time the OperationalStatus property of the Msvm_ResourcePool or Msvm_LogicalDisk class changes.

The following syntax is simplified from MOF code and includes these properties.

Syntax

[Indication, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_StorageAlert : CIM_AlertIndication
{
  string   AlertingManagedElement[];
  uint16   AlertingElementFormat;
  uint16   OtherAlertingElementFormat;
  uint16   AlertType;
  uint16   PerceivedSeverity;
  uint16   ProbableCause;
  string   ProbableCauseDescription;
  datetime EventTime;
  string   OwningEntity;
  string   MessageArguments[];
  string   MessageID;
  string   Message;
};

Members

The Msvm_StorageAlert class has these types of members:

Properties

Properties

The Msvm_StorageAlert class has these properties.

AlertingElementFormat

Data type: uint16
Access type: Read-only
Qualifiers: ModelCorrespondence ("CIM_AlertIndication.AlertingManagedElement", "CIM_AlertIndication.OtherAlertingElementFormat")

Specifies the format of the AlertingManagedElement property. The format is a CIMObjectPath, with the format <NamespacePath>:<ClassName>.<Prop1>=\"<Value1>\", "<Prop2>=\"<Value2>\", which specifies an instance in the CIM Schema.

This property is inherited from the CIM_AlertIndication class.

The possible values are:

Unknown (0)
Other (1)
CIMObjectPath (2)

AlertingManagedElement

Data type: string array
Access type: Read-only

The WMI paths of the instance for which the alert is generated.

AlertType

Data type: uint16
Access type: Read-only

Specifies the primary classification of the alert. The possible values for this property are:

Quality of Service Alert (3)

EventTime

Data type: datetime
Access type: Read-only

The date and time at which the underlying event was detected.

Message

Data type: string
Access type: Read-only

A formatted message that is constructed by combining some or all of the dynamic elements that are specified in the MessageArguments property with the static elements uniquely identified by the MessageID property in a message registry or other catalog associated with the OwningEntity property.

MessageArguments

Data type: string array
Access type: Read-only

An array that contains the dynamic content of the message. If the value of MessageID is 32930, the argument at position 0 is the PoolID of the Msvm_ResourcePool instance for which the alert is generated.

MessageID

Data type: string
Access type: Read-only

Uniquely identifies, within the scope of the OwningEntity property, the format of the Message property. The possible values for this property are:

32930 ("Storage Pool QoS Insufficient Throughput Message")

OtherAlertingElementFormat

Data type: uint16
Access type: Read-only

A string that defines "Other" values for AlertingManagedElement. This value MUST be set to a non NULL value when AlertingManagedElement is set to a value of 1 ("Other"). For all other values of AlertingManagedElement, the value of this string must be set to NULL.

This property is inherited from the CIM_AlertIndication class.

OwningEntity

Data type: string
Access type: Read-only

Uniquely identifies the entity that owns the definition of the format of the Message described in this instance. The value of this property is always "Microsoft-Windows- Hyper-V."

"Microsoft-Windows- Hyper-V"

PerceivedSeverity

Data type: uint16
Access type: Read-only

Describes the severity of the alert indication. The possible values for this property are:

Information (2)
Degraded/Warning (3)

ProbableCause

Data type: uint16
Access type: Read-only

Describes the probable cause of the situation that resulted in the alert indication.

Storage Capacity Problem (50)
Previous Alert Cleared (59)

ProbableCauseDescription

Data type: string
Access type: Read-only

A textual description that corresponds to the value of the ProbableCause property.

Remarks

The Hyper-V WMI provider won't raise events for individual virtual disks to avoid flooding clients with events in case of large scale malfunctions of the underlying storage systems.

When a client receives an Msvm_StorageAlert event, if the value of the ProbableCause property is 50 ( Storage Capacity Problem ), the client can discover which virtual disks are operating outside their QoS policy by using one of these procedures:

Query all the Msvm_LogicalDisk instances that were allocated from the resource pool for which the event was generated. These Msvm_LogicalDisk instances are associated to the resource pool via the Msvm_ElementAllocatedFromPool association.
Filter the result list by selecting instances whose OperationalStatus contains Insufficient Throughput .

Requirements

Requirement	Value
Minimum supported client	Windows 8.1 [desktop apps only]
Minimum supported server	Windows Server 2012 R2 [desktop apps only]
Namespace	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe