Starts an asynchronous operation to install and configure agents on a specified collection of Windows-based computers, receiving notification when the status of any installation changes and providing the specified failover servers. Namespace: Microsoft.EnterpriseManagement.Administration
Assembly: Microsoft.EnterpriseManagement.OperationsManager (in microsoft.enterprisemanagement.operationsmanager.dll)

Usage

Visual Basic
Dim instance As ManagementServer
Dim customMonitoringObjects As IList(Of CustomMonitoringObject)
Dim failoverServers As IList(Of ManagementServer)
Dim installAgentConfiguration As InstallAgentConfiguration
Dim callback As MonitoringTaskStatusChangeCallback
Dim returnValue As AgentTaskInformation

returnValue = instance.SubmitInstallAgents(customMonitoringObjects, failoverServers, installAgentConfiguration, callback)

Syntax

Visual Basic
Public Function SubmitInstallAgents ( _
		customMonitoringObjects As IList(Of CustomMonitoringObject), _
		failoverServers As IList(Of ManagementServer), _
		installAgentConfiguration As InstallAgentConfiguration, _
		callback As MonitoringTaskStatusChangeCallback _
) As AgentTaskInformation
C#
public AgentTaskInformation SubmitInstallAgents (
		IList<CustomMonitoringObject> customMonitoringObjects,
		IList<ManagementServer> failoverServers,
		InstallAgentConfiguration installAgentConfiguration,
		MonitoringTaskStatusChangeCallback callback
)
C++
public:
AgentTaskInformation^ SubmitInstallAgents (
		IList<CustomMonitoringObject^>^ customMonitoringObjects, 
		IList<ManagementServer^>^ failoverServers, 
		InstallAgentConfiguration^ installAgentConfiguration, 
		MonitoringTaskStatusChangeCallback^ callback
)
J#
public AgentTaskInformation SubmitInstallAgents (
		IList<CustomMonitoringObject> customMonitoringObjects, 
		IList<ManagementServer> failoverServers, 
		InstallAgentConfiguration installAgentConfiguration, 
		MonitoringTaskStatusChangeCallback callback
)
JScript
public function SubmitInstallAgents (
		customMonitoringObjects : IList<CustomMonitoringObject>, 
		failoverServers : IList<ManagementServer>, 
		installAgentConfiguration : InstallAgentConfiguration, 
		callback : MonitoringTaskStatusChangeCallback
) : AgentTaskInformation

Parameters

customMonitoringObjects

The Windows-based computers on which to install agents.

failoverServers

The collection of servers that can manage the agent if communication is lost with the agent's primary Management Server.

installAgentConfiguration

Information used to configure the installations.

callback

A MonitoringTaskStatusChangeCallback delegate that references a user-defined method to call when the status of any installation task in this batch changes.

Return Value

An AgentTaskInformation instance that allows you to access the installation task IDs and their associated agent names.

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.

Platforms

Development Platforms

Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP

Target Platforms

Windows Server 2008,Windows Server 2003,Windows Vista,Windows XP

See Also