Sending custom commands and scripts to 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

  SeeManaging schedulers and triggers

• Include the sending of remote execution commands and scripts in workflows.

  SeeManaging workflows

To create a remote execution command

1. 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.

2. Click Add New.

   The New remote execution window appears.

3. Type a name in the Name box.

4. Select Command line.

5. Type the command in the Command box.

6. OptionalType arguments in the Arguments box.

   Note 

   You cannot sent the remote execution command settings put to devices when users are signed into those devices. Use the command smartcli settings put instead.

   See alsoInstalling certificates on SMART Board interactive displays with iQ

   See alsoEnabling or disabling automatic OTA updates on SMART Board interactive displays with iQ

7. Click Confirm.

   The remote execution command is added to the repository.

To create a remote execution script

1. 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.

2. Click Add New.

   The New remote execution window appears.

3. Type a name in the Name box.

4. Select Script.

5. Type the script in the Script box.

6. Click Confirm.

   The remote execution script is added to the repository.

To send a remote execution command or script to a device

1. Click Devices to open the Devices view.

2. OptionalFilter the devices shown in the Devices view.

   SeeFinding devices

3. Click the device’s row.

   The device’s dashboard window appears.

4. Click Repositories actions, and then click Remote Execute.

   The Remote execute window appears.

5. Select a command or script from the list and click Apply.

To send a remote execution command or script to multiple devices

1. Click Devices to open the Devices view.

2. OptionalFilter the devices shown in the Devices view.

   SeeFinding devices

3. Select the devices’ check boxes.

4. Click More actions and select Remote execute.

   The Remote execute window appears.

5. 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

1. Click Devices to open the Devices view.

2. Click Filters in the Search bar.

3. Click Actions in the saved filter’s row and select Remote execute.

   The Remote execute window appears.

4. Select a command or script from the list and click Apply.

To send a remote execution command or script to a group

1. Click Devices to open the Devices view.

2. Click Groups to open the Groups panel.

3. Click Actions in the group’s row and select Remote execute.

   The Remote execute window appears.

4. Select a command or script from the list and click Apply.

Installing certificates on SMART Board interactive displays with iQ

You 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 <Certificate> is the path to the certificate (for example, /sdcard/certs/certificate.p12 or /sdcard/Download/certificate.p12) Optional--delete_file specifies whether the certificate file should be deleted (true by default) Optional--for-all-users specifies whether the certificate should be installed for all signed-in users (false by default)
Install user certificate	install_user	<Certificate> --delete_file --alias --cert-password Where <Certificate> is the path to the certificate (for example, /sdcard/certs/certificate.p12 or /sdcard/Download/certificate.p12) Optional--delete_file specifies whether the certificate file should be deleted (true by default) Optional--alias specifies the alias for the certificate Optional--cert-password specifies the password for the certificate
Install user certificate for Wi-Fi	install_wifi	<Certificate> --delete_file --alias --cert-password Where <Certificate> is the path to the certificate (for example, /sdcard/certs/certificate.p12 or /sdcard/Download/certificate.p12) Optional--delete_file specifies whether the certificate file should be deleted (true by default) Optional--alias specifies the alias for the certificate Optional--cert-password specifies the password for the certificate

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 <Certificate> is the path to the certificate (for example, /sdcard/certs/certificate.p12 or /sdcard/Download/certificate.p12) Optional--delete_file specifies whether the certificate file should be deleted (true by default) Optional--for-all-users specifies whether the certificate should be installed for all signed-in users (false by default)
Install user certificate	install_user	<Certificate> --delete_file --alias --cert-password --board_lock_type password|pin --board_lock_value Where <Certificate> is the path to the certificate (for example, /sdcard/certs/certificate.p12 or /sdcard/Download/certificate.p12) Optional--delete_file specifies whether the certificate file should be deleted (true by default) Optional--alias specifies the alias for the certificate Optional--cert-password specifies the password for the certificate --board_lock_type specifies the display’s lock type (password or pin) --board_lock_value specifies the display’s lock alpha-numeric password or numeric PIN (between 4 and 17 characters).
Install user certificate for Wi-Fi	install_wifi	<Certificate> --delete_file --alias --cert-password --board_lock_type password|pin --board_lock_value Where <Certificate> is the path to the certificate (for example, /sdcard/certs/certificate.p12 or /sdcard/Download/certificate.p12) Optional--delete_file specifies whether the certificate file should be deleted (true by default) Optional--alias specifies the alias for the certificate Optional--cert-password specifies the password for the certificate --board_lock_type specifies the display’s lock type (password or pin) --board_lock_value specifies the display’s lock alpha-numeric password or numeric PIN (between 4 and 17 characters).

Enabling or disabling automatic OTA updates on SMART Board interactive displays with iQ

You can use remote execution commands to enable or disable OTA updates on SMART Board interactive displays with iQ.

Example 

This command enables automatic OTA updates on SMART Board interactive displays with iQ:

Example 

This command disables automatic OTA updates on SMART Board interactive displays with iQ:

Example 

This command causes SMART Board interactive displays with iQ to check for OTA updates tonight:

Other schedule options:

• none (checks for OTA updates immediately)

• tomorrow night

• this weekend

Note 

The above examples might not work with all SMART Board interactive display models.

The Mobile Device Management (MDM) protocol allows you to send commands to iOS and macOS devices enrolled in SMART Remote Management.

You can create custom MDM commands to perform a variety of actions on iOS and macOS devices:

• Inspect, install, or remove profiles

• Remove passcodes

• Begin secure erase

You can run custom MDM commands on a single device, multiple devices, all devices that match a saved filter’s criteria, or a group.

To create a custom MDM command

1. Click Repositories and select Apple custom command.

   The Apple custom command window appears.

   Tip 

   If your organization created its domain account after May 2023, the Apple custom command window includes sample custom MDM commands that you can use as starting point for creating your own custom MDM commands. These sample custom MDM commands have turquoise icons.

2. Click Add New.

3. Type a name in the Name box.

4. Type the command in the Plist text box.

5. Click Confirm.

To run a custom MDM command on a single device

1. Click Devices to open the Devices view.

2. OptionalFilter the devices shown in the Devices view.

   SeeFinding devices

3. Click the device’s row.

   The device’s dashboard window appears.

4. Click Repository actions, and then click Apple Custom Command.

   The Apple custom command window appears.

5. Select the custom MDM command from the list and click Apply.

To run a custom Apple MDM command on multiple devices

1. Click Devices to open the Devices view.

2. OptionalFilter the devices shown in the Devices view.

   SeeFinding devices

3. Select the devices’ check boxes.

4. Click More actions and select Apple custom command.

   The Apple custom command window appears.

5. Select the custom MDM command from the list and click Apply.

To run a custom Apple MDM command on all devices that match a saved filter’s criteria

1. Click Devices to open the Devices view.

2. Click Filters in the Search bar.

3. Click Actions in the saved filter’s row and select Apple custom command.

   The Apple custom command window appears.

4. Select the custom MDM command from the list and click Apply.

To run a custom MDM command on a group

1. Click Devices to open the Devices view.

2. Click Groups to open the Groups panel.

3. Click Actions in the group’s row and select Apple custom command.

   The Apple custom command window appears.

4. Select the custom MDM command from the list and click Apply.