Msvm_StorageAlert class

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

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

See also

CIM_AlertIndication

Msvm_LogicalDisk

Msvm_ResourcePool