You can create an override for a property or configuration parameter for a rule. A property override changes the default value of a rule property, and a configuration override changes the default value of a custom configuration setting for a rule. If you want to create an override for a rule, use the Microsoft.EnterpriseManagement.Configuration.ManagementPackRulePropertyOverride or Microsoft.EnterpriseManagement.Configuration.ManagementPackRuleConfigurationOverride class. These classes are derived from the Microsoft.EnterpriseManagement.Configuration.ManagementPackRuleOverride class.
Only the Enabled property can be overridden for rules. To figure out which parameters can be overridden, you must look at the definition of the rule in the Management Pack that defines the rule. All the parameters that can be overridden are defined in the OverrideableParameters element of the rule. You can also call the GetOverrideableParameters method to get the list of parameters programmatically.
The following example creates an override for the Enabled property of a rule.
Visual Basic | Copy Code |
---|---|
Imports System Imports System.Collections.Generic Imports System.Text Imports Microsoft.EnterpriseManagement Imports Microsoft.EnterpriseManagement.Administration Imports Microsoft.EnterpriseManagement.Common Imports Microsoft.EnterpriseManagement.Configuration Imports Microsoft.EnterpriseManagement.Monitoring Namespace SDKSamples Class Program Public Overloads Shared Function Main(ByVal args() As String) As Integer Dim mg As ManagementGroup Dim mp As ManagementPack Dim monitoringClass As MonitoringClass Dim classCriteria As MonitoringClassCriteria Dim ruleCriteria As MonitoringRuleCriteria Dim rule As MonitoringRule Dim ruleOverride As ManagementPackRulePropertyOverride mg = New ManagementGroup("localhost") mp = mg.GetManagementPacks("OverrideTestMP")(0) classCriteria = New MonitoringClassCriteria("Name='Microsoft.SQLServer.2005.Database'") monitoringClass = mg.GetMonitoringClasses(classCriteria)(0) ruleCriteria = New MonitoringRuleCriteria("DisplayName='Collect Database Free Space (%)'") rule = monitoringClass.GetMonitoringRules(ruleCriteria)(0) ruleOverride = New ManagementPackRulePropertyOverride(mp, "SampleRuleOverride") ruleOverride.Rule = rule ruleOverride.Property = ManagementPackWorkflowProperty.Enabled ruleOverride.Value = "false" ruleOverride.Context = monitoringClass ruleOverride.DisplayName = "SampleRuleOverride" mp.Verify() ' Save the changes into the management pack. mp.AcceptChanges() End Function End Class End Namespace |
C# | Copy Code |
---|---|
using System; using System.Collections.Generic; using System.Collections.ObjectModel; using System.Text; using Microsoft.EnterpriseManagement; using Microsoft.EnterpriseManagement.Administration; using Microsoft.EnterpriseManagement.Common; using Microsoft.EnterpriseManagement.Configuration; using Microsoft.EnterpriseManagement.Monitoring; namespace SDKSamples { class Program { //--------------------------------------------------------------------- static void Main(string[] args) { ManagementGroup mg; ManagementPack mp; MonitoringClassCriteria classCriteria; MonitoringClass monitoringClass; MonitoringRuleCriteria ruleCriteria; MonitoringRule rule; ManagementPackRulePropertyOverride ruleOverride; mg = new ManagementGroup("localhost"); mp = mg.GetManagementPacks("OverrideTestMP")[0]; classCriteria = new MonitoringClassCriteria("Name='Microsoft.SQLServer.2005.Database'"); monitoringClass = mg.GetMonitoringClasses(classCriteria)[0]; ruleCriteria = new MonitoringRuleCriteria("DisplayName='Collect Database Free Space (%)'"); rule = monitoringClass.GetMonitoringRules(ruleCriteria)[0]; ruleOverride = new ManagementPackRulePropertyOverride(mp, "SampleRuleOverride"); ruleOverride.Rule = rule; ruleOverride.Property = ManagementPackWorkflowProperty.Enabled; ruleOverride.Value = "false"; ruleOverride.Context = monitoringClass; ruleOverride.DisplayName = "SampleRuleOverride"; mp.Verify(); //Save the changes into the management pack. mp.AcceptChanges(); } } } |
Send comments about this topic to Microsoft.