Export (0) Print
Expand All

Msvm_ResourcePool class

Hyper-V

Describes a type of virtual resource available for use in virtual systems. The resource pool aggregates physical resources and is used to allocate resources to virtual systems. In Hyper-V, all resource pools are primordial, and there is exactly one pool for each specific type of resource which may be allocated to a virtual machine.

The following syntax is simplified Managed Object Format (MOF) code, and it includes all of the inherited properties.

Syntax

class Msvm_ResourcePool : CIM_ResourcePool
{
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  uint16   HealthState = 5;
  string   InstanceID = "Microsoft:GUID\Root";
  string   PoolID = "Microsoft:GUID\Root";
  boolean  Primordial = False;
  uint64   Capacity;
  uint64   Reserved;
  uint16   ResourceType = 4;
  string   OtherResourceType;
  string   ResourceSubType;
  string   AllocationUnits = "Megabyte";
};

Members

The Msvm_ResourcePool class has these types of members:

Properties

The Msvm_ResourcePool class has these properties.

AllocationUnits
Data type: string
Access type: Read-only

The units of allocation used by the resource pool. This property is inherited from CIM_ResourcePool and it is set to "Megabyte".

Capacity
Data type: uint64
Access type: Read-only

The maximum amount (in units of AllocationUnits) of active reservations that the resource pool can support. This property is inherited from CIM_ResourcePool.

Caption
Data type: string
Access type: Read-only
Qualifiers: MaxLen (64)

A short textual description (one-line string) of the object. This property is inherited from CIM_ManagedElement and its value depends on the type of resource being aggregated.

Description
Data type: string
Access type: Read-only

A textual description of the object. This property is inherited from CIM_ManagedElement.

ElementName
Data type: string
Access type: Read-only

A user-friendly name for the object. This property allows each instance to define a user-friendly name in addition to its key properties, identity data, and description information. Note that the Name property of the CIM_ManagedSystemElement class is also defined as a user-friendly name. But, it is often subclassed to be a Key. It is not reasonable that the same property can convey both identity and a user-friendly name, without inconsistencies. Where Name exists and is not a Key (such as for instances of LogicalDevice), the same information can be present in both the Name and ElementName properties. This property is inherited from CIM_ManagedElement.

HealthState
Data type: uint16
Access type: Read-only

The current health of the element. This property is inherited from CIM_ManagedSystemElement and it is always set to 5 (OK).

InstallDate
Data type: datetime
Access type: Read-only

The date and time at which the virtual system was created. This property is inherited from CIM_ManagedSystemElement.

InstanceID
Data type: string
Access type: Read-only

A unique identifier for this resource pool. This property is inherited from CIM_ResourcePool and it is always set to "Microsoft:GUID\Root".

Name
Data type: string
Access type: Read-only
Qualifiers: MaxLen (1024)

The label by which the object is known. When subclassed, this property can be overridden to be a key property. This property is inherited from CIM_ManagedSystemElement.

OperationalStatus
Data type: uint16 array
Access type: Read-only

The current status of the element. This property is inherited from CIM_ManagedSystemElement and it is always set to 2 (OK). Hyper-V will only ever use the first element of this array.

OtherResourceType
Data type: string
Access type: Read-only

A string that describes the resource type when a well-defined value is not available and ResourceType is set to 0 ("Other"). This property is inherited from CIM_ResourcePool and it is set to NULL.

PoolID
Data type: string
Access type: Read-only

This value is referenced by the CIM_ResourceAllocationSettingData instances which were allocated from this pool. This property is inherited from CIM_ResourcePool and it is always set to "Microsoft:GUID\Root".

Primordial
Data type: boolean
Access type: Read-only

If True, "Primordial" indicates whether this resource pool is the base from which resources are drawn and returned in the activity of resource management. Being primordial means that this resource pool shall not be created or deleted by consumers of this model. However, other actions, modeled or not, may affect the characteristics or size of primordial resource pools. This property is inherited from CIM_ResourcePool.

Reserved
Data type: uint64
Access type: Read-only

The current reservations (in units of AllocationUnits) spread across all active allocations from this pool. In a hierarchical configuration, this represents the sum of all descendant resource pool current reservations. This property is inherited from CIM_ResourcePool.

ResourceSubType
Data type: string
Access type: Read-only

A string that describes an implementation specific sub-type for this pool. For example, this may be used to distinguish different models of the same resource type. This property is inherited from CIM_ResourcePool.

ResourceType
Data type: uint16
Access type: Read-only

The type of resource this resource pool may allocate. This property is inherited from CIM_ResourcePool and it is set to 4 ("Memory").

Status
Data type: string
Access type: Read-only

This property is inherited from CIM_ManagedSystemElement but it is not used.

StatusDescriptions
Data type: string array
Access type: Read-only

Strings that describe the various OperationalStatus array values. This property is inherited from CIM_ManagedSystemElement and it is always set to "OK". Hyper-V will only ever use the first element of this array.

Remarks

Access to the Msvm_ResourcePool 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

Namespace

\\.\Root\Virtualization

MOF

WindowsVirtualization.mof

See also

CIM_ResourcePool
Msvm_ResourcePool (V2)
Resource Management Classes

 

 

Community Additions

ADD
Show:
© 2014 Microsoft