Contents

DNSSettings

The payload that configures encrypted DNS settings.

Declaration

object DNSSettings

Properties

NameTypeDescription
DNSSettings RequiredDNSSettings.DNSSettings

A dictionary that defines a configuration for an encrypted DNS server.

Deprecated: iOS 27+ | iPadOS 27+ | macOS 27+ | visionOS 27+

OnDemandRules[DNSSettings.OnDemandRulesElement]

An array of rules that define the DNS settings. If not set, the system always applies the DNS settings. These rules are identical to the OnDemandRules array in VPN payloads.

Deprecated: iOS 27+ | iPadOS 27+ | macOS 27+ | visionOS 27+

ProhibitDisablementboolean

If true, the system prohibits users from disabling DNS settings. This key is only available on supervised devices.

Deprecated: iOS 27+ | iPadOS 27+ | macOS 27+ | visionOS 27+

Discussion

Specify com.apple.dnsSettings.managed as the payload type.

When installed from an MDM, the setting only applies to managed Wi-Fi networks.

When installed manually, this setting also applies to cellular networks.

Profile availability

Device channel

iOS, macOS, Shared iPad, visionOS

User channel

N/A

Allow manual install

iOS, macOS, visionOS

Requires supervision

N/A

Requires user-approved MDM

N/A

Allowed in user enrollment

N/A

Allow multiple payloads

iOS, macOS, Shared iPad, visionOS

Topics

Objects

See Also

Networking