3.27 NumberOfComputers

Use this Knowledge Script to monitor the number of computers in a domain or organizational unit. This script raises an event if the number of computers exceeds the threshold you set.

3.27.1 Resource Objects

Active Directory domain or organizational unit (OU).

To monitor OUs with this script, specify organizationalUnit in the Classes to include parameter of the Discovery_ActiveDS Knowledge Script.

When run on an OU, this script monitors all computers in that OU and any child OUs. The total number of computers for an OU consists of all computers in the OU and in any child OUs.

When you run this script on a domain, the domain and all child OUs will show a job is running. However, the job runs only on the domain and not on the child OUs.

3.27.2 Default Schedule

The default interval for this script is Every 24 hours.

3.27.3 Setting Parameter Values

Set the following parameters as needed:

Parameter

How to Set It

General Settings

Raise event if job fails

Event severity when job fails

Set the severity level, from 1 to 40, to indicate the importance an event in which the NumberOfComputers job fails. The default is 35.

Monitor number of computers

Enable job delegation?

Select Yes to enable the delegation of the job to another server where appropriate. If enabled, runs the job on the selected computer that holds the server role that you selected for the Delegate domain-wide monitoring to the... parameter. The default is unselected. For more information, see Section 3.1, AD Knowledge Script Job Delegation.

Delegate domain-wide monitoring to the

Select the server role to which the job should be delegated: Primary Domain Controller (PDC), Infrastructure Master, or RID Master. The default is PDC.

Raise event when DC assumes this role?

If you enabled job delegation, set to Yes to raise events if the DC assumes the server role you selected for the Delegate domain-wide monitoring to the... parameter. The event indicates that the monitored computer has assumed the selected role. The default is Yes.

Event severity when DC assumes this role

Set the severity level, from 1 to 40, to indicate the importance of an event in which the DC assumes the role you selected for the Delegate domain-wide monitoring to the... parameter. The default is 30.

Raise event when DC relinquishes this role?

If you enabled job delegation, set to Yes to raise events if the DC gives up the server role you selected for the Delegate domain-wide monitoring to the... parameter. The event indicates that the monitored computer has relinquished the selected role. The default is Yes.

Event severity when DC relinquishes this role

Set the severity level, from 1 to 40, to indicate the importance of an event in which the DC relinquishes the role you selected for the Delegate domain-wide monitoring to the... parameter. The default is 30.

Event Notification

Raise event if number of computers exceeds threshold?

Select Yes to raise an event if the number of computers in the domain or OU exceeds the threshold you set. The default is Yes.

Threshold -- Maximum number of computers

Specify the maximum number of computers that can be in the domain or OU before an event is raised. The default is -1 computer.

NOTE:You must change the default setting to run this script. Collect data to establish a baseline, then specify a threshold appropriate for your environment.

Event severity when number of computers exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of computers exceeds the threshold. The default is 5.

Data Collection

Collect data for number of computers?

Select Yes to collect data for charts and reports. If enabled, data collection returns the number of computers detected during the monitoring interval. The default is unselected.

Number of computers to return when collecting data (0 for all computers)

Specify the number of computers you want returned when collecting data. For example, if you set this parameter to 500 and the domain contains 2,000 computers, only the first 500 computers are returned in the event message. Select 0 to return all computers. The default is 500 computers.