Commands for device management

Last published : Oct 16, 2026
commands for device management are applied to an OU, an individual device or a list of devices.They can be applied at once or scheduled to be run once or periodically.
Related information
Execute commands directly

General options for commands

Scheduling Options
SchedulerSettings/ -now Command is executed at once
-once -at DateTime Command is executed at once at the time specified
-every {-day Day, -sun,-mon, -tue, -wed, -thu, -fri, -sat} -at Time Command is executed periodically in the time period specified
The following date and time formats are allowed
Date dd.mm.[yy]yy, mm-dd-[yy]yy
Time hh:mm[:ss]
Day Example: With 15, the 15th of the month is meant.
Example of a periodically recurring command:
The message is sent every Monday and at the 1st and 15th of every month at 9:00.
Destination options
-to [FQName] For [FQName], the following options are available
  • Fully-qualified name of an OU or device
Example: [DE/Karlsruhe/KA1]
  • MAC address of one device
Example: [00E0C5422A2E]
Specify also the [-mac] parameter!
  • Text file containing multiple MAC addresses (one MAC address per line)
Example: [devices_xy.txt]
Specify also the [-list] parameter!
-subous If you specify an OU as destination ([-to]), the subordinated OUs are included.
-mac Use this parameter if you specify a MAC address as destination ([-to]).
-list Use this parameter if you specify a device list (text file) as destination ([-to]).

Send messages

  • Run the program with the following syntax:
scmd -u Username -p Password [-d Domain] -sendmsg -msg Message -to FQName SchedulerSettings
Option Description
-user Required for logon to server
-password
-domain
-sendmsg Send message command
-title Text for the message title
-msg Message text
-to OU/device, MAC address or text file with multiple MAC addresses (see above)
-visible Specify a timeout (in seconds) after that the message will be closed.
-deviceswait Delay (in milliseconds) after execution if more than one device is affected

Restart devices

  • Run the program with the following syntax:
scmd -u Username -p Password [-d Domain] -reboot -to FQName [-informuser ] SchedulerSettings
Option Description
-reboot Restart device command
-to OU/device, MAC address or text file with multiple MAC addresses (see above)
-deviceswait Delay (in milliseconds) after execution if more than one device is affected
-cancancel Users are allowed to cancel the command.

Switch off devices

  • Run the program with the following syntax:
scmd -u Username -p Password [-d Domain] -switchoff -to FQName [-informuser ] SchedulerSettings
Option Description
-switchoff Switch off command
-to OU/device, MAC address or text file with multiple MAC addresses (see above)
-informuser Inform users by message before execution [for the specified time period]
-cancancel Users are allowed to cancel the command.

Switch on devices[1[from Scout 15 2209]]

  • Run the program with the following syntax:
scmd -u Username -p Password [-d Domain] -switchon -to FQName SchedulerSettings
Option Description
-switchon Switch on command
-to OU/device, MAC address or text file with multiple MAC addresses (see above)

Perform firmware updates

  • Run the program with the following syntax:
scmd -u Username -p Password [-d Domain] -update -to FQName [-informuser ] (-now | -once at Date Time)
Option Description
-update Update command
-to OU/device, MAC address or text file with multiple MAC addresses (see above)
-format Before installation, the system partition of the devices will be formatted.
-informuser Inform users by message before execution [for the specified time period]
-cancancel Users are allowed to cancel the command.
-now , -once at Specify the time of execution. A periodic execution is not possible.

Deliver software

Run the program with the following syntax:
scmd -u Username -p Password [-d Domain] -delivery -to FQName [-informuser ] (-now | -once at Date Time)
Option Description
-delivery Delivery command
-to OU/device, MAC address or text file with multiple MAC addresses (see above)
-clean Before delivery, the update partition of the devices will be formatted.
-informuser Inform users by message before execution [for the specified time period]
-cancancel Users are allowed to cancel the command.
-now, -once at Specify the time of execution. A periodic execution is not possible.

Perform a configuration run

Run the program with the following syntax:
scmd -u Username -p Password [-d Domain] -configrun -to FQNameSchedulerSettings
Option Description
-configrun Configuration command
-to OU/device, MAC address or text file with multiple MAC addresses (see above)

Refresh the device status

Run the program with the following syntax:
scmd -u Username -p Password [-d Domain] -refreshdevicestatus -to FQName SchedulerSettings
Option Description
-refreshdevicestatus Refresh device status command
-to OU/device, MAC address or text file with multiple MAC addresses (see above)

Reset to factory status

Run the program with the following syntax:
scmd -u Username -p Password [-d Domain] -factoryreset -to FQName [-informuser ] (-now | -once at Date Time)
Option Description
-factoryreset Remote factory reset command
-to OU/device, MAC address or text file with multiple MAC addresses (see above)
-retainlocalconfig Retain local user-defined device configuration in unlocked fields
-removescoutaddress Delete Scout Server address on the device
-removelicenses Additionally delete client-side stored license information
-informuser Inform users by message before execution [for the specified time period]
-cancancel Users are allowed to cancel the command.
-now , -once at Specify the time of execution. A periodic execution is not possible.