Sending custom commands and scripts to devices
Sending remote execution commands and scripts to SMART Board interactive displays and Android and Windows devices
|
|
|
|
|
|
You can create remote execution commands and scripts in SMART Remote Management and send them to devices for a variety of purposes, including:
Installing certificates on SMART Board interactive displays with iQ
Enabling or disabling automatic over-the-air (OTA) updates on SMART Board interactive displays with iQ
Activating software, such as SMART Notebook or SMART Meeting Pro, on computers
You can send remote execution commands and scripts to a single device, multiple devices, all devices that match a saved filter’s criteria, or a group. Alternatively, you can:
Use a trigger to send a remote execution command at a scheduled time or when a specific event takes place
Include the sending of remote execution commands and scripts in workflows.
To create a remote execution command
Click Repositories
and select Remote execute.The Remote execute window appears.
Tip
If your organization created its domain account after May 2023, the Remote execute window includes sample remote execution commands that you can use as starting point for creating your own remote execution commands. These sample remote execution commands have turquoise icons.
Click Add New.
The New remote execution window appears.
Type a name in the Name box.
Select Command line.
Type the command in the Command box.
OptionalType arguments in the Arguments box.
Note
You cannot send the remote execution command settings put to devices when users are signed into those devices. Use the command smartcli settings put instead.
Select or clear the following check boxes.
Check box
Select to
Notes
Wait for exit
Allow the system to wait for the command’s execution to finish before reporting the result.
This is critical for commands that depend on completion confirmation before subsequent actions can occur.
Collect output
Collect and return the output of the command as part of the command results.
This provides administrators with essential feedback and diagnostics, improving troubleshooting and verifying command success.
Run with high privileges
Execute the command with elevated local device permissions.
This ensures compatibility with commands requiring administrative privileges, especially for critical device or system changes.
Turn on Set as private to mark the command as private so it is only visible to the creator of the command.
Note
This enhances control over sensitive commands, promoting user privacy and security.
Click Confirm.
The remote execution command is added to the repository.
To create a remote execution script
Click Repositories
and select Remote execute.The Remote execute window appears.
Tip
If your organization created its domain account after May 2023, the Remote execute window includes sample remote execution scripts that you can use as starting point for creating your own remote execution scripts. These sample remote execution scripts have turquoise icons.
Click Add New.
The New remote execution window appears.
Type a name in the Name box.
Select Script.
Type the script in the Script box.
Select or clear the following check boxes.
Check box
Select to
Notes
Wait for exit
Allow the system to wait for the script’s execution to finish before reporting the result.
This is critical for scripts that depend on completion confirmation before subsequent actions can occur.
Collect output
Collect and return the output of the script as part of the script results.
This provides administrators with essential feedback and diagnostics, improving troubleshooting and verifying script success.
Run with high privileges
Execute the script with elevated local device permissions.
This ensures compatibility with scripts requiring administrative privileges, especially for critical device or system changes.
Turn on Set as private to mark the script as private so it is only visible to the creator of the script.
Note
This enhances control over sensitive scripts, promoting user privacy and security.
Click Confirm.
The remote execution script is added to the repository.
To send a remote execution command or script to a device
Click Devices
to open the Devices view.OptionalFilter the devices shown in the Devices view.
SeeFinding devices
Click the device’s row.
The device’s dashboard window appears.
Click Repositories actions, and then click Remote Execute.
The Remote execute window appears.
Select a command or script from the list and click Apply.
To send a remote execution command or script to multiple devices
Click Devices
to open the Devices view.OptionalFilter the devices shown in the Devices view.
SeeFinding devices
Select the devices’ check boxes.
Click More actions
and select Remote execute.The Remote execute window appears.
Select a command or script from the list and click Apply.
To send a remote execution command or script to all devices that match a saved filter’s criteria
Click Devices
to open the Devices view.Click Filters
in the Search bar.Click Actions
in the saved filter’s row and select Remote execute.The Remote execute window appears.
Select a command or script from the list and click Apply.
To send a remote execution command or script to a group
Click Devices
to open the Devices view.Click Groups to open the Groups panel.
Click Actions
in the group’s row and select Remote execute.The Remote execute window appears.
Select a command or script from the list and click Apply.
Installing certificates on SMART Board interactive displays with iQYou can use remote execution commands to install certificates on SMART Board interactive displays with iQ.
These are the commands for installing certificates on SMART Board interactive displays with iQ 4:
Task | Command | Arguments |
|---|---|---|
Install CA certificate | install_ca | <Certificate> --delete_file --for_all_users Where
|
Install user certificate | install_user | <Certificate> --delete_file --alias --cert-password Where
|
Install user certificate for Wi-Fi | install_wifi | <Certificate> --delete_file --alias --cert-password Where
|
These are the commands for installing certificates on SMART Board interactive displays with iQ 3:
Task | Command | Arguments |
|---|---|---|
Install CA certificate | install_ca | <Certificate> --delete_file --for_all_users Where
|
Install user certificate | install_user | <Certificate> --delete_file --alias --cert-password --board_lock_type password|pin --board_lock_value Where
|
Install user certificate for Wi-Fi | install_wifi | <Certificate> --delete_file --alias --cert-password --board_lock_type password|pin --board_lock_value Where
|
Updating SMART Board interactive displays with iQYou can use remote execution commands to update SMART Board interactive displays with iQ.
These are the commands for updating SMART Board interactive displays with iQ 4:
Task | Command | Arguments |
|---|---|---|
Enable automatic OTA updates | smartcli | update feature auto enable |
Disable automatic OTA updates | smartcli | update feature auto disable |
Get the status of the automatic OTA update | smartcli | update feature auto |
Set the time of day automatic OTA updates run | smartcli | update property update-daily-window <Start time> <End time> Where
Example To set automatic OTA updates to run from 1 am to 5 am: update property update-daily-window 60 300 |
Get the time of day automatic OTA updates run | smartcli | update property update-daily-window |
Set the days of the week automatic OTA updates run | smartcli | update property update-days-of-week <Days of the week> Where <Days of the week> are the days of the week on which you want automatic OTA updates to run, separated by spaces:
Example To set automatic OTA updates to run on Sundays and Mondays: update property update-days-of-week 1 2 |
Get the days of the week automatic OTA updates run | smartcli | update property update-days-of-week |
Check if a system update is available, download it, and install it | smartcli | update install system --reboot --async Where
Example To set the display to reboot after the update is complete to apply it: update install system --reboot |
These are the commands for updating SMART Board interactive displays with iQ 3:
Task | Command | Arguments |
|---|---|---|
Enable automatic OTA updates | smartcli | update auto enable |
Disable automatic OTA updates | smartcli | update auto disable |
Check for updates immediately | smartcli | update schedule none |
Check for updates at a specified time | smartcli | update schedule <Status> Where <Status> is
|
Randomizing MAC addresses for SMART Board interactive displays with iQThese are the commands for randomizing MAC addresses for SMART Board interactive displays with iQ4.
Task | Command | Arguments |
|---|---|---|
Get MAC randomization settings for a specified network | smartcli | networking wifi get mac_randomization <Network name> Where <Network name> is the name of the network for which you want to get MAC randomization settings |
Set MAC randomization settings for a specified network | smartcli | networking wifi set mac_randomization <Network name> <Randomization option> Where
|