UsageKeyword is an optional multi-valued String FIM property that is used by the BindingDescription, ObjectTypeDescription and AttributeTypeDescription resources to indicate what components of an application require the schema element. FIM uses values defined in the table in the following section. Independent Software Vendors (ISVs) can add their own UsageKeyword values to mark bindings that are mandatory to their applications.

In FIM, key bindings are protected by the system as well as by certain ManagementPolicyRule resources.

Reserved UsageKeyword Values

The following table lists the values for UsageKeyword are used by FIM out of the box and are reserved for use by FIM.

Value Description

Microsoft.ResourceManagement.WebServices

The associated schema is necessary for FIM web services to function. Users can modify only DisplayName and Description.

When the UsageKeyword value for an ObjectTypeDescription resource is equal to Microsoft.ResourceManagement.WebServices, then attributes on that resource must be optional (BindingDescription resources that include ObjectTypeDescription as the BoundObject type must have a Required value of false).

FIM prevents schema elements that have this value to be removed and their behavior cannot be changed.

Microsoft.ResourceManagement.PasswordReset

The associated schema is necessary for the FIM Password Reset client to function. Removing or changing the behavior of such schema elements will potentially cause password reset to stop functioning.

The ManagementPolicyRule that is displayed in the FIM Portal as Administration - Schema: Administrators can change selected bindings of schema related resources is used to allow users to modify the Display Name and Description of these bindings.

Microsoft.ResourceManagement.PortalClient

The associated schema is necessary for the FIM Portal Client to function. Removing or changing the behavior of such schema elements may cause the FIM Portal to stop functioning.

The ManagementPolicyRule that is displayed in the FIM Portal as Administration - Schema: Administrators can change selected bindings of schema related resources is used to allow users to modify the Display Name and Description of these bindings.

Microsoft.ResourceManagement.OfficeIntegration

The associated schema is necessary for the FIM Office client to function. Removing or changing the behavior of such schema elements may cause the Office client to stop functioning.

Modifying the Properties of Associated Resources

Some properties of BindingDescription AttributeTypeDescription ObjectTypeDescription resources that use the reserved UsageKeyword values in the preceding table can be modified by using out of box MPRs as shown in the following table:

Resource type Properties of Resource that Can be Modified DisplayName of MPR

AttributeTypeDescription

  • Description

  • DisplayName

  • IntegerMaximum

  • IntegerMinimum

  • StringRegex

Administration - Schema: Administrators can change selected attributes of schema related resources

BindingDescription

  • Description

  • DisplayName

Administration - Schema: Administrators can change selected bindings of schema related resources

ObjectTypeDescription

  • Description

  • DisplayName

Administration - Schema: Administrators can change selected attributes of schema related resources

Guidelines for Creating Custom Values

This section describes guidelines for creating custom UsageKeyword values.

  • User cannot create a UsageKeyword value that is equal to any of the values reserved by FIM (see Reserved UsageKeyword Values).

  • User cannot create a UsageKeyword value that uses the prefix "Microsoft.ResourceManagement.".

  • When UsageKeyword is equal to a reserved value, you can only modify properties of the resource as defined in the Modifying the Properties of Associated Resources table.

Remarks

The UsageKeyword property described in this document is distinct from the UsageKeyword and property of the SearchScopeConfiguration, NavigationBarConfiguration, and HomepageConfiguration resources.

See Also