Web Service Endpoint

Set Settings

Configure settings on the device.

URL

PUT https://yourmdmhost.example.com/mdm

HTTP Body

Response Codes

OK

Discussion

The settings take effect at the time of the command. Users may still be able to change the settings later, if changing the settings is not restricted by a profile.

Command Availability

Device Channel

iOS, macOS, Shared iPad, tvOS

User Channel

macOS

Requires Supervision

-

Allowed in User Enrollment

iOS, macOS

Required Access Right

AllowSettings

Example Request and Response (DeviceName)

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict> <key>Command</key> <dict> <key>RequestType</key> <string>Settings</string> <key>Settings</key> <array> <dict> <key>DeviceName</key> <string>NewName</string> <key>Item</key> <string>DeviceName</string> </dict> </array> </dict> <key>CommandUUID</key> <string>0001_Settings</string></dict></plist>
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict> <key>CommandUUID</key> <string>0001_Settings</string> <key>Settings</key> <array> <dict> <key>Item</key> <string>DeviceName</string> <key>Status</key> <string>Acknowledged</string> </dict> </array> <key>Status</key> <string>Acknowledged</string> <key>UDID</key> <string>00008020-000915083C80012E</string></dict></plist>

See Also

Managed Settings

Disable Remote Desktop

Disable Remote Desktop on the computer.

Enable Remote Desktop

Enable Remote Desktop on the computer.