×
×
×
×

Device Properties in DEX Workflows

Device Properties are built-in details that Endpoint Central 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 available on Windows and macOS endpoints. Availability varies by property; see the Platform column in the reference table.

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.

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, supported platform, and what it measures.

GroupDisplay NameTypePlatformDescription
NetworkPrimary Adapter Connection TypeEnumWindows, macOSThe connection type of the primary network adapter of the device — e.g. Ethernet, Wi-Fi.
NetworkWi-Fi BandFloatWindows, macOSThe frequency band of the Wi-Fi adapter of the device — e.g. 2.4 GHz or 5 GHz.
NetworkWi-Fi Network Name (SSID)StringWindowsThe SSID (network name) of the Wi-Fi network the device is connected to.
NetworkWi-Fi Access Point (BSSID)StringWindowsThe BSSID (MAC address) of the wireless access point the device is connected to.
NetworkWi-Fi ChannelIntegerWindows, macOSThe Wi-Fi channel ID in use by the device.
NetworkWi-Fi Protocol StandardEnumWindows, macOSThe Wi-Fi protocol standard used by the device — e.g. 802.11n, 802.11ac, 802.11ax.
NetworkEthernet Link SpeedFloatWindows, macOSThe link speed of the Ethernet adapter of the device, in Mbps.
NetworkWi-Fi Link SpeedFloatWindows, macOSThe current link speed of the Wi-Fi adapter of the device, in Kbps.
NetworkWi-Fi ConnectedBooleanWindows, macOSWhether the device is connected to a Wi-Fi network.
NetworkEthernet ConnectedBooleanWindows, macOSWhether the device is connected via Ethernet.
NetworkWi-Fi Adapter AvailableBooleanWindows, macOSWhether a Wi-Fi adapter is installed and available on the device.
DiskOS Drives Total Size (Combined)IntegerWindows, macOSThe combined total size of all OS drives on the device, in bytes.
DiskOS Drive Free Space (Combined)IntegerWindows, macOSThe combined free space across all OS drives on the device, in bytes.
DiskNon-OS Drives Total Size (Combined)IntegerWindows, macOSThe combined total size of all non-OS drives on the device, in bytes.
DiskNon-OS Drive Free Space (Combined)IntegerWindows, macOSThe combined free space of all non-OS drives in bytes.
DiskLogical Free Disk SpaceIntegermacOSThe logical free space (free + purgeable) for OS drives in bytes.
BatteryBattery AvailableIntegerWindowsWhether a battery is present and available on the device.
BatteryBattery Design CapacityIntegerWindowsThe original design capacity of the battery on the device, in mAh.
BatteryBattery Full Charge CapacityIntegerWindowsThe maximum charge the battery can currently hold, in mAh.
BatteryBattery HealthIntegerWindows, macOSThe health of the device battery as a percentage of its original design capacity (0—100%).
BatteryBattery NameStringWindowsThe name or model of the battery in the device.
BatteryBattery ChemistryStringWindowsThe battery type — e.g. Lithium-ion (Li-ion) or Nickel-metal hydride (NiMH).
BatteryBattery ManufacturerStringWindowsThe name of the manufacturer of the battery in the device.
BatteryBattery Serial NumberStringWindowsThe serial number of the battery in the device.
BatteryBattery Power PlanStringWindowsThe currently active Windows power plan on the device.
BatterySleep Timeout (Plugged In)IntegerWindowsIdle minutes before the device sleeps when plugged in.
BatterySleep Timeout (On Battery)IntegerWindowsIdle minutes before the device sleeps on battery.
BatteryDisplay Timeout (Plugged In)IntegerWindowsIdle minutes before the display turns off when plugged in.
BatteryDisplay Timeout (On Battery)IntegerWindowsIdle minutes before the display turns off on battery.
BatteryDisk Timeout (Plugged In)IntegerWindowsIdle minutes before the disk powers off when plugged in.
BatteryDisk Timeout (On Battery)IntegerWindowsIdle minutes before the disk powers off on battery.
BatteryHibernation Timeout (Plugged In)IntegerWindowsIdle minutes before the device hibernates when plugged in.
BatteryHibernation Timeout (On Battery)IntegerWindowsIdle minutes before the device hibernates on battery.
BatteryBattery Cycle CountIntegerWindowsThe total number of charge-discharge cycles completed by the device battery.
BatteryBattery Charge LevelIntegerWindowsThe current battery charge level of the device, as a percentage (0—100).
BatteryBattery Remaining TimeIntegerWindowsThe estimated remaining battery time at the current charge level, in minutes.
BatteryBattery Backup Time (Full Charge)IntegerWindowsThe estimated battery backup time at full charge (100%), in minutes.
BatteryBattery DischargingIntegerWindowsWhether the battery is currently discharging (1 = yes, 0 = no).
BatteryBattery ChargingIntegerWindowsWhether the battery is currently charging (1 = yes, 0 = no).
BatteryBattery Critical StateIntegerWindowsWhether the battery is in a critically low state (1 = critical, 0 = normal).