ComputerHealthService Class

Article
12/03/2015

Applies To: Operations Manager for System Center 2012

Represents an agent that captures information from the computer on which it is running, applies predefined rules to the captured data, and performs actions as defined by the rules.

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

Inheritance Hierarchy

System.Object
Microsoft.EnterpriseManagement.Common.MonitoringBase
Microsoft.EnterpriseManagement.Administration.ComputerHealthService
Microsoft.EnterpriseManagement.Administration.AgentManagedComputer
Microsoft.EnterpriseManagement.Administration.ManagementServer

Syntax

[SerializableAttribute]
public class ComputerHealthService : MonitoringBase

[SerializableAttribute]
public ref class ComputerHealthService : MonitoringBase

[<SerializableAttribute>]
type ComputerHealthService = 
    class
        inherit MonitoringBase
    end

<SerializableAttribute>
Public Class ComputerHealthService
    Inherits MonitoringBase

Properties

	Name	Description
	ActionAccountIdentity	Gets the name of the user account under which the health service is running.
	AuthenticationName	Gets the authentication name used to verify the identity of the health service.
	CommunicationPort	Gets the port number that the health service uses to communicate with its primary Management Server.
	ComputerName	Gets the NetBIOS name of the host computer on which the health service is running.
	CreateListener	Gets a value that indicates whether the health service creates a listening socket.
	DisplayName	Gets a descriptive name of the health service.
	Domain	Gets the name of the domain in which the health service is running.
	HealthState	Gets the current health state of the host computer on which the health service is running.
	HeartbeatInterval	Gets or sets a value that indicates the number of seconds between heartbeats generated by the health service.
	HostComputer	Gets a MonitoringObject that represents the Windows computer on which the health service is running.
	HostedHealthService	Gets a MonitoringObject that represents the health service.
	Id	Gets the health service's globally unique identifier (GUID).
	InstalledBy	Gets the name of the user who installed the health service.
	InstallTime	Gets the time at which the health service was installed.
	IPAddress	Gets the IP address of the host computer on which the health service is running.
	LastModified	Gets the date and time at which the health service was last modified (as stored in the operational database).
	ManagementGroup	The connection management group connection used by this object.
	ManagementGroupId	(Inherited from MonitoringBase.)
	ManuallyInstalled	Gets a value that indicates whether the health service was manually installed or automatically installed by a Management Server.
	MaximumQueueSizeBytes	Gets the maximum size of the health service's send queue, expressed in bytes.
	MaximumSizeOfAllTransferredFilesBytes	Gets the maximum size of all files transferred to or from the health service, expressed in bytes.
	Name	Gets the name of the health service.
	NetworkName	Gets the network name of the computer. The IP address or DNS name will be set to this property to use it for IP connectivity to the computer.
	PrincipalName	Gets the fully qualified domain name (FQDN) of the Root Management Server in the Management Group.
	ProxyingEnabled	Gets or sets a value that determines whether a proxy is enabled for this object.
	RequestCompression	Gets a value that indicates whether the health service requests compression for network communication.
	Version	Gets the version number of the health service.

Methods

	Name	Description
	ApplyChanges()	Updates the health service's property values in the Operations Manager database.
	Equals(Object)	(Inherited from Object.)
	Finalize()	(Inherited from Object.)
	GetFailoverManagementServers()	Gets the failover Management Servers for the health service.
	GetHashCode()	(Inherited from Object.)
	GetPrimaryManagementServer()	Gets the primary Management Server for the health Service.
	GetRemotelyManagedComputers()	Gets a collection of agentless managed computers monitored by the health service.
	GetRemotelyManagedDevices()	Gets a collection of network devices monitored by the health service.
	GetType()	(Inherited from Object.)
	InsertRemotelyManagedComputers(IList<CreatableEnterpriseManagementObject>)
	InsertRemotelyManagedComputers(IList<CustomMonitoringObject>)	Obsolete.Inserts remotely managed computers into the computer health service.
	InsertRemotelyManagedDevices(IList<CreatableEnterpriseManagementObject>)
	InsertRemotelyManagedDevices(IList<CustomMonitoringObject>)	Obsolete.Inserts remotely managed devices into the computer health service.
	MemberwiseClone()	(Inherited from Object.)
	Reconnect(EnterpriseManagementGroup)	Connects the health service to the specified Management Group.(Overrides MonitoringBase.Reconnect(EnterpriseManagementGroup).)
	ResetHeartbeatInterval()	Sets the health service's HeartbeatInterval property to its default value.
	ToString()	(Inherited from MonitoringBase.)

Remarks

A health service runs on each Management Server and on each agent-managed computer. A health service can collect information from its host computer, and it can act as a proxy agent that collects information from an agentless-managed computer or network device. A health service collects information using the configuration information provided in installed Management Packs.

You can access ComputerHealthService methods and properties for an agent-managed computer through the derived class AgentManagedComputer.

You can access ComputerHealthService methods and properties for a proxy agent that is managing a remotely managed computer or network device using GetProxyAgent or GetProxyAgent.

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.