An SDK client can connect to the SDK Service by using a given set of user credentials.

Note
The account that is used for authentication must be included in an Operations Manager user-role profile. For more information, see How to Connect an Operations Manager SDK Client to the SDK Service.

Example

The following example demonstrates how to connect to the SDK Service by using a provided user name, domain, and password. The example also shows how to handle some common connection failures.

Visual Basic  Copy Code
' Prompts for a username, domain, and password, and connects to the 
' SDK Service by using the supplied credentials.
Imports System
Imports System.Collections.Generic
Imports Microsoft.EnterpriseManagement
Imports Microsoft.EnterpriseManagement.Common
Imports Microsoft.VisualBasic
Imports System.Security
Imports System.ServiceProcess
Imports System.Text


Namespace SDKSamples
	Class Program

		Public Overloads Shared Function Main(ByVal args() As String) As Integer
			' Define the server that you want to connect to.
			Dim serverName As String = "serverName"

			Console.WriteLine("Please specify the credentials to use when connecting to the SDK Service.")
			' Get name.
			Console.Write("User name: ")
			Dim name As String = Console.ReadLine()

			' Get domain.
			Console.Write("Domain: ")
			Dim userDomain As String = Console.ReadLine()

			' Get password.
			Dim password As New SecureString()
			Console.Write("Password: ")
			While True
				' Display asterisks for entered characters.
				Dim cki As ConsoleKeyInfo = Console.ReadKey(True)

				' If password is complete, connect with supplied credentials.
				If cki.Key = ConsoleKey.Enter Then
					Console.Write(Environment.NewLine)
					Exit While
				Else
					If cki.Key = ConsoleKey.Backspace Then
						' Remove the last asterisk from the console.
						If password.Length > 0 Then
							Console.SetCursorPosition(Console.CursorLeft - 1, Console.CursorTop)
							Console.Write(" ")
							Console.SetCursorPosition(Console.CursorLeft - 1, Console.CursorTop)
							password.RemoveAt((password.Length - 1))
						End If
					Else
						password.AppendChar(cki.KeyChar)
						Console.Write("*")
					End If
				End If
			End While

			Try
				Dim mgSettings As New ManagementGroupConnectionSettings(serverName)
				mgSettings.UserName = name
				mgSettings.Domain = userDomain
				mgSettings.Password = password

				Console.WriteLine("Connecting to the SDK Service as user: " & name)

				Dim mg As ManagementGroup = ManagementGroup.Connect(mgSettings)
				If mg.IsConnected Then
					Console.WriteLine("Connection succeeded.")
				Else
					Throw New InvalidOperationException("Not connected to an SDK Service.")
				End If
			Catch sde As ServerDisconnectedException
				Console.WriteLine(ControlChars.Lf.ToString() & "Connection failed. " & sde.Message)
				If Not (sde.InnerException Is Nothing) Then
					Console.WriteLine(sde.InnerException.Message)
				End If
				' Call custom method to prompt the user for credentials if needed.
			Catch snr As ServiceNotRunningException
				Console.WriteLine(snr.Message)

				' Make one attempt to start the service.
				Dim sc = New ServiceController("localhost", serverName)

				Console.WriteLine("Attempting to start the SDK Service on " & serverName & ".")
				sc.Start()

				' Wait 20 seconds for it to enter the Running state.
				sc.WaitForStatus(ServiceControllerStatus.Running, New TimeSpan(0, 0, 20))

				If sc.Status = ServiceControllerStatus.Running Then
					Dim mgSettings As New ManagementGroupConnectionSettings(serverName)
					mgSettings.UserName = name
					mgSettings.Domain = userDomain
					mgSettings.Password = password

					Dim mg As ManagementGroup = ManagementGroup.Connect(mgSettings)
					If mg.IsConnected Then
						Console.WriteLine("Connection succeeded.")
					Else
						Throw New InvalidOperationException("Not connected to an SDK Service.")
					End If
				Else
					Throw New InvalidOperationException("Unable to restart and connect to the SDK Service.")
				End If
			End Try
		End Function 'Main
	End Class 'Program
End Namespace 'SDKSamples
C#  Copy Code
/// <summary>
/// Prompts for a username, domain, and password, and connects to the 
/// SDK Service by using the supplied credentials.
/// </summary>
using System;
using System.Collections.Generic;
using Microsoft.EnterpriseManagement;
using Microsoft.EnterpriseManagement.Common;
using System.Security;
using System.ServiceProcess;
using System.Text;

namespace SDKSamples
{
	class Program
	{
		static void Main(string[] args)
		{
			// Define the server that you want to connect to.
			string serverName = "serverName";
		
			Console.WriteLine("Please specify the credentials to use when connecting to the SDK Service.");
			// Get name.
			Console.Write("User name: ");
			string name = Console.ReadLine();

			// Get domain.
			Console.Write("Domain: ");
			string userDomain = Console.ReadLine();

			// Get password.
			SecureString password = new SecureString();
			Console.Write("Password: ");
			while (true)
			{
				// Display asterisks for entered characters.
				ConsoleKeyInfo cki = Console.ReadKey(true);

				// If password is complete, connect with supplied credentials.
				if (cki.Key == ConsoleKey.Enter)
				{
					Console.Write(Environment.NewLine);
					break;
			}
				else if (cki.Key == ConsoleKey.Backspace)
				{
					// Remove the last asterisk from the console.
					if (password.Length > 0)
					{
						Console.SetCursorPosition(Console.CursorLeft - 1, Console.CursorTop);
						Console.Write(" ");
						Console.SetCursorPosition(Console.CursorLeft - 1, Console.CursorTop);
						password.RemoveAt(password.Length - 1);
				}
			}
				else
				{
					password.AppendChar(cki.KeyChar);
					Console.Write("*");
			}
		}


			try
			{
				ManagementGroupConnectionSettings mgSettings =
					new ManagementGroupConnectionSettings(serverName);
				mgSettings.UserName = name;
				mgSettings.Domain = userDomain;
				mgSettings.Password = password;

				Console.WriteLine("Connecting to the SDK Service as user: " + name);

				ManagementGroup mg = ManagementGroup.Connect(mgSettings);
				if (mg.IsConnected)
					Console.WriteLine("Connection succeeded.");
				else
					throw new InvalidOperationException("Not connected to an SDK Service.");
		}
			catch (ServerDisconnectedException sde)
			{
				Console.WriteLine("\nConnection failed. " + sde.Message);
				if (sde.InnerException != null)
					Console.WriteLine(sde.InnerException.Message);
			
				// Call custom method to prompt the user for credentials if needed.
			
		}
			catch (ServiceNotRunningException snr)
			{
				Console.WriteLine(snr.Message);

				// Make one attempt to start the service.
				System.ServiceProcess.ServiceController sc = new 
					ServiceController("localhost", serverName);

				Console.WriteLine("Attempting to start the SDK Service on " + serverName + ".");
				sc.Start();

				// Wait 20 seconds for it to enter the Running state.
				sc.WaitForStatus(ServiceControllerStatus.Running, new TimeSpan(0, 0, 20));

				if (sc.Status == ServiceControllerStatus.Running)
				{
					ManagementGroupConnectionSettings mgSettings =
					new ManagementGroupConnectionSettings(serverName);
					mgSettings.UserName = name;
					mgSettings.Domain = userDomain;
					mgSettings.Password = password;

					ManagementGroup mg = ManagementGroup.Connect(mgSettings);
					if (mg.IsConnected)
						Console.WriteLine("Connection succeeded.");
					else
						throw new InvalidOperationException("Not connected to an SDK Service.");
			}
				else
				{
					throw new InvalidOperationException("Unable to restart and connect to the SDK Service.");
			}
		}
	}
}
}

The code example requires a reference to the system.serviceprocess.dll file. This assembly is included in the .NET Framework.

Instead of explicitly calling the Connect method, you can instantiate a new Microsoft.EnterpriseManagement.ManagementGroup object by using the new keyword, as shown in the following example.

C#  Copy Code
mg = new ManagementGroup(mgSettings);

is the same as:

C#  Copy Code
mg = ManagementGroup.Connect(mgSettings);

See Also


Send comments about this topic to Microsoft.