Partager via


CIM_RegisteredProfile class

Used to advertise implementation conformance to a CIM profile. CIM_RegisteredProfiles instances can be defined by the Distributed Management Task Force (DMTF) or other standards organizations. CIM_RegisteredProfile is a named standard for CIM-based management of a particular system, subsystem, service or other entity, for a specified set of uses. It is a complete, standalone definition. The uses for CIM_RegisteredProfile must be specified in the document that defines the profile. Profiles can manage various aspects of an operating system, storage array, or database. The name of the profile is defined and scoped by its authoring organization.

Important  The DMTF (Distributed Management Task Force) CIM (Common Information Model) classes are the parent classes upon which WMI classes are built. WMI currently supports only the CIM 2.x version schemas.

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

Syntax

[Version("2.22.0"), UMLPackagePath("CIM::Interop"), AMENDMENT]
class CIM_RegisteredProfile : CIM_ManagedElement
{
  string InstanceID;
  uint16 RegisteredOrganization;
  string OtherRegisteredOrganization;
  string RegisteredName;
  string RegisteredVersion;
  uint16 AdvertiseTypes[];
  string AdvertiseTypeDescriptions[];
};

Members

The CIM_RegisteredProfile class has these types of members:

  • Properties

Properties

The CIM_RegisteredProfile class has these properties.

AdvertiseTypeDescriptions

Data type: string array

Access type: Read-only

Qualifiers: ArrayType ("Indexed") , ModelCorrespondence ("CIM_RegisteredProfile.AdvertiseTypes")

Provides additional information related to the AdvertiseType property. A description must be provided when the AdvertiseType is set to 1 (Other). An entry in this array corresponds to the entry in the AdvertiseTypes array at the same index. Additional descriptions are not needed if the AdvertiseType is set to "Not Advertised" or "SLP". However, as the SLP template expands or as other advertisement mechanisms are defined, support for additional descriptions might be needed. This array is defined to support this expansion.

AdvertiseTypes

Data type: uint16 array

Access type: Read-only

Qualifiers: Required, ArrayType ("Indexed") , ModelCorrespondence ("CIM_RegisteredProfile.AdvertiseTypeDescriptions")

Signifies the advertisement for the profile information. It is used by the advertising services of the WBEM infrastructure to determine what should be advertised and through what mechanisms. The property is an array so that the profile can be advertised by using several mechanisms.

Note  If this property is null or uninitialized, this value is equivalent to specifying the value 2 (Not Advertised).

Other (1)

Not Advertised (2)

SLP (3)

InstanceID

Data type: string

Access type: Read-only

Qualifiers: Key, Override ("InstanceID")

Opaquely and uniquely identifies an instance of the CIM_RegisteredProfile class within the scope of the instantiating namespace. The InstanceID property should be constructed by using the following preferred algorithm to ensure uniqueness within the namespace: "<OrgID>:<LocalID>". When using this algorithm, the first colon to appear in InstanceID must appear between <OrgID> and <LocalID>.

<OrgID> must include a copyrighted, trademarked or otherwise unique name that is owned by the business entity that creates or defines the InstanceID or that is a registered ID that is assigned to the business entity by a recognized global authority. This format is similar to the <Schema Name>_<Class Name> structure of schema class names. In addition, <OrgID> must not contain a colon.

<LocalID> is chosen by the organizational entity and should not be re-used to identify different underlying elements.

If this algorithm is not used, the defining entity must assure that the resultant InstanceID property is not re-used across any InstanceID properties produced by this or other providers for this instance's namespace.

For DMTF defined instances, the preferred algorithm must be used with the <OrgID> set to "CIM".

OtherRegisteredOrganization

Data type: string

Access type: Read-only

Qualifiers: MaxLen (256) , ModelCorrespondence ("CIM_RegisteredProfile.RegisteredOrganization")

Provides the description of an organization when RegisteredOrganization property is set to 1.

RegisteredName

Data type: string

Access type: Read-only

Qualifiers: Required, MaxLen (256)

Specifies the name of the profile that has been assigned by the organization specified in the RegisteredOrganization property. The label "Profile" must not be included in the RegisteredName property as the last part of the name of the profile.

RegisteredOrganization

Data type: uint16

Access type: Read-only

Qualifiers: Required, ModelCorrespondence ("CIM_RegisteredProfile.OtherRegisteredOrganization")

Specifies the organization that owns the profile specification to which the implementation adheres.

Other (1)

DMTF (2)

CompTIA (3)

Consortium for Service Innovation (4)

FAST (5)

GGF (6)

INTAP (7)

itSMF (8)

NAC (9)

Northwest Energy Efficiency Alliance (10)

SNIA (11)

TM Forum (12)

The Open Group (13)

ANSI (14)

IEEE (15)

IETF (16)

INCITS (17)

ISO (18)

W3C (19)

OGF (20)

DMTF Reserved (21–65535)

RegisteredVersion

Data type: string

Access type: Read-only

Qualifiers: Required

Specifies the version of the profile that was identified in the RegisteredName property. The string that represents the version must be in the following format: "M + \".\" + N + \".\" + U".

Value Meaning
M

The major version, in numeric form, which describes the profile's creation or last modification.

N

The minor version, in numeric form, which describes the profile's creation or last modification.

U

The update information, in numeric form, which describes the profile's creation or last modification.

 

Remarks

Since multiple versions can exist for the same RegisteredName, the combination of RegisteredName, RegisteredOrganization, and RegisteredVersion must uniquely identify the registered profile within the scope of the organization.

This documentation is derived from the CIM class descriptions published by the DMTF. Microsoft may have made changes to correct minor errors, conform to Microsoft SDK documentation standards, or provide more information.

Requirements

Minimum supported client

Windows 7

Minimum supported server

Windows Server 2008 R2

Namespace

Root\interop

MOF

Interop.mof

See also

CIM_ManagedElement