Property (ClassType)

Article
10/04/2013

Applies To: System Center 2012 - Operations Manager, System Center 2012 R2 Operations Manager, System Center 2012 SP1 - Operations Manager

Represents a property of a class type defined in a management pack.

Schema Hierarchy

ManagementPack
  TypeDefinitions
    EntityTypes
      ClassTypes
        ClassType
          Property

Syntax

<Property ID=”PropertyName” Comment=”Comments” Type=”datatype” Key=”True/False” CaseSensitive=”True/False” Length=”256” MinLength=”0”>
</Property>

Attributes and Elements

The following sections describe attributes, child elements, and the parent element of the Property element.

Attributes

Attribute	Description
ID	Required attribute. Represents the identity of the property. To learn how to identify your element in a management pack, see Element Identity and Namespace Conventions.
Comment	Optional attribute. Represents commentary by the management pack author.
Type	Required attribute. Represents the data type of the property.
Key	Optional attribute. Defines whether or not this property is the key property of the class type. If not specified, the value defaults to False.
CaseSensitive	Optional attribute. Pertains only to properties of type string. Defines whether or not this property’s value is case sensitive. If not specified, the value defaults to False.
Length	Optional attribute. Pertains only to properties of type string. Defines the length of the string value. Value must be between 1 and 65,536 inclusively.
MinLength	Optional attribute. Pertains only to properties of type string. Defines the minimum length of the string value. Value must be between 0 and 65,536 inclusively.

Type Attribute Values

Value	Description
int	Indicates the property is of integer type.
decimal	Indicates the property is of decimal type.
double	Indicates the property is of double type.
string	Indicates the property is of string type.
datetime	Indicates the property is of datetime type.
guid	Indicates the property is of GUID type.
bool	Indicates the property is of Boolean type.

Key Attribute Values

Value	Description
True	Indicates that the property is a key property and used to uniquely identify an instance of this class type. For more information on key properties, see the Remarks section.
False	The default value. Indicates that the property is not the key property of the class type.

Child Elements

None.

Parent Elements

Element	Description
ClassType	Represents a class type definition in the management pack.

Remarks

Typically, a Property element of a ClassType element will be populated during discovery. It can be used for inventory purposes or for monitoring configuration.

Key Properties

Key properties are used to uniquely identify an instance of a class type within a hosting class or, if not hosted, within the management group. If a class type is hosted and more than one instance of the class type is expected, a Key attribute on one of its properties must be set to true. If only one instance of the hosted class type is expected, defining a key property is recommended but not mandatory. If a class type is not hosted and its base class type does not define a key property, the Key attribute on one of its properties must be set to True to ensure instance uniqueness within the management group.

Note

A display string for each class type and each property defined within a class type should be defined in the display string section of the management pack for at least one language. For more information, see DisplayStrings.

For an example of how the Property element is expressed in a management pack, see ClassType.