Share via


CIM_Capabilities class

An abstract class for subclasses that describes the abilities of an associated managed element, and the potential of the abilities. For example, a capability can describe the maximum number of VLANs that can be supported on a system using a subclass of CIM_Capabilities.

Capabilities are tied to the elements which they describe using a CIM_ElementCapabilities class association. A CIM_Capabilities object must be associated with a CIM_ManagedElement object, however, the CIM_Capabilities object cannot be associated with more than one manage element. This class does not indicate what is configured or operational. Instead, it indicates what can and cannot exist, be defined, or be used. It is possible to describe both supported and excluded abilities and functions (capabilities and limitations) using this class.

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

Syntax

[Abstract, Version("2.11.0"), AMENDMENT]
class CIM_Capabilities : CIM_ManagedElement
{
  string Caption;
  string Description;
  string InstanceID;
  string ElementName;
};

Members

The CIM_Capabilities class has these types of members:

Methods

The CIM_Capabilities class has these methods.

Method Description
CreateGoalSettings Creates a set of supported SettingData elements, from two sets of SettingData elements, provided by the caller.

Properties

The CIM_Capabilities class has these properties.

Caption

Data type: string

Access type: Read-only

Qualifiers: MaxLen (64)

A short textual description of the object.

This property is inherited from CIM_ManagedElement.

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

Qualifiers: Required, Override ("ElementName")

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.

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.

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_ManagedElement