×
×
×
×

Device Properties in DEX Workflows

About Device Properties

Device Properties are built-in details that DEX Manager Plus can collect from a managed endpoint—for example, Wi-Fi Link Speed, OS Drive Free Space, or Battery Health. You can use them in any workflow without defining them yourself. When you configure a device property in a workflow, its value is collected from the device, so you can build conditions and actions around real device data such as its network, disk, or battery state.

Note

Device Properties are currently available on Windows endpoints.

When you build workflow logic, you can reference three types of variables:

  • Device Properties: Built-in device details that are ready to use in any workflow, covering areas such as network, disk, and battery state. These are listed in Device Properties Reference.
  • Sensor fields: Device data fields collected through sensors. You can access sensor fields directly in a workflow, without first adding a Sensor stage.
  • Previous stage outputs: Values produced by earlier stages in the same workflow—for example, the user’s response from an Engage stage. Reference these to branch or act on what happened earlier in the flow.

Sensor Fields: Direct Access or a Sensor Stage

You can bring a sensor field into a workflow in two ways: reference it directly in a stage such as a Switch, or add a Sensor stage and reference its output. Both achieve the same result. Accessing the field directly is simpler, because it removes the need for a separate Sensor stage and keeps the workflow smaller.

How to Use Device Properties in Workflow Stages

Device Properties are available in a workflow out of the box, so you can use them directly in your workflow logic:

  • Switch: Compare a variable against a threshold or expected value to branch the workflow—for example, “Battery Health is less than 80%” or “Wi-Fi Connected is true”.
  • Function: Run a Deluge or JavaScript function on the server, passing device properties as its parameters—for example, to transform a value or apply custom logic before it is evaluated.
  • Engage and Send Mail: Reference a variable’s value in a message so end users or administrators see the actual reading, such as the remaining disk space.

For how these stages connect on the canvas, see Managing Workflows in DEX Manager Plus.

Example

To warn users about an aging battery, evaluate Battery Health in a Switch (for example, less than 80%), then use Send Mail to alert IT or Engage to notify the user on the matching branch.

Device Properties Reference

The following device properties are available, grouped by category. Each row lists the display name shown in the workflow editor, its data type, and what it measures.

GroupDisplay NameTypeDescription
NetworkPrimary Adapter Connection TypeEnumThe connection type of the primary network adapter of the device — e.g. Ethernet, Wi-Fi.
NetworkWi-Fi BandFloatThe frequency band of the Wi-Fi adapter of the device — e.g. 2.4 GHz or 5 GHz.
NetworkWi-Fi Network Name (SSID)StringThe SSID (network name) of the Wi-Fi network the device is connected to.
NetworkWi-Fi Access Point (BSSID)StringThe BSSID (MAC address) of the wireless access point the device is connected to.
NetworkWi-Fi ChannelIntegerThe Wi-Fi channel ID in use by the device.
NetworkWi-Fi Protocol StandardEnumThe Wi-Fi protocol standard used by the device — e.g. 802.11n, 802.11ac, 802.11ax.
NetworkEthernet Link SpeedFloatThe link speed of the Ethernet adapter of the device, in Mbps.
NetworkWi-Fi Link SpeedFloatThe current link speed of the Wi-Fi adapter of the device, in Kbps.
NetworkWi-Fi ConnectedBooleanWhether the device is connected to a Wi-Fi network.
NetworkEthernet ConnectedBooleanWhether the device is connected via Ethernet.
NetworkWi-Fi Adapter AvailableBooleanWhether a Wi-Fi adapter is installed and available on the device.
DiskOS Drives Total Size (Combined)IntegerThe combined total size of all OS drives on the device, in bytes.
DiskOS Drive Free Space (Combined)IntegerThe combined free space across all OS drives on the device, in bytes.
DiskNon-OS Drives Total Size (Combined)IntegerThe combined total size of all non-OS drives on the device, in bytes.
DiskNon-OS Drive Free Space (Combined)IntegerThe combined free space of all non-OS drives in bytes.
DiskLogical Free Disk SpaceIntegerThe logical free space (free + purgeable) for OS drives in bytes.
BatteryBattery AvailableIntegerWhether a battery is present and available on the device.
BatteryBattery Design CapacityIntegerThe original design capacity of the battery on the device, in mAh.
BatteryBattery Full Charge CapacityIntegerThe maximum charge the battery can currently hold, in mAh.
BatteryBattery HealthIntegerThe health of the device battery as a percentage of its original design capacity (0–100%).
BatteryBattery NameStringThe name or model of the battery in the device.
BatteryBattery ChemistryStringThe battery type — e.g. Lithium-ion (Li-ion) or Nickel-metal hydride (NiMH).
BatteryBattery ManufacturerStringThe name of the manufacturer of the battery in the device.
BatteryBattery Serial NumberStringThe serial number of the battery in the device.
BatteryBattery Power PlanStringThe currently active Windows power plan on the device.
BatterySleep Timeout (Plugged In)IntegerIdle minutes before the device sleeps when plugged in.
BatterySleep Timeout (On Battery)IntegerIdle minutes before the device sleeps on battery.
BatteryDisplay Timeout (Plugged In)IntegerIdle minutes before the display turns off when plugged in.
BatteryDisplay Timeout (On Battery)IntegerIdle minutes before the display turns off on battery.
BatteryDisk Timeout (Plugged In)IntegerIdle minutes before the disk powers off when plugged in.
BatteryDisk Timeout (On Battery)IntegerIdle minutes before the disk powers off on battery.
BatteryHibernation Timeout (Plugged In)IntegerIdle minutes before the device hibernates when plugged in.
BatteryHibernation Timeout (On Battery)IntegerIdle minutes before the device hibernates on battery.
BatteryBattery Cycle CountIntegerThe total number of charge-discharge cycles completed by the device battery.
BatteryBattery Charge LevelIntegerThe current battery charge level of the device, as a percentage (0–100).
BatteryBattery Remaining TimeIntegerThe estimated remaining battery time at the current charge level, in minutes.
BatteryBattery Backup Time (Full Charge)IntegerThe estimated battery backup time at full charge (100%), in minutes.
BatteryBattery DischargingIntegerWhether the battery is currently discharging (1 = yes, 0 = no).
BatteryBattery ChargingIntegerWhether the battery is currently charging (1 = yes, 0 = no).
BatteryBattery Critical StateIntegerWhether the battery is in a critically low state (1 = critical, 0 = normal).