ManagementGroupConnectionSettings Class

Article
12/03/2015

Applies To: Operations Manager for System Center 2012

Defines connections settings that should be used when connecting to the SDK service. This class can be used to control the caching modes used by the SDK client as well as to pass alternate credentials.

Namespace: Microsoft.EnterpriseManagement
Assembly: Microsoft.EnterpriseManagement.OperationsManager (in Microsoft.EnterpriseManagement.OperationsManager.dll)

Inheritance Hierarchy

System.Object
Microsoft.EnterpriseManagement.Common.ConnectionSettings
Microsoft.EnterpriseManagement.EnterpriseManagementConnectionSettings
Microsoft.EnterpriseManagement.ManagementGroupConnectionSettings

Syntax

public class ManagementGroupConnectionSettings : EnterpriseManagementConnectionSettings

public ref class ManagementGroupConnectionSettings : EnterpriseManagementConnectionSettings

type ManagementGroupConnectionSettings = 
    class
        inherit EnterpriseManagementConnectionSettings
    end

Public Class ManagementGroupConnectionSettings
    Inherits EnterpriseManagementConnectionSettings

Constructors

	Name	Description
	ManagementGroupConnectionSettings(String)	Initializes a new ManagementGroupConnectionSettings object with the name of the server to connect to.

Properties

	Name	Description
	CacheMode	Gets or sets the cache mode for the client-side interface. The default is CacheMode.Configuration.(Inherited from ConnectionSettings.)
	Domain	Gets or sets the domain used for the connection settings.(Inherited from ConnectionSettings.)
	Password	Gets or sets the password used for the connection settings.(Inherited from ConnectionSettings.)
	ServerName	(Inherited from EnterpriseManagementConnectionSettings.)
	ThreeLetterWindowsLanguageName	Gets or sets the three-letter Windows language name used in the connection settings. The default value is CurrentCulture.ThreeLetterWindowsLanguageName.(Inherited from ConnectionSettings.)
	TieredManagementGroupConnectionSettings	(Inherited from EnterpriseManagementConnectionSettings.)
	UserName	Gets or sets the user name used in the connection settings.(Inherited from ConnectionSettings.)

Methods

	Name	Description
	Equals(Object)	(Inherited from Object.)
	Finalize()	(Inherited from Object.)
	GetHashCode()	(Inherited from Object.)
	GetType()	(Inherited from Object.)
	MemberwiseClone()	(Inherited from Object.)
	ToString()	(Inherited from Object.)

Remarks

The ManagementGroupConnectionSettings class includes cache modes for the client-side interface using one of the values of the CacheMode enumeration.

Use the Configuration cache mode to cache configuration data such as Management Packs, classes, and module types. The Configuration cache mode is best used for doing lots of operations in the configuration space, such as moving up and down the various type hierarchies. It is also useful when working extensively with MonitoringObject (but not PartialMonitoringObject) and need to access the property values of many instances of different class types. The user interface runs in this mode by default.

Use the ManagementPacks cache mode to cache only Management Packs. The ManagementPacks cache mode is best used when configuration-related operations are used, but not used extensively. The ManagementPacks cache mode is also the best mode in which to create Management Packs, because that requires extensive iterations for getting management packs, but not necessarily other objects.

Note

Every object in a management pack (such as a rule, class, task, and so on) requires a ManagementPack that is not returned in the initial call. If you call GetMonitoringRules, every rule that comes back makes another call to the server to get its ManagementPack object if the cache mode is None. If you are doing this, run in the ManagementPacks cache mode.

Set the cache mode to None to cache nothing. The None cache mode is best used for operational data-related operations. If you are mostly working with alerts or performance data, or even simply submitting a single task, use the None cache mode.

Examples

For an example, see How to Connect to an SDK Service by Using Specified User Credentials

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Share via