Commands for device management
Scout 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.
General options for Scout 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
|
|
Time | hh:mm[:ss | |
Day | Example: With 15, the 15th of the month is meant. |
Example of a periodically recurring command:
scmd -sendmsg -msg “Hello“ -to /TestOU -every -mon -day 1 15 -at 9:00
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:
|
-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[ser] Username -p[assword] Password [-d[omain] Domain] -sendmsg -msg Message [-title Title] -to FQName [-subous] [-mac] [-list] [-visible Seconds] [-deviceswait Milliseconds]SchedulerSettings
Option Description -user
-password
-domainrequired for logon to server -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[ser] Username -p[assword] Password [-d[omain] Domain] -reboot -to FQName [-subous] [-mac] [-list] [-informuser [-informtime Seconds]] [-cancancel] [-deviceswait Milliseconds] 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[ser] Username -p[assword] Password [-d[omain] Domain] -switchoff -to FQName [-subous] [-mac] [-list] [-informuser [-informtime Seconds]] [-cancancel] [-deviceswait Milliseconds]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 devices1
-
Run the program with the following syntax:
scmd -u[ser] Username -p[assword] Password [-d[omain] Domain] -switchon -to FQName [-mac] [-list] 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[ser] Username -p[assword] Password [-d[omain] Domain] -update -to FQName [-subous] [-mac] [-list] [-format] [-informuser [-informtime Seconds]] [-cancancel] [-deviceswait Milliseconds] (-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[ser] Username -p[assword] Password [-d[omain] Domain] -delivery -to FQName [-subous] [-mac] [-list] [-clean] [-informuser [-informtime Seconds]] [-cancancel] [-deviceswait Milliseconds] (-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[ser] Username -p[assword] Password [-d[omain] Domain] -configrun -to FQNameSchedulerSettings
Option Beschreibung -configrun Configuration command -to OU/device, MAC address or text file with multiple MAC addresses (see above)
Refresh the device status2
-
Run the program with the following syntax:
scmd -u[ser] Username -p[assword] Password [-d[omain] Domain] -refreshdevicestatus -to FQName [-subous] SchedulerSettings
Option Beschreibung -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[ser] Username -p[assword] Password [-d[omain] Domain] -factoryreset -to FQName [-subous] [-mac] [-list] [-retainlocalconfig] [-removescoutaddress] [-removelicenses] [-informuser [-informtime Seconds]] [-cancancel] [-deviceswait Milliseconds] (-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.