3.33 NumberOfUsers

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

3.33.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 users in that OU and any child OUs. The total number of users for an OU consists of all users 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. But in reality, the script runs only on the domain and not on the child OUs.

3.33.2 Default Schedule

The default interval for this script is Every 24 hours.

3.33.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 of an event in which the NumberOfUsers job fails. The default is 35.

Monitor number of users

Include contacts?

Select Yes to include contact objects in your count of the Number of Users. By default this script refers to security users only.

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 when number of users exceeds threshold?

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

Threshold -- Maximum number of users

Specify the maximum number of users that can be in the domain or organizational unit before an event is raised. The default is -1 user.

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

Event severity when number of users exceeds threshold

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

Data Collection

Collect data for number of users?

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

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

Specify the number of users you want returned when collecting data. For example, if you set this parameter to 1000 and the domain or OU contains 10,000 users, only the first 1000 users are returned. Enter 0 to return all users. The default is 1000 users.