Skip to main content

Custom Settings

The Custom Settings Payload allows administrators to configure advanced Windows policy settings using OMA-URI–based configurations. This profile enables granular control over device behavior by allowing administrators to define custom configuration service provider (CSP) settings that may not be available through predefined profiles.

This feature is particularly useful for deploying advanced Windows management policies, enforcing security baselines, or configuring settings not exposed in standard SureMDM profiles.

To configure custom settings payload on the enrolled devices, follow these steps:

  1. Navigate to SureMDM Web Console > Profiles > Windows > New Profile > Custom Settings > Configure.

  2. Enter a Profile Name.

  3. Configure the required custom settings and click Save.

Custom Settings Configuration​

The Custom Settings payoad allows administrators to add one or more OMA-URI entries. Click Add to define a new custom configuration. Each entry requires the following parameters:

SettingDescription
NameEnter a name for the custom setting. This is used for identification within the profile.
DescriptionEnter a short description.
OMA-URISpecify the full OMA-URI path corresponding to the Windows CSP setting.
Data TypeSelect the appropriate data type. The selected type must match the requirement of the CSP node. Supported Data Type:
  • String
  • String (XML File)
  • Date and Time
  • Integer
  • Floating Point
  • Boolean
  • Base64 (file)
ValueEnter the value to be applied to the specified OMA-URI.
note
  • Supported operations are Add and Replace.
  • Multiple custom settings can be added within a single profile.

Import Custom Settings​

The Custom Settings payload supports bulk import of OMA-URI configurations to simplify large-scale policy creation.

Administrators can use the Import option to upload multiple OMA-URI entries in a single action instead of adding them individually.

Import Behavior​

  • Allows bulk upload of multiple CSP configurations via XML.
  • Multiple XML files can be imported, and each import is maintained as a separate configuration entry.
  • Imported entries can be edited or deleted individually after upload.
  • Reduces manual effort and minimizes configuration errors during large deployments.
note

Supported operations: Add, Replace, Delete, Atomic, SyncBody, SyncML

Managing Custom Entries​

Within the Custom Settings configuration:

  • Use Add to create a new OMA-URI entry.
  • Use Edit to modify an existing configuration.
  • Use Delete to remove an entry from the profile before saving.

Ensure that the OMA-URI path and value are validated against Microsoft’s CSP documentation before deployment to prevent configuration failures.

The newly created profile will be listed in the Profiles section.

  1. Go back to the Home tab and select the Windows device(s) or group(s).

  2. Click Apply to launch the Apply Job/Profile To Device prompt.

  3. Select the profile under All Jobs/Profiles.

  4. Click Apply in the Apply/Profile To Device prompt.

Important Notes​

  • Custom Settings require accurate OMA-URI paths and compatible data types.
  • Incorrect configuration may result in policy failure on devices.
  • This profile is recommended for advanced configuration customization that requires familiarity with Windows Configuration Service Providers (CSP).
  • Always test custom settings on a pilot group before wide-scale deployment.