Scalefusion Commands

Prev Next

Introduction

Scalefusion Commands offer a quick and efficient way to execute Predefined Remote Actions, requiring minimal input from IT Admins. While many of these are typically available to Business and Enterprise plan users, Scalefusion Commands are accessible across all license plans, ensuring ease of use for all customers.

Creating Scalefusion Commands

  1. Navigate to Remote Support > Remote Commands > click the Create button.

  2. In the Android tab, click Scalefusion Commands.

  3. This will open the command creation wizard.

  4. Select the Action you want to run on the device(s), configure the Extras, and Save it.

    1. Provide a unique name for easy identification.

    2. Select the Action type from the dropdown list.

    3. Configure the Extras by clicking the Add button.

Next, let’s have a look at the different Actions available.

Select Actions

1. Apply Policies

You can configure actions categorized under com.mdm.action.APPLY_POLICIES. For example,

1.1 Full Screen Mode

To show the device in full-screen view, configure the following:

  1. Select Action: Apply Policies

  2. Configure Extras:

    1. Type: Boolean

    2. Key: use_full_screen_api_fallback

    3. Value: true

  3. Click Save.

Note:

This command will work on:

  1. Scalefusion Wingman supported devices.

  2. Samsung KNOX supported devices.

  3. ELO SDK-supported devices.

  4. Zebra devices using MX config.

1.2 Disable Scalefusion Browser

Disable Scalefusion Browser and set another browser like Chrome, Firefox, Edge, etc. as the Default Browser on the device.

Note:

Make sure to enable the required browser in the Device Profile before creating this command.

  1. Select Action: Apply Policies

  2. Configure Extras:

    1. Type: Boolean

    2. Key: disable_scalefusion_browser

    3. Value: true

  3. Click Save.

1.3 Apply Passcode Policy on OS 12+ devices using Legacy API

Using the Passcode Policy feature, you can set a password complexity to either Pin or Alphanumeric. However, if you would like to enforce that users set only a PIN or only an Alphanumeric password on the device, the following remote command can be used to enforce that.

  1. Select Action: Apply Policies

  2. Configure Extras:

    1. Type: Boolean

    2. Key: use_legacy_api_for_passcode

    3. Value: true

  3. Click Save.

  4. If the use_legacy_api_for_passcode value is true, then the client will apply the Passcode Policy using the Legacy API.

  5. To turn this off, change the value to false and rerun the remote command.

1.4 Prevent users from changing GPS settings

Prevent users from changing GPS settings if the Settings app is accessible. It is a two-step process.

Pre-requisites

  • The device must be running Android 9 (Pie) or above.

  • Devices must be set as a device owner or profile owner.

  1. Select Action: Apply Policies

  2. Configure Extras:

    1. Type: Boolean

    2. Key: no_config_location

    3. Value: true

  3. Click Save.

  4. To disallow location access, use true, else use false.

Next, navigate to Device Profiles > Run Commands, enable the command update the Profile.

1.5 Hide Task Bar

You can hide the taskbar on your Android devices with this command. It is a two-step process.

This Remote Command is supported on:

  • Lenovo Devices having Android OS version 13 or above.

  • Devices should be Company Owned Devices.

  1. Select Action: Apply Policies

  2. Configure Extras:

    1. Type: Boolean

    2. Key: hide_task_bar

    3. Value: true

  3. Click Save.

  4. To hide the taskbar, use true, else use false.

Next, navigate to Device Profiles > Run Commands, enable the command update the Profile.

1.6 Set Device’s Firmware Build Version

You can configure which value (Build ID or Build Display) is displayed in device information on the Scalefusion dashboard.

Note:

By default Scalefusion uses Build.ID. However, you can set the value to Build.ID or Build.DISPLAY

  1. Select Action: Apply Policies

  2. Configure Extras:

    1. Type: String

    2. Key: target_firmware_value

    3. Value: Build.DISPLAY

  3. Click Save.

1.7 Disable copy/paste in the Scalefusion browser

You can disable the copy/paste function in the Scalefusion browser with this command.

Note:

Ensure that the device is running the latest Scalefusion agent version 19.0.1 & above for the command to execute successfully.

  1. Select Action: Apply Policies

  2. Configure Extras:

    1. Type: String

    2. Key: disable_sf_browser_copy_paste

    3. Value: true

  3. Click Save.

  4. To disable, use true, else use false.

1.8 Delayed Power Off on USB Disconnect

You can configure a delay for powering off the device after the USB is disconnected with this command.

Note:

Ensure that the device is running the latest Scalefusion agent version 19.0.1 & above for the command to execute successfully.

  1. Select Action: Apply Policies

  2. Configure Extras:

    1. Type: Integer

    2. Key: power_off_delay

    3. Value: enter a value in seconds for the delay (30, 60,90, etc.)

  3. Click Save.

Note:

  1. For this command to work, please ensure that Power Off on USB Disconnect option is also enabled in the profile.

  2. If you want to remove the delay run the command again by removing the extras.

  3. Supported for Samsung, Lenovo, Zebra and Wingman-supported devices.

1.9 Hide the Split Screen menu (OneVision gesture) on Lenovo devices

You can hide Split Screen gestures from Lenovo devices with this command.

  1. Select Action: Apply Policies

  2. Configure Extras:

    1. Type: Boolean

    2. Key: enable_lenovo_gestures

    3. Value:

      1. false: To disable the gesture or horizontal 3 dots in the status bar

      2. true: To enable the gesture or horizontal 3 dots

  3. Click Save.

Next, navigate to Device Profiles > Run Commands, enable the command update the Profile.

Note:

  1. Please ensure that the Android Beam toggle is turned off in the device profile for this remote command to work.

  2. In case the gestures are still accessible after applying the command, reboot the device once.

  3. Ensure that the device is running the latest Scalefusion agent version.

  4. Lenovo device should be wingman enabled.

1.10 Grant Permissions for third-party apps

This command allows IT administrators to remotely grant permissions for third-party apps. It enables admins to manage both runtime and other required app permissions for installed applications without requiring user interaction.

  1. Select Action: Apply Policies

  2. Configure Extras:

    1. Type: String Array

    2. Key: grant_app_permissions

    3. Value: app package name(s) separated by a comma (eg, com.whatsapp)

  3. Click Save.

1.11 Enterprise Wi-Fi Fallback on Zebra Device

With this command, you can set a Wi-Fi fallback on Zebra Devices.

Prerequisites:

  • The device must be a Zebra device running Android 13 or above.

  • The Scalefusion Agent version must be 20.1.6 or later.

  1. Select Action: Apply Policies

  2. Configure Extras:

    1. Type: Boolean

    2. Key: use_enterprise_wifi_fallback

    3. Value:

      1. True - Enables the use of the Zebra API on Android 13 or above as an enterprise Wi-Fi fallback.

      2. False - Disables the use of the Zebra API as a fallback.

  3. Click Save.

Next, navigate to Device Profiles > Run Commands, enable the command update the Profile.

2. Enable Applications

Use this command to enable or disable system apps on the device(s).

  1. Select Action: Apply Policies

  2. Configure Extras:

    1. Type: String Array

    2. Key: enable_app_list

    3. Value: app package name(s) that have to be enabled in comma-separated values (eg, com.sec.android.gallery3d)

  3. Click Save.

3. Uninstall Applications

Use this command to uninstall apps remotely from the device(s). This helps to uninstall the unwanted app(s) that are installed on the device.

  1. Select Action: Apply Policies

  2. Configure Extras:

    1. Type: String Array

    2. Key: uninstall_app_list

    3. Value: app package name(s) in comma-separated values (eg, com.whatsapp)

  3. Click Save.

Note:

  • This Remote Command is supported on EMM Managed, Wingman enabled, Knox or CSDK devices.

  • System packages and packages starting with com.promobitech cannot be uninstalled with this command.

4. Apply APN Configuration

Use this command to send an APN configuration to device(s). Please note that to use this command, you will also need a Custom build of the Scalefusion app. Please get in touch with Scalefusion Support for more details.

  1. Provide it with a name for easy identification.

  2. Select Action: Choose Apply APN Configuration from the dropdown list.

  3. Configure Extras: Enter the extras as shown below.

Type

Key

Value

Boolen

add

true/false

String

apn_name

APN name

String

apn

APN

String

mmc

mmc

String

mnc

mnc

String

protocol

ipv4/ipv6/both (in small case text)

String

roaming_protocol

ipv4/ipv6/both (in small case text)

String

mmsc

Mmsc URL

String

apn_type

Apn type in small case separated by commas with no extra spaces in between.

String

user

user

String

password

password

String

server

server

String

proxy

proxy

Integer

port

port

String

auth_type

auth type in small case

String

mms_proxy

MMS proxy

String

mvno_type

Mvno type in small case text

String

mvno_matchdata

Mvno value

Integer

apn_id

a random 5-digit unique number

Note:

Your The extra “add” determines whether to add or remove the config applied by Remote Command.

  1. If “true”, Scalefusion will add the APN as configured in Remote Command.

  2. If “false”, Scalefusion will remove the APN that was configured from Remote Command.

5. Apply Secure Settings

Use this command to configure settings on Wingman-supported devices. This Remote Command applies to device settings in Secure, Global, and System categories. These settings are:

  • settings list secure

  • settings list system

  • settings list global

Identifying Values

The values to be applied can be obtained using the ADB commands below. To determine the correct value, compare the settings between the desired (expected) and undesired (not expected) states. The difference will help identify the correct value to configure via Remote Command.

  • adb shell settings list secure

  • adb shell settings list global

  • adb shell settings list system

Settings Mapping

  • Secure Setting = 1

  • Global Setting = 2

  • System Setting = 3

Note:

Value type in Configure Extras can be either Integer or String, depending on the setting.

For example, System Setting

  • Command: adb shell settings list system

  • Output:

    • power_button_show=0   // Off

    • power_button_show=1   // On

  • Here:

    • secure_settings_type = 3

    • Since the values (0 and 1) are integers, the type in Configure Extras should be Integer.

6. Apply EMM Policy

Use this command to configure the EMM policy application. All the settings that come under UserManager can be configured using this command. For example,

  • DISALLOW_ADD_USER: Specifies if a user is disallowed from adding new users.

    • Type: Boolean

    • Key: no_add_user

    • Value: false/true

Note:

To find the Type, Key and Contant Value for an EMM policy please refer to the official Android Developer guide.

7. Apply Private DNS

Use this command to configure and add Private DNS on the device(s), which allows users to configure a custom DNS (Domain Name System) server that supports DNS over TLS (DoT). This feature enhances privacy and security by encrypting DNS queries.

Note:

This Remote Command is supported on the following:

  • Android OS version 10 and above.

  • Company Owned Devices that are EMM managed.

  1. Select Action: Apply Policies

  2. Configure Extras:

    Type

    Key

    Value

    Boolean  

    enforce_dns

    true/false

    String

    dns_host_name

    DNS host name value (For eg, family.cloudflare-dns.com)

  3. Click Save.

Execute a Scalefusion command

Once a command is created, the next step is to run it from the dashboard to be executed on the device. Please refer to our guide for more information.

Policy-based Scalefusion command

IT admins can configure additional triggers to execute them whenever that event occurs (run at install, schedule at a specific time, etc.) and even when the devices are offline. Please refer to our guide for more information.

Note:

You will not be able to create a shortcut of the Scalefusion command.