You can use the Operations Manager Connector Framework (OMCF) Web service to create a connector that allows Operations Manager to communicate with an external system.

Note
If the external system runs on a Windows-based computer, using the class libraries is the preferred method for creating the connector. For more information, see How to Create or Remove a Connector by Using the Operations Manager Class Libraries.

Example

The following example demonstrates how to create and remove a connector using the OMCF Web service. Before creating a connector, you can create an OMCF Web service proxy. For more information, see How to Create an OMCF Web Service Proxy.

Visual Basic  Copy Code
' Creates and removes a new connector by using the OMCF Web service.
Imports System
Imports System.Collections.ObjectModel
Imports Microsoft.EnterpriseManagement
Imports Microsoft.EnterpriseManagement.ConnectorFramework
Imports System.IO
Imports System.Text
Imports System.Xml

Namespace SDKSamples
	Class Program
		Public Overloads Shared Function Main(ByVal args() As String) As Integer

			Dim mg As ManagementGroup = New ManagementGroup("localhost")

			Dim connectorId As Guid = Guid.NewGuid()

			' Create a new connector.
			Dim myConnectorInfo As ConnectorInfo = New ConnectorInfo()
			myConnectorInfo.Name = "myConnector"
			myConnectorInfo.DisplayName = "My Connector"
			myConnectorInfo.Description = "This connector was created using the OMCF Web service."

			' Define the Web service URI endpoint address for the Web service
			' that is used to create the connector.
			Dim uriEndpointAddress As String = "EnterURIEndpointAddressHere"
			Dim OMCFProxy As ConnectorFrameworkProxy = _
				New ConnectorFrameworkProxy(uriEndpointAddress)

			OMCFProxy.SetupWithConnectorId(myConnectorInfo, connectorId)
			OMCFProxy.Initialize(connectorId)

			Console.WriteLine("Created " & myConnectorInfo.Name & _
				" with ID: " & connectorId.ToString())

			' Remove the connector.
			Console.WriteLine("Removing connector with Id: " & connectorId.ToString())
			OMCFProxy.Uninitialize(connectorId)
			OMCFProxy.Cleanup(connectorId)
			Console.WriteLine("Connector removed.")

		End Function
	End Class
End Namespace
C#  Copy Code
/// <summary>
/// Creates and removes a new connector by using the OMCF Web service.
/// </summary>
using System;
using System.Collections.ObjectModel;
using Microsoft.EnterpriseManagement;
using Microsoft.EnterpriseManagement.ConnectorFramework;
using System.IO;
using System.Text;
using System.Xml;

namespace SDKSamples
{
	class Program
	{
		static void Main(string[] args)
		{
			ManagementGroup mg = new ManagementGroup("localhost");

			Guid connectorId = Guid.NewGuid();

			// Create a new connector.
			ConnectorInfo myConnectorInfo = new ConnectorInfo();
			myConnectorInfo.Name = "myConnector";
			myConnectorInfo.DisplayName = "My Connector";
			myConnectorInfo.Description = "This connector was created using the OMCF Web service.";

			// Define the Web service URI endpoint address for the Web service
			// that is used to create the connector.
			string uriEndpointAddress = "EnterURIEndpointAddressHere";
			ConnectorFrameworkProxy OMCFProxy =
				new ConnectorFrameworkProxy(uriEndpointAddress);

			OMCFProxy.SetupWithConnectorId(myConnectorInfo, connectorId);
			OMCFProxy.Initialize(connectorId);

			Console.WriteLine("Created " + myConnectorInfo.Name +
				" with ID: " + connectorId.ToString());


			// Remove the connector.
			Console.WriteLine("Removing connector with Id: " + connectorId);
			OMCFProxy.Uninitialize(connectorId);
			OMCFProxy.Cleanup(connectorId);
			Console.WriteLine("Connector removed.");

	}
}
}

See Also


Send comments about this topic to Microsoft.