You can create an override for a property or configuration parameter for a diagnostic. A property override changes the default value of a diagnostic property, and a configuration override changes the default value of a custom configuration setting for a diagnostic. If you want to create an override for a diagnostic, use the Microsoft.EnterpriseManagement.Configuration.ManagementPackDiagnosticPropertyOverride or Microsoft.EnterpriseManagement.Configuration.ManagementPackDiagnosticConfigurationOverride class. These classes are derived from the Microsoft.EnterpriseManagement.Configuration.ManagementPackDiagnosticOverride class.

Only the Enabled property can be overridden for diagnostics. To figure out which parameters can be overridden, you must look at the definition of the diagnostic in the Management Pack that defines the diagnostic. All the parameters that can be overridden are defined in the OverrideableParameters element of the diagnostic. 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 diagnostic.

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 diagnosticCriteria As MonitoringDiagnosticCriteria
			Dim diagnostic As MonitoringDiagnostic
			Dim diagnosticOverride As ManagementPackDiagnosticPropertyOverride

			mg = New ManagementGroup("localhost")

			mp = mg.GetManagementPacks("OverrideTestMP")(0)

			monitoringClass = mg.GetMonitoringClass(SystemMonitoringClass.WindowsComputer)

			diagnosticCriteria = New MonitoringDiagnosticCriteria( _
				"Name='Microsoft.SystemCenter.ManagedComputer.Ping.ICMPDiagnostic'")

			diagnostic = mg.GetMonitoringDiagnostics(diagnosticCriteria)(0)

			diagnosticOverride = New ManagementPackDiagnosticPropertyOverride(mp, _
				"SampleDiagnosticOverride")

			diagnosticOverride.Diagnostic = diagnostic
			diagnosticOverride.Property = ManagementPackWorkflowProperty.Enabled
			diagnosticOverride.Value = "false"
			diagnosticOverride.Context = monitoringClass
			diagnosticOverride.DisplayName = "SampleDiagnosticOverride"

			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;
			MonitoringClass							 monitoringClass;
			MonitoringDiagnosticCriteria				diagnosticCriteria;
			MonitoringDiagnostic						diagnostic;
			ManagementPackDiagnosticPropertyOverride	diagnosticOverride;

			mg = new ManagementGroup("localhost");

			mp = mg.GetManagementPacks("OverrideTestMP")[0];

			monitoringClass = mg.GetMonitoringClass(SystemMonitoringClass.WindowsComputer);

			diagnosticCriteria = new MonitoringDiagnosticCriteria("Name='Microsoft.SystemCenter.ManagedComputer.Ping.ICMPDiagnostic'");

			diagnostic = mg.GetMonitoringDiagnostics(diagnosticCriteria)[0];

			diagnosticOverride = new ManagementPackDiagnosticPropertyOverride(mp, "SampleDiagnosticOverride");

			diagnosticOverride.Diagnostic   = diagnostic;
			diagnosticOverride.Property	 = ManagementPackWorkflowProperty.Enabled;
			diagnosticOverride.Value		= "false";
			diagnosticOverride.Context	= monitoringClass;
			diagnosticOverride.DisplayName  = "SampleDiagnosticOverride";

			mp.Verify();
		
			//Save the changes into the management pack.
			mp.AcceptChanges();
	}	
}
}

Send comments about this topic to Microsoft.