1E NightWatchman Agent installer properties

PropertyDefault valueNotes

CERTISSUER

 Text used to search for a client certificate in the client certificate store. Use either CERTISSUER or CERTSUBJECT only when using HTTPS for communications and the NightWatchman Management Center Web service is configured to require a client certificate.
CERTSUBJECT
 Text used to search for a client certificate in the client certificate store. Use either CERTISSUER or CERTSUBJECT only when using HTTPS for communications and the NightWatchman Management Center Web Service is configured to require a client certificate.
DEBUG
13The debug level (decimal value) for the NightWatchman. Range is between 0 and 255.
HARDWAREUTILIZATION
OFFControls the gathering of Computer Reclaim (formerly named Hardware Utilization) data used in the  Computer Reclaim  reports.
  • OFF - disables the gathering of user computer interaction data.
  • ON - enables the gathering of user computer interaction data.
INSTALLDIR
%PROGRAMFILES%\1E\
Agent\
Optional parameter that determines the agent installation directory. It is the same directory for both 32-bit and 64-bit machines, when the correct version of the agent is used.
LOGPATH
%ALLUSERSPROFILE%\1E\
Agent\
Path is created if it does not exist.
MAXLOGFILESIZE
1048576Integer (in bytes) for of 1E Agent log file. When this size is reached, the file is renamed with a .LO _extension and a new .LOG file is created. The .LO _file is overwritten each time.
REPORTING
ONThe reporting states. Values are:
REPORTINGSERVER
 

When using HTTP for communications, set this parameter to the FQDN (recommended) or NetBIOS name of the server hosting the NightWatchman Management Center Web service.

If you are not using port 80, specify the port number as part of the server name:
REPORTINGSERVER="ACMESERVER.ACME.COM:8080"
SECUREREPORTINGSERVER
 

When using HTTPS for communications, set this parameter to the FQDN (recommended) or NetBIOS name of the server where the NightWatchman Management Center Web Service component secure site has been installed.

If you are not using port 443, specify the port number as part of the server name:
SECUREREPORTINGSERVER="ACMESERVER.ACME.COM:7433"
USEFIPS
0
Use FIPS for encrypting communications for NightWatchman.
  • 0 – do not use FIPS encrypted communications
  • 1 – use FIPS encrypted communications
When configuring this option, ensure that the same setting is made for all NightWatchman Management Center, WakeUp Server and 1E Agent components. If USEFIPS is enabled it will override ENCRYPTIONLEVEL and NightWatchman will use FIPS, requiring all NightWatchman and WakeUp server components and Agents to use FIPS.
POWEROPTIMIZATION
ONControls the gathering of Power/Battery data used in the Power Optimization reports.
  • NO/OFF/0 – no information is sent to reporting server.
  • Any other value – enables the gathering of user computer Power/Battery data.

See also Understanding Power Optimization.

REBOOTOPTIMIZATION
ONControls the gathering of user reboot data used in the Reboot Summary report.
  • NO/OFF/0 – no information is sent to reporting server.
  • Any other value – enables the gathering of user computer reboot data.

1E Agent component installer properties

The legacy 1E Agent installer for version 7.2.0 and earlier, contains various properties that can be set on the MSIEXEC command-line. The complete set is provided in the following table.

PropertyDefault valueNotes
ACMONDAYTIME 

Start of a Monday alarm clock, in the format hour:minutes, for a 24 hour day. For example, to set Monday's alarm clock for 08:00:

ACMONDAYTIME=08:00
ACFRIDAYTIME 

Start of a Friday alarm clock, in the format hour:minutes, for a 24 hour day. For example, to set Friday's alarm clock for 08:00:

ACFRIDAYTIME=08:00
ACSATURDAYTIME 

Start of a Saturday alarm clock, in the format hour:minutes, for a 24 hour day. For example, to set Saturday's alarm clock for 08:00:

ACSATURDAYTIME=08:00
ACSUNDAYTIME 

Start of a Sunday alarm clock in the format hour:minutes for a 24 hour day. For example, to set Sunday's alarm clock for 08:00:

ACSUNDAYTIME=08:00
ACTHURSDAYTIME 

Start of a Thursday alarm clock in the format hour:minutes for a 24 hour day. For example, to set Thursday's alarm clock for 08:00:

ACTHURSDAYTIME=08:00
ACTUESDAYTIME 

Start of a Tuesday alarm clock in the format hour:minutes for a 24 hour day. For example, to set Tuesday's alarm clock for 08:00:

ACTUESDAYTIME=08:00
ACTURNONMONITORONDetermines if the monitor is turned on during alarm clocks. Values are:
  • ON – turns monitors on during an alarm clock
  • OFF – leaves the monitor in its original state.
ACWEDNESDAYTIME 

Start of a Wednesday alarm clock in the format hour:minutes for a 24 hour day. For example, to set Wednesday's alarm clock for 08:00:

ACWEDNESDAYTIME=08:00
ADVANCEDSLEEPLESSDETECTIONONDetermines the state of advanced sleepless detection feature. Values are:
  • ON – install with advanced sleepless detection on.
  • OFF – install with advanced sleepless detection off.
BUSYPROCESSDETECTIONON

Toggles busy process detection on or off.

BUSYPROCESSDETECTION is not applicable to Windows 7 and later.
  • ON– detects processes that affect the idleness of the system and resets the idle timer. If these are included in the sleepless exclusion list, they are prevented from stopping the computer going to sleep after a period of inactivity.
  • OFF – ensures that busy processes on Windows XP and Windows Vista do not prevent a computer from sleeping, thereby reproducing the standard Windows 7 behavior.

While collecting power data for a baseline power behaviour, this setting should be ON with the STANDBYEXCLUSIONLIST empty.

COUNTDOWNSECS30Integer value (in seconds) to display the countdown time dialog box before the shutdown or log-off action is executed.
  • Must be between 0 and 3600 inclusive.
DISKAC60Integer value (in minutes) before the hard disks goes into stand-by mode when the computer is running on mains power.
  • Zero turns power management off.
  • Must be between 0 and 1440 inclusive.
DISKDC

5

Integer value (in minutes) before the hard drive goes into stand-by mode when the computer is running on battery power.
  • Zero turns power management off.
  • Must be between 0 and 1440 inclusive
FRIDAYCLOSEACTION0The action to run when closing the maintenance window.
  • 0 – leaves the computer in its current state, i.e. do nothing.
  • 1 – sets the close action to standby.
  • 2 – sets the close action to hibernate.
  • 3 – sets the close action to power off.


For example, to set the close action for Friday's maintenance window putting a device on standby:

FRIDAYCLOSEACTION=1
FRIDAYOPENTIME 

Time for the start of a Friday maintenance window in the format hour:minutes for a 24 hour day. For example, to set Friday's open time for 02:00

FRIDAYOPENTIME=02:00
FRIDAYPERIODMINS 

The duration (in minutes) for the maintenance window on a Friday. For example, to set Friday's maintenance window to be 1 hour:

FRIDAYPERIODMINS=60
HIBERNATEAC0Integer value (in minutes) before the computer goes into hibernate mode when it is running on mains power.
  • Zero turns power management off.
  • Must be between 0 and 1440 inclusive.
HIBERNATEDC0Integer value (in minutes) before a computer goes into hibernate mode when running on battery power.
  • Zero turns power management off.
  • Must be between 0 and 1440 inclusive.
HTTP 
HTTP is now deprecated.

See CERTISSUER, CERTSUBJECT, REPORTINGSERVER and SECUREREPORTINGSERVER for the new methods of setting communications with the NightWatchman Management Center Web service.

IGNOREERRORSOFFThe behavior for NightWatchman when errors are encountered during shutdown.
  • OFF – cancels shutdown when a shutdown script error is encountered.
  • ON – ignores errors from the shutdown scripts. The shutdown continues. The user has the option to cancel shutdown.
INSTALLSCRIPTS1Determines if shutdown scripts are installed.
  • 0 – will not install the shutdown scripts.
  • 1 – installs the shutdown scripts.
INSTALLSLEEPLESS1Determines if the sleepless detection driver is installed.
  • 0 – will not install the driver.
  • 1 – installs the driver.
KEEPAWAKEAFTERWAKEUPMINS60Time a computer is kept awake following an alarm clock wake up.
  • Must be between 5 and 1440 inclusive
If you attempt to set a value lower than 5, it will default to 60.
LOGOFFACTIONActiveDetermines the behavior when a user is logged onto the system. In all instances, scripts will be executed to close down applications gracefully.
  • PASSIVE – NightWatchman performs the operation specified by SHUTDOWNACTION , providing no-one is currently logged on.
  • ACTIVE – NightWatchman performs the operation specified by SHUTDOWNACTION . The user can postpone the operation. If the user is not present and the countdown timer dialog expires, the operation go ahead. The operation is stopped if scripts generate an error.
  • FORCE – NightWatchman performs the operation specified by SHUTDOWNACTION . The operation is enforced. The countdown timer dialog has no cancel option. Errors generated by the shutdown scripts are ignored and the operation takes place regardless. Unsaved data may be lost. This operation cannot be postponed or cancelled.
MONDAYCLOSEACTION0The action to run upon closing the maintenance window.
  • 0 – leaves the computer in its current state, i.e. do nothing.
  • 1 – sets the close action to standby.
  • 2 – sets the close action to hibernate.
  • 3 – sets the close action to power off.

For example, to set the close action for Monday putting a device on hibernate

MONDAYCLOSEACTION=2
MONDAYOPENTIME 

Time for the start of a Monday maintenance window in the format our:minutes for a 24 hour day. For example, to set the open time for Monday

MONDAYOPENTIME=02:00
MONDAYPERIODMINS 

Duration (in minutes) for Monday maintenance windows. For example, to set the maintenance window to 1 hour on Monday:

MONDAYPERIODMINS=60
MONITORAC15Integer value (in minutes) before a display goes into standby-mode when he computer s running on mains power.
  • Zero turns power management off.
  • Must be between 0 and 1440 inclusive
MONITORDC3Integer value (in mminutes) before a display goes into standby when the computer is running on battery power.
  • Zero turns power management off.
  • Must be between 0 and 1440 inclusive.
MONITORJOBSON

Turns Configuration Manager job monitoring on or off.MONITORJOBS also controls the integration with WakeUp.

When monitorjobs=ON, NightWatchman performs auto-shutdown for machines awoken by a scheduled WakeUp signal.
  • ON
  • OFF
NWMLOGFILENAME

NightWatchman.log

Name for the NightWatchman log file.
NWMSPOOLDIR

%ALLUSERSPROFILE%\1E\
Reporting\
NightWatchman\

Location of the NightWatchman spooler directory, where NightWatchman Management Center Reporting messages are stored before being sent to the NightWatchman Management Center Web service.

NWMSPOOLDIR, set by the installer, modifies the settings for communicating with the NightWatchman Management Center Reporting and should not need to be modified under normal circumstances.
PENDINGJOBWINDOWMINS5

The value modifies the power down behavior according to pending ConfigMgr jobs. It takes an integer that defines the number of minutes in the look-ahead window. We recommend that the PENDINGJOBWINDOWMINS value is set to slightly larger than the ConfigMgr polling refresh interval on the client. When PENDINGJOBWINDOWMINS=0, but MONITORJOBS=ON, the look-ahead functionality is turned off but the check for running ConfigMgr jobs will still happen.

To turn off ConfigMgr job monitoring altogether, set MONITORJOBS=OFF.

This behavior is dependent on checking the list of pending Configduration Manager jobs. If the client is not installed on the local computer then power down will proceed as normal regardless of the setting of the property.

MONITORJOBS property must be set to ON (as it is by default) in order for this value to be used. The way that the shutdown behavior is modified is dependent on the type of shutdown, as shown below:

  • Shutdown now – if either of the following is true, NightWatchman will abort its power down attempt.
    • Pending jobs exist scheduled to start within the specified look-ahead window starting from the current time.
    • There are current running jobs.
  • Scheduled Shutdown – if either of the following is true, NightWatchman will abort its scheduled power down attempt, and will retry in the configured retry interval.
    • Pending jobs exist scheduled to start within the specified look-ahead window starting from the current time.
    • There are current running jobs.
PRERUNOFFDetermines if the PreRun script is run during power down actions. Values are:
  • ON – activates the PRERUN script
  • OFF – disables the PRERUN script
PIDKEY The NightWatchman license key. This value should be set to a valid license key obtained from Sales . If PIDKEY is not set, a 30-day evaluation license is generated.
POWERSCHEMEOFF

Controls the setting of a NightWatchman power scheme when the service starts and at user login

The logged in user requires permissions to be able to change their local power scheme.
  • AUTO – no longer supported as a separate option. If you setPOWERSCHEME=AUTO it will behave as if set to ON.
  • ON – the NightWatchman power scheme is applied when the service starts and when a user logs in.
  • OFF – the power scheme is not applied.
RETRYATTEMPTS3Integer value that sets the number of repeat times that a shutdown will be attempted if cancelled by the user.
  • Must be between 0 and 10 inclusive.
RETRYINTERVAL60Integer value (in minutes) before the service attempts a shutdown if the event was cancelled by the user or the event could not be carried out.
  • Must be between 1 and 60 inclusive.
RUNALWAYSOFF

The behavior for running the runalways script at a NightWatchman initiated log-off or shutdown. This script is run in the context of the logged on user.

The NightWatchman scripts, including RunAlways.vbs, are run in user context and only if a user is logged into the machine.
  • ON – run the RUNALWAYS.vbs script.
  1. If the script returns TRUE, continue with the shutdown or reboot.
  2. If the script returns FALSE, cancel the shutdown or reboot.
  • OFF – the script is not run.
RUNALWAYSFORSLEEP

OFF

Determines if the RunAlways script is run during a NightWatchman initiated hibernate or standby.
  • ON – the RunAlways script is run during a NightWatchman initiated hibernate or standby.
  • OFF – The RunAlways script is not run during a NightWatchman initiated hibernate or standby.
RUNONRESUMEOFF

Determines if the RunOnResumescript is run when the computer resumes from Hibernate or Sleep.

>On Windows the script is called RESUME.vbs on the Macintosh it is called resume.scpt
  • ON – the RunOnResume script is run, if it exists, when the computer resumes from Hibernate or Sleep.
  • OFF – the RunOnResume script is not run.
SATURDAYCLOSEACTION0The action to run when closing the maintenance window.
  • 0 – leave the computer in its current state, i.e. do nothing.
  • 1 – sets the close action to standby.
  • 2 – sets the close action to hibernate.
  • 3 – sets the close action to power off.

For example, t o set the close action for Saturday's maintenance window to power off.

SATURDAYCLOSEACTION=3
SATURDAYOPENTIME 

Time for the start of a Saturday maintenance window in the format hour:minutes for a 24 hour day. For example, to set Saturday's open time for 02:00:

SATURDAYOPENTIME=02:00
SATURDAYPERIODMINS 

The duration (in minutes) for the maintenance window on a Saturday. For example, t o set Saturday's maintenance window to be 1 hour:

SATURDAYPERIODMINS=60
SCRIPTTIMEOUTSECS30Integer value that determines the number of seconds NightWatchman waits before it decides that a script has timed out.
  • Must be between 1 and 120 inclusive.
If the value for scripttimeoutsecs is set too low you could be at risk of data loss as the scripts may not have time to finish and NightWatchman may shutdown without some open files having been saved.
SHUTDOWN_HOUR 
This property is deprecated. Use the NightWatchman Management Center console and set a power policy for the PC.
SHUTDOWN_MIN 
This property is deprecated. Use the NightWatchman Management Center console and set a power policy for the PC.
SHUTDOWNACTIONNormalThe shutdown type.
  • Hibernate – puts the machine into hibernate mode.
  • Standby – puts the machine into standby mode.
  • Logoff– performs the log-off action only. No shut down performed. The machine will be left at the log-on prompt. This action has no power management value but can be used to enforce security.
  • Normal – the system shuts down and power off.
  • Poweroff – the system shuts down and power off. This is a synonym for Normal.
  • Reboot – the system restarts. This action has no power management value other than to enforce good housekeeping practice; a daily reboot.
STANDBYAC60Integer value (in minutes) before the computer goes into standby when it is running on mains power.
  • Zero turns power management off.
  • Must be between 0 and 1440 inclusive
STANDBYDC5Integer value (insinuates) before a computer goes into standby when it is running on battery power.
  • Zero turns power management off.
  • Must be between 0 and 1440 inclusive.
STANDBYEXCLUSIONLIST 

The process exclusions list. It takes a comma separated list of values where each value is the name of a process as it appears in the Sleepless and Busy processes report. When a NightWatchman client computer is at the point where it should enter a sleep state, NightWatchman checks any named processes on the sleepless exclusion list.

If the only processes preventing sleep are in the sleepless exclusion list NightWatchman will force the computer to enter into a sleep state regardless.

If svchost.exe is inserted into the standby exclusion list, all windows services hosted by svchost.exe will be excluded from keeping the machine from going into sleep
SUNDAYCLOSEACTION0he action to run when closing the maintenance window.
  • 0 – leaves the computer in its current state, i.e. do nothing.
  • 1 – sets the close action to standby.
  • 2 – sets the close action to hibernate
  • 3 – sets the close action to power off

For example, to set the close action for Sunday's maintenance window to hibernate:

SUNDAYCLOSEACTION=2
SUNDAYOPENTIME 

The time for the start of a Sunday maintenance window in the format hour:minutes for a 24 hour day. For example, to set Sunday's open time for 02:00:

SUNDAYOPENTIME=02:00
SUNDAYPERIODMINS 

The duration (in minutes) for the maintenance window on a Sunday. For example, to set Sunday's maintenance window to 1 hour:

SUNDAYPERIODMINS=60
SYSTEMTRAYONControls the display of the system tray applet. Values are:
  • ON – enables the notification area icon with 'Keep Active' enabled.
  • ON1 – enables the notification area icon with 'Keep Active' disabled (greyed out).
  • OFF – disables the notification area icon, unless a backup document exists for the logged on user.
ON or ON1 is recommended.  However, while collecting power data for a baseline power behaviour, this setting should be OFF to avoid affecting the behavior of users by alerting them that the agent is installed.

System Tray is the old XP term for notification area. With XP it is possible for programs to control visibility of the icon. Starting with Vista, Microsoft changed the behavior of the notification area, so that programs can only enable or disable their icon, it is then up to each user to choose whether the icon and/or its notifications are visible, visibility cannot be forced.
THURSDAYCLOSEACTION0The action to run when closing the maintenance window.
  • 0 – leaves the computer in its current state, i.e. do nothing.
  • 1 – sets the close action to standby.
  • 2 – sets the close action to hibernate.
  • 3 – sets the close action to power off.

For example, to set the close action for Thursday's maintenance window to standby:

THURSDAYCLOSEACTION=1
THURSDAYOPENTIME 

The time for the start of a Thursday maintenance window in the format hour:minutes for a 24 hour day. For example, to set Thursday's open time to 02:00:

THURSDAYOPENTIME=02:00
THURSDAYPERIODMINS 

The duration (in minutes) for the maintenance window on a Thursday. For example, to set Thursday's maintenance window to 1 hour:

THURSDAYPERIODMINS=60
TUESDAYCLOSEACTION0The action to run when closing the maintenance window.
  • 0 – leaves the computer in its current state, i.e. do nothing.
  • 1 – sets the close action to standby.
  • 2 – sets the close action to hibernate.
  • 3 – sets the close action to power off.

For example, t o set the close action for Tuesday's maintenance window to leave the computer in its awakened state:

TUESDAYCLOSEACTION=0
TUESDAYOPENTIME 

The time for the start of a Tuesday maintenance window in the format hour:minutes for a 24 hour day. For example, t o set Tuesday's open time to 02:00:

TUESDAYOPENTIME=02:00
TUESDAYPERIODMINS 

The duration (in minutes) for the maintenance window on a Tuesday. For example, to set Tuesday's maintenance window to be 1 hour:

TUESDAYPERIODMINS=60
TURNONMONITORONDetermines if the monitor is turned on during alarm clock and maintenance windows.
  • ON – turns monitor on during an alarm clock and maintenance window.
  • OFF – turns monitor off during an alarm clock and maintenance window.
USERACTIVITYMAXIDLEMINS0The duration (in minutes) for the window that governs the recent user activity test. If the user has been active during the specified period prior to a NightWatchman scheduled shutdown the shutdown will be postponed.
  • Zero turns power management off.
  • Must be between 0 and 1440 inclusive.

The postponement time is governed by the RETRYINTERVAL .

USERACTIVITYMAXIDLEMINS does not affect shutdowns started from the system tray or those where the NightWatchman logoffaction=Force.
WEDNESDAYCLOSEACTION0The action to run when closing the maintenance window.
  • 0 – leaves the computer in its current state, i.e. do nothing.
  • 1 – sets the close action to standby.
  • 2 – sets the close action to hibernate.
  • 3 – sets the close action to power off.

For example, t o set the close action for a Wednesday maintenance window to power-off:

WEDNESDAYCLOSEACTION=3
WEDNESDAYOPENTIME 

Start of a Wednesday maintenance window in the format hour:minutes for a 24 hour day. For example, t o set Wednesday's open time for 02:00

WEDNESDAYOPENTIME=02:00
WEDNESDAYPERIODMINS 

The duration (in minutes) for the maintenance window on a Wednesday. For example, to set Wednesday's maintenance window to be 1 hour:

WEDNESDAYPERIODMINS=60