Extended Settings
    • Dark
      Light
    • PDF

    Extended Settings

    • Dark
      Light
    • PDF

    Article Summary

    Requires Agent version 2.13

    This feature requires Agent version 2.13 or higher.

    Use Extended Settings to customize device settings according to a list of rules. If a device meets a rule's conditions, then the settings for that rule are applied to the device. If a device does not meet any rules, or if you don't use this feature at all, then the default settings apply.

    A device is evaluated against the rules in the order that the rules appear in the rule list. The first rule that a device meets is used to apply settings for that device. This means that it is important to set the order of the rule list. Note that a device is allowed to meet only one rule.

    To access Extended Settings, go to Devices > Configuration > Extended Settings. Your account must have the permission Configure Extended Settings.
    access extended settings.png

    Devices might take up to an hour to update

    After you update rules, it might take up to one hour for the updated rules to come into effect.

    Note: Extended Settings override Custom Settings

    Before this feature was available, ControlUp Support might have helped you apply custom settings to your tenant using JSON. Because some of these settings are now controlled using the Extended Settings UI, the following Custom Settings will be ignored after you create your first Extended Settings rule:

    • LocationsByIpRange
    • DoNotUseDeviceLocation
    • RebootNotification
    • DisableUCC
    • UserIdleTimeoutSecs

    We recommend that you open your Custom Settings (Configuration > Settings > Custom Settings) to see if you are currently using any of the custom settings listed above. If any of them are used, you must recreate the setting using Extended Settings rules.

    Add a new rule

    To create a new rule:

    1. Click Add Rule.
      add rule.png

    2. A new rule appears in the rule list without any conditions or settings. Read the sections below to learn how to define a rule's conditions and settings.
      new rule empty.png

    Define a rule's conditions

    Create rule conditions with device tags using AND/OR logic. Learn how to add tags to a device.

    • To create conditions with AND statements, add multiple tags to the same line. In this case, a device must have all of the specified tags to meet the rule.

    condition with and statement.png

    • To create a condition using OR statements, click Add condition and add each tag in a separate field. In this case, a device must have one of the specified tags to meet the rule.

    condition with or statement.png

    You can create conditions with a combination of AND and OR statements by using both of the methods described above.

    Apply a rule to all devices

    If you don't specify any conditions for a rule, then the rule will be met by all devices that don't meet a rule placed higher in the list. Note that any rule placed below a rule with no conditions will never be met. In most situations, a rule with no conditions should be the last rule in the list.

    rule with no conditions.png

    Define a rule's settings

    You can configure the following settings for a rule. If you don't want to change a particular setting on a device, you can leave the setting empty or don't change its default.

    Custom device location by IP range

    Use this setting to override a device's location and place it at a custom location based on the remote IP address. Fill out the following fields to assign a custom location for devices within a specific range of IP addresses:

    • IP range - Enter the range of remote IP addresses in CIDR notation. For example, 192.0.2.0/24.
    • Location name - Enter a name for the custom location. The name you enter will appear in the Location column on the device details dashboard. Use this field to enter the names of cities, offices, sites, etc.
    • Latitude, Longitude - Enter the coordinates of the custom location.
    True IP location is no longer recorded

    If a device has it's location overridden by this setting, then the true location from the device's IP address is no longer recorded in Edge DX. The columns Public IP Country, Public IP State, and Public IP City in the Device details grid will be empty.

    Add multiple rows to set the locations for more IP address ranges.

    multiple IP range examples.png

    To set all devices to a custom location regardless of their IP addresses, set the IP range to 0.0.0.0/0. Read Completely hide device location below to learn how to hide all sources of location data.

    set all devices to location.png

    Windows Agent uninstall password

    By default, end users can uninstall the Edge DX Agent from their Windows device. If you don't want to allow your end users to freely uninstall the Agent, use this setting to create a password. The end user must enter this password to uninstall the Agent.

    Cache retention duration

    By default, the Edge DX Agent caches data on a device for up to 28 days while it isn't connected to your tenant. The Agent sends the cached data to your tenant when it reconnects. Use this setting to change the number of days that data is cached locally before it is deleted.

    The amount of data that the Agent stores in the cache varies depending on activity and usage. Typically, this averages in the range of 10-20 MB per day.

    Reboot notification text

    Use this setting to customize the text in the notification Window when you perform a Reboot action on a device from Edge DX.

    reboot action.png

    The text you enter appears in the following notification window.

    reboot request notification.png

    Disable device location

    Use this setting to disable geolocation reporting using Location Services on Windows and macOS devices. The location reported by Location Services can be very accurate. If you select this option, a device's location can be determined only by using the remote IP address. Read Completely hide device location below to learn how to hide all sources of location data.

    If you select Disable Device Location, then the Edge DX Agent on macOS devices will not prompt the device user for permission to access Location Services when the Agent is installed.

    Disable UCC Agent data on the device

    By default, UCC data is collected from the Microsoft Teams and Zoom APIs and the Edge DX Agent installed on the device. Select this option to disable data collection from the Agent installed on the device. If you select this option, UCC data will still be collected using the Microsoft Teams and Zoom APIs.

    The Agent is used to collect minute-by-minute metrics from Microsoft Teams and Zoom.

    User idle timeout

    Use this setting to change the time (in seconds) that a user has to be inactive before their activity status is Idle.

    Changing this setting affects End User Activity data collection. After a user is Idle, then they are no longer considered to be actively using an application. This setting also affects user activity data in the Employees view because it is based on End User Activity data.

    Change the rule order

    Because a device is evaluated against the rules in the order that they appear in the rule list, you might want to change the rule order. To move rules in the list, click the up and down arrows.
    up and down arrows.png

    Duplicate a rule

    To duplicate a rule, click Duplicate. The conditions and settings are copied to the new rule.

    Duplicate rule.png

    Completely hide device location

    To completely hide a device's location data, you must hide the location data from the IP address and from Location Services. Learn more about how a device's location is determined.

    1. Use Custom device location by IP range to set devices within an IP range to a location of your choosing. You can make this location data meaningless by setting the location to somewhere like the middle of the ocean. Note that you can apply the setting to all IP addresses by using the range 0.0.0.0/0.
    2. Select Disable device location to disable location data from Location Services.

    HideDeviceLocation.png


    Was this article helpful?