ManagementGroupConnectionSettings Class

 

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
System_CAPS_pubmethod ManagementGroupConnectionSettings(String)

Initializes a new ManagementGroupConnectionSettings object with the name of the server to connect to.

Properties

Name Description
System_CAPS_pubproperty CacheMode

Gets or sets the cache mode for the client-side interface. The default is CacheMode.Configuration.(Inherited from ConnectionSettings.)

System_CAPS_pubproperty Domain

Gets or sets the domain used for the connection settings.(Inherited from ConnectionSettings.)

System_CAPS_pubproperty Password

Gets or sets the password used for the connection settings.(Inherited from ConnectionSettings.)

System_CAPS_pubproperty ServerName

(Inherited from EnterpriseManagementConnectionSettings.)

System_CAPS_pubproperty ThreeLetterWindowsLanguageName

Gets or sets the three-letter Windows language name used in the connection settings. The default value is CurrentCulture.ThreeLetterWindowsLanguageName.(Inherited from ConnectionSettings.)

System_CAPS_pubproperty TieredManagementGroupConnectionSettings

(Inherited from EnterpriseManagementConnectionSettings.)

System_CAPS_pubproperty UserName

Gets or sets the user name used in the connection settings.(Inherited from ConnectionSettings.)

Methods

Name Description
System_CAPS_pubmethod Equals(Object)

(Inherited from Object.)

System_CAPS_protmethod Finalize()

(Inherited from Object.)

System_CAPS_pubmethod GetHashCode()

(Inherited from Object.)

System_CAPS_pubmethod GetType()

(Inherited from Object.)

System_CAPS_protmethod MemberwiseClone()

(Inherited from Object.)

System_CAPS_pubmethod 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.

See Also

Microsoft.EnterpriseManagement Namespace

Return to top