---
title: DNSSettings.OnDemandRulesElement
framework: devicemanagement
role: symbol
role_heading: Device Management Profile
path: devicemanagement/dnssettings/ondemandruleselement
---

# DNSSettings.OnDemandRulesElement

A list of domain strings that determine which DNS queries use the DNS server.

## Declaration

```data
object DNSSettings.OnDemandRulesElement
```

## Properties

Action: The action to take if this dictionary matches the current network. Allowed values: Connect: Apply DNS Settings when the dictionary matches. Disconnect: Don’t apply DNS Settings when the dictionary matches. EvaluateConnection: Apply DNS Settings with per-domain exceptions when the dictionary matches. ActionParameters: An array of dictionaries that provide per-connection rules. The system uses this array only for settings where the Action value is EvaluateConnection. DNSDomainMatch: An array of domain names. This rule matches if any of the domain names in the specified list matches any domain in the device’s search domains list. The system supports a single wildcard (*) prefix, but it’s not required. For example, both *.example.com and example.com match against mydomain.example.com and your.domain.example.com, but don’t match against mydomain-example.com. DNSServerAddressMatch: An array of IP addresses. This rule matches if any of the network’s specified DNS servers match any entry in the array. The system supports matching with a single wildcard. For example, 17.* matches any DNS server in the 17.0.0.0/8 subnet. InterfaceTypeMatch: An interface type. If specified, this rule matches only if the primary network interface hardware matches the specified type. SSIDMatch: An array of SSIDs to match against the current network. If the network isn’t a Wi-Fi network or if the SSID doesn’t appear in this array, the match fails. Omit this key and the corresponding array to match against any SSID. URLStringProbe: A URL to probe. This rule matches if this URL is successfully fetched and returns a 200 HTTP status code without redirection.

## Topics

### Objects

- [DNSSettings.OnDemandRulesElement.ActionParameter](devicemanagement/dnssettings/ondemandruleselement/actionparameter.md)

## See Also

### Objects

- [DNSSettings.DNSSettings](devicemanagement/dnssettings/dnssettings-data.dictionary.md)