Msvm_AllocationCapabilities class

Defines the means by which a client can discover the valid range of default settings for a virtual resource. A Msvm_AllocationCapabilities object is associated with each resource pool. Four Msvm_ResourceAllocationSettingData objects are associated with the Msvm_AllocationCapabilities object to describe the minimum, maximum, default, and incremental values for the given resource's allocation. Together, these classes describe the overall range of supported capabilities.

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

Syntax

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_AllocationCapabilities : CIM_AllocationCapabilities
{
  string Caption;
  string Description;
  string InstanceID;
  string ElementName;
  uint16 ResourceType;
  string OtherResourceType;
  string ResourceSubType;
  uint16 RequestTypesSupported;
  uint16 SharingMode;
  uint16 SupportedAddStates[];
  uint16 SupportedRemoveStates[];
};

Members

The Msvm_AllocationCapabilities class has these types of members:

Methods

The Msvm_AllocationCapabilities class has these methods.

Method Description
CreateGoalSettings Creates a set of supported SettingData elements, from two sets of SettingData elements, provided by the caller.
This method is inherited from CIM_Capabilities.

Properties

The Msvm_AllocationCapabilities class has these properties.

Caption

Data type: string

Access type: Read-only

Qualifiers: MaxLen (64)

A short textual description of the object. Currently set to "Microsoft Virtual Machine Resource Pool Allocation Capabilities".

This property is inherited from CIM_ManagedElement.

Description

Data type: string

Access type: Read-only

A textual description of the object. Currently set to "Microsoft Virtual Machine Resource Pool Allocation Capabilities"

This property is inherited from CIM_ManagedElement.

ElementName

Data type: string

Access type: Read-only

Qualifiers: Required

The user friendly name for this class instance. In addition, the user friendly name can be used as a index property for a query. This value does not have to be unique within its namespace.

This property is inherited from CIM_Capabilities.

InstanceID

Data type: string

Access type: Read-only

Qualifiers: Key

Uniquely and opaquely identifies an instance of this class within the scope of the containing namespace.

[!Important]

In order to ensure uniqueness within the namespace, the value of the InstanceID property should be constructed in the following pattern: OrgID:LocalID

OrgID must include a copyrighted, trademarked or otherwise unique name that is owned by the business entity that defines the InstanceID, or be a registered ID that is assigned by a recognized global authority. This pattern is similar to the structure of schema class names. In addition, to ensure uniqueness, the first colon in InstanceID must be between the OrgID andLocalID. Therefore the OrgID must not contain a colon (':').

LocalID is chosen by the business entity and should not be re-used to identify different underlying real-world elements.

If the above pattern is not used, the defining entity must assure that the resultant InstanceID value is not re-used across any InstanceID properties that are produced by this provider or other providers for this namespace.

For Distributed Management Task Force (DMTF) defined instances, the pattern must be used with the OrgID set to CIM.

This property is inherited from CIM_Capabilities.

OtherResourceType

Data type: string

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_ResourceAllocationSettingData.ResourceType")

The resource type for this allocation setting when the ResourceType property is set to "1" (Other).

This property is inherited from CIM_AllocationCapabilities.

RequestTypesSupported

Data type: uint16

Access type: Read-only

Indicates whether requesting a specific resource is supported.

This property is inherited from CIM_AllocationCapabilities.

Unknown (0)

Specific (1)

General (2)

Both (3)

DMTF reserved

4 32767

Vendor Reserved

32768 65535

ResourceSubType

Data type: string

Access type: Read-only

A description of an implementation specific sub-type for this resource. For example, this may be used to distinguish different models of the same resource type.

This property is inherited from CIM_AllocationCapabilities.

ResourceType

Data type: uint16

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_AllocationCapabilities.OtherResourceType", "CIM_ResourceAllocationSettingData.ResourceType")

The type of resource that is assigned to this allocation setting.

This property is inherited from CIM_AllocationCapabilities.

Other (1)

Computer System (2)

Processor (3)

Memory (4)

IDE Controller (5)

Parallel SCSI HBA (6)

FC HBA (7)

iSCSI HBA (8)

IB HCA (9)

Ethernet Adapter (10)

I/O Slot (11)

I/O Device (12)

Floppy Drive (13)

CD/DVD drive (14)

Serial port (15)

Parallel port (16)

USB Controller (17)

Graphics controller (18)

Disk (19)

Tape (20)

Other storage device (21)

Firewire Controller (22)

Partitionable Unit (23)

Base Partitionable Unit (24)

Power Supply (25)

Cooling Device (26)

DMTF reserved (27)

DMTF reserved

28 32767

Vendor Reserved

32768 65535

SharingMode

Data type: uint16

Access type: Read-only

Indicates how access to the underlying resource is granted.

This property is not used.

This property is inherited from CIM_AllocationCapabilities.

Unknown (0)

Dedicated (1)

Shared (2)

DMTF reserved

3 32767

Vendor Reserved

32768 65535

SupportedAddStates

Data type: uint16 array

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

The system states that are supported when a new resource is created.

This property is not used.

This property is inherited from CIM_AllocationCapabilities.

Unknown (0)

Other (1)

Enabled (2)

Disabled (3)

Shutting Down (4)

Not Applicable (5)

Enabled but Offline (6)

In Test (7)

Deferred (8)

Quiesce (9)

Starting (10)

Paused (11)

Suspended (12)

DMTF Reserved

13 32767

Vendor Reserved

32768 65535

SupportedRemoveStates

Data type: uint16 array

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

The system states that are supported when a resource is removed.

This property is not used.

This property is inherited from CIM_AllocationCapabilities.

Unknown (0)

Other (1)

Enabled (2)

Disabled (3)

Shutting Down (4)

Not Applicable (5)

Enabled but Offline (6)

In Test (7)

Deferred (8)

Quiesce (9)

Starting (10)

Paused (11)

Suspended (12)

DMTF Reserved

13 32767

Vendor Reserved

32768 65535

Remarks

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

CIM_AllocationCapabilities

CIM_AllocationCapabilities

Msvm_AllocationCapabilities (V2)

Resource Management Classes