IConnectorFramework.InitializeForTiers Method (Guid, ConnectorTieredOperationFailure[])

 

Applies To: Operations Manager for System Center 2012

Initializes the monitoring connector that is required to get alerts by calling GetMonitoringAlertsForTiers for all tiered Management Groups. The failures that occurred for the configured tiers are returned.

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

Syntax

[FaultContractAttribute(typeof(UnknownAuthorizationStoreException))]
[FaultContractAttribute(typeof(ServerDisconnectedException))]
[FaultContractAttribute(typeof(UnknownServiceException))]
[FaultContractAttribute(typeof(UnknownChannelException))]
[FaultContractAttribute(typeof(UnauthorizedAccessEnterpriseManagementException))]
[OperationContractAttribute]
[FaultContractAttribute(typeof(UnknownDatabaseException))]
[FaultContractAttribute(typeof(InvalidDatabaseDataException))]
[FaultContractAttribute(typeof(ServiceNotRunningException))]
[FaultContractAttribute(typeof(TimeoutException))]
void InitializeForTiers(
    Guid connectorId,
    out ConnectorTieredOperationFailure[] failures
)

[FaultContractAttribute((UnknownAuthorizationStoreException^::typeid))]
[FaultContractAttribute((ServerDisconnectedException^::typeid))]
[FaultContractAttribute((UnknownServiceException^::typeid))]
[FaultContractAttribute((UnknownChannelException^::typeid))]
[FaultContractAttribute((UnauthorizedAccessEnterpriseManagementException^::typeid))]
[OperationContractAttribute]
[FaultContractAttribute((UnknownDatabaseException^::typeid))]
[FaultContractAttribute((InvalidDatabaseDataException^::typeid))]
[FaultContractAttribute((ServiceNotRunningException^::typeid))]
[FaultContractAttribute((TimeoutException^::typeid))]
void InitializeForTiers(
    Guid connectorId,
    [OutAttribute] array<ConnectorTieredOperationFailure^>^% failures
)

[<FaultContractAttribute(typeof(UnknownAuthorizationStoreException))>]
[<FaultContractAttribute(typeof(ServerDisconnectedException))>]
[<FaultContractAttribute(typeof(UnknownServiceException))>]
[<FaultContractAttribute(typeof(UnknownChannelException))>]
[<FaultContractAttribute(typeof(UnauthorizedAccessEnterpriseManagementException))>]
[<OperationContractAttribute>]
[<FaultContractAttribute(typeof(UnknownDatabaseException))>]
[<FaultContractAttribute(typeof(InvalidDatabaseDataException))>]
[<FaultContractAttribute(typeof(ServiceNotRunningException))>]
[<FaultContractAttribute(typeof(TimeoutException))>]
abstract InitializeForTiers : 
        connectorId:Guid *
        failures:ConnectorTieredOperationFailure[] byref -> unit

<FaultContractAttribute(GetType(UnknownAuthorizationStoreException))>
<FaultContractAttribute(GetType(ServerDisconnectedException))>
<FaultContractAttribute(GetType(UnknownServiceException))>
<FaultContractAttribute(GetType(UnknownChannelException))>
<FaultContractAttribute(GetType(UnauthorizedAccessEnterpriseManagementException))>
<OperationContractAttribute>
<FaultContractAttribute(GetType(UnknownDatabaseException))>
<FaultContractAttribute(GetType(InvalidDatabaseDataException))>
<FaultContractAttribute(GetType(ServiceNotRunningException))>
<FaultContractAttribute(GetType(TimeoutException))>
Sub InitializeForTiers (
    connectorId As Guid,
    <OutAttribute> ByRef failures As ConnectorTieredOperationFailure()
)

Parameters

• connectorId
  Type: System.Guid

  The globally unique identifier (GUID) for the monitoring connector to initialize.

• failures
  Type: Microsoft.EnterpriseManagement.ConnectorFramework.ConnectorTieredOperationFailure[]

  The array of failures that may have occurred for various tiers.

Remarks

The MonitoringConnector must be set up and initialized before any alerts can be retrieved. This method initializes the monitoring connector for subsequent calls with the currently stored bookmark.

Attempting to Initialize a monitoring connector that is already initialized results in an exception with the "The connector is already in the given state." warning. It is advisable to perform a check of the P:Microsoft.EnterpriseManagement.ConnectorFramework.MonitoringConnector.Initialized property to determine if the monitoring connector is already initialized before attempting to Initialize the monitoring connector.

See Also

IConnectorFramework Interface
Microsoft.EnterpriseManagement.ConnectorFramework Namespace

Return to top