Skip to main content

NightWatchman Enterprise 7.3

WakeUp WMI interface

WakeUp class

This class provides the main interface for controlling WakeUp.

WakeName
Purpose

Send a wake up message to a single machine.

Inputs
  • string sInArg – the NetBIOS name of the target machine to be awoken

Returns
  • string sOutArg – returns a brief status message indicating success or failure

  • uint32 ReturnValue – Exit code 1 success.

WakeColl
Purpose

Sends a wake up message to all resources contained in a Configuration Manager collection and its sub-collections.

Inputs
  • The name of the Configuration Manager collection containing the machines to be awoke

Returns
  • Returns a brief status message indicating success or failure

MachinePolicyRefresh
Purpose

Sends a Machine policy refresh message to a single machine.

Inputs
  • The NetBIOS name of the target machine to receive the policy refresh

Returns
  • Returns a brief status message indicating success or failure

collectionPolicyRefresh
Purpose

Sends a Machine policy refresh to all resources contained in a Configuration Manager collection and its sub-collections.

Inputs
  • The name of the Configuration Manager collection containing the machines to receive the policy refresh

Returns
  • Returns a brief status message indicating success or failure

WakeAll
Purpose

Sends a wake up message to all resources contained in the Configuration Manager collection “All Systems”

Inputs
  • none

Returns
  • Returns a brief status message indicating success or failure

Deprecated

The following methods are deprecated and are no long supported.

  • MachineClientHealth

  • collectionClientHealth

  • MachineFixClientHealth

  • collectionFixClientHealth

Advertisements class

The read-only Advertisements class defines a table that holds all the Configuration Manager Adverts processed by WakeUp. The columns of the table are:

Column

Type

Description

AdvertisementName

String

The name of the advertisement processed.

WU_Queued

uint32

The number of queued.

WU_Sent

uint32

The total number of wake ups sent.

WU_NotSent

uint32

The number of wake ups that did not reach their destination.

Awake

uint32

The number of machines already awake.

WokeUp

uint32

The number of machines that were awoken.

WillPing

uint32

The number of awake machines without the 1E Agent installed.

Failed

uint32

The number of machines that failed to wake up.

>NumRuns

uint32

The number of times the advertisement was run.

LastRunTime

datetime

The last time the advertisement was run.

Example

The following JavaScript example retrieves the list of adverts and then iterates over the list converting to an HTML table containing the advertisement name. Clicking a name retrieves the advertisements details using the function GetColMembers(), not listed.

Agents class

The read-only Agents class defines a table that holds all the 1E Agents discovered by wake up. The columns of the table are:

Column

Type

Description

AgentName

String

Name of the discovered 1E Agent.

AgentNameAlt

String

Name of the discovered 1E Agent's alternative.

MaxBurst

uint32

The number of ping packets to generate in a single burst.

BurstDelay

uint32

The delay in seconds between successive ping bursts.

WU_Queued

uint32

Number of queued wake ups.

WU_Sent

uint32

Total number of wake ups sent.

WU_NotSent

uint32

Number of wake ups that did not reach their destination.

Awake

uint32

Number of machines already awake.

WokeUp

uint32

Number of machines that were awoken.

WillPing

uint32

Number of awake machines without the 1E Agent installed.

Failed

uint32

Number of machines that failed to wake up.

State

uint32

Currently known state of the 1E Agent.

AltState

uint32

Currently known state for the 1E Agent's alternative.

LastSentTime

datetime

Last time a wake up signal was sent.

InSite

uint32

Specifies whether the 1E Agent subnet is within or outside the site boundary. It will be set to one of the following values:

0 if the subnet is outside the site boundary

1 if the subnet is within the site boundary

Example

The following JavaScript example retrieves the list of Agents and then iterates over the list converting to an HTML table containing the Agent name. Clicking a name retrieves the Agent's details using the function GetColMembers(), not listed.